Location: replace() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

Die replace()-Methode des Location-Interfaces ersetzt die aktuelle Ressource durch diejenige an der angegebenen URL. Der Unterschied zur assign()-Methode besteht darin, dass nach Verwendung von replace() die aktuelle Seite nicht im Session History gespeichert wird, was bedeutet, dass der Benutzer den Zurück-Button nicht verwenden kann, um zu ihr zu navigieren. Nicht zu verwechseln mit der String-Methode String.prototype.replace().

Syntax

replace(url)

Parameter

url: Ein String oder ein anderes Objekt mit einem stringifier, wie ein URL-Objekt, das die URL der Seite enthält, zu der navigiert werden soll.

Ausnahmen

SecurityError DOMException: Browser drosseln Navigationsvorgänge und können diesen Fehler auslösen, eine Warnung generieren oder den Aufruf ignorieren, wenn er zu häufig durchgeführt wird.
SyntaxError DOMException: Ausgelöst, wenn der angegebene url-Parameter keine gültige URL ist.

Rückgabewert

Keiner (undefined).

Beispiele

// Navigate to the Location.reload article by replacing this page
window.location.replace(
  "https://big.rakal.top/en-US/docs/Web/API/Location.reload",
);

Spezifikationen

Specification
HTML # dom-location-replace-dev

Browser-Kompatibilität

Siehe auch

Das Location-Interface, zu dem es gehört.
Ähnliche Methoden: Location.assign() und Location.reload().

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden