CKTIS / JavaScript
history.pushState() — ein Verlaufseintrag ohne Neuladen
history.pushState() fügt der Sitzungschronik normalerweise einen Eintrag hinzu, speichert einen Zustand und ändert optional die URL, ohne ein neues Dokument zu laden. Die Benutzeroberfläche muss separat aktualisiert werden.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
history.pushState(state, unused[, url]);history.pushState() ist eine in HTML definierte Browser-API, keine ECMAScript-Funktion; aktuelle Browser-Engines unterstützen sie. Die Verfügbarkeit von Node 24 belegt nicht, dass sie dort verfügbar ist. Die Methode fügt der Sitzungschronik normalerweise einen Eintrag hinzu. Bei einem initialen about:blank-Dokument ersetzt sie jedoch den aktuellen Eintrag, statt einen neuen hinzuzufügen. In beiden Fällen lädt sie kein neues Dokument und gibt undefined zurück. history.replaceState() hingegen aktualisiert den aktuellen Eintrag, ohne einen neuen hinzuzufügen.
state wird serialisiert und nicht als Referenz beibehalten; du kannst den Wert über history.state auslesen. Funktionen lassen sich auf diese Weise nicht speichern und führen zu DataCloneError. Der erforderliche Parameter unused erhält üblicherweise den Wert ''; er legt nicht den Seitentitel fest.
Die optionale url darf relativ sein; wenn du sie weglässt, bleibt die Adresse unverändert. Auf HTTP(S)-Seiten muss sie denselben Ursprung beibehalten: Schema, Host und Port. Eine unzulässige URL, ein nicht vollständig aktives Dokument oder zu häufige Aufrufe können SecurityError auslösen.
Der Aufruf löst weder popstate noch hashchange aus, selbst wenn sich das Fragment ändert. Aktualisiere die Benutzeroberfläche selbst; für die Navigation mit Zurück/Vorwärts verarbeitest du popstate und event.state. Das Beispiel zeigt, dass eine spätere Änderung am Eingabeobjekt den gespeicherten Zustand nicht verändert.
Beispiele
(() => {
const state = { page: 2 };
const url = new URL(location.href);
url.hash = 'cktis-page-2';
const result = history.pushState(state, '', url.href);
state.page = 99;
console.log(JSON.stringify({
page: history.state.page,
hash: location.hash,
returnsUndefined: result === undefined
}));
})();Ergebnis
{"page":2,"hash":"#cktis-page-2","returnsUndefined":true}Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.