history

Wrappers around the History API for pushing and replacing entries, navigating back/forward, and listening for popstate.

Import: @rtorcato/browser-common/history

📖 MDN: History API · 📊 caniuse: history

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
History.pushState	✅ 5+	✅ 12+	✅ 4+ [1]	✅ 5+	✅ 4+	Widely available
History.replaceState	✅ 5+	✅ 12+	✅ 4+ [1]	✅ 5+	✅ 4+	Widely available

1. Firefox: Until Firefox 5, the passed object is serialized using JSON. Starting in Firefox 6, the object is serialized using the structured clone algorithm. This allows a wider variety of objects to be safely passed.

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: History.pushState · History.replaceState

Example

import { pushState, onPopState, goBack } from '@rtorcato/browser-common/history'

pushState('/page/2', { page: 2 })

const off = onPopState((event) => {
  console.log('navigated to', event.state)
})

goBack()
off()

Exports

• pushState(url, state?, title?) — pushes a new history entry
• replaceState(url, state?, title?) — replaces the current history entry
• goBack() — navigates back one entry
• goForward() — navigates forward one entry
• go(delta) — navigates to a relative position in the history stack
• onPopState(callback) — listens for popstate; returns an unsubscribe function

See the API reference for full signatures.