JavaScript/History/replaceState

Die Methode history.replaceState() ändert den aktuellen Eintrag der Chronik des Besuchers und zusätzlich die aktuelle URL des angesprochenen Fensters ohne die Seite bzw. die neue URL zu laden.

Syntax

var newState = history.replaceState(state, titel, URL);

Diese Funktion erwartet drei Parameter:

1. state = Ein Objekt, welches später durch history.state aufgerufen werden kann.
2. Titel = Noch nicht in Verwendung.
3. URL = Neue Seiten-URL, welche die URL des Eintrags in der Chronik überschreibt.

Anwendungsbeispiel

Beispiel

 var stateObj = {info: "überschriebener Chronik Eintrag"};
 history.replaceState(stateObj, "ueberschriebenerChronikEintrag", "ueberschriebenerChronikEintrag.html");

Beachten Sie: JavaScript erlaubt als URL nur relative Links. Sie können die Chronik des Benutzers somit nur im Bereich ihrer eigenen Domain verändern.

Beachten Sie: Ändern Sie die URL nur in eine andere, die auch tatsächlich existiert, da sonst bei wiederholtem Laden beispielsweise durch die Methode location.reload(), keine Seite geladen werden kann.

Weblinks

• W3C: history API
• MDN: The_replaceState()_method