Navigation: reload() Methode

Baseline 2026

Neu verfügbar

Seit January 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Die reload() Methode der Navigation Schnittstelle lädt die aktuelle URL neu und aktualisiert dabei alle im Verlaufseinträge enthaltenen Zustände.

Beachten Sie, dass reload() nicht das popstate Ereignis auslöst, da dieses nur bei "weichen" Navigationen ausgelöst wird, die ein „Durchlaufen“ der Verlaufseinträge verursachen.

In diesem Artikel

Syntax

js
reload()
reload(options)

Parameter

options Optional

Ein Optionsobjekt, das die folgenden Eigenschaften enthält:

state Optional

Entwicklerdefinierte Informationen, die im zugehörigen NavigationHistoryEntry gespeichert werden, sobald die Navigation abgeschlossen ist und die über getState() abgerufen werden können. Dies kann jeder Datentyp sein. Sie möchten beispielsweise möglicherweise die Anzahl der Seitenbesuche zu Analysezwecken speichern oder UI-Statusdetails speichern, damit die Ansicht genau so angezeigt werden kann, wie der Benutzer sie zuletzt verlassen hat. Alle in state gespeicherten Daten müssen struktur-klonbar sein.

info Optional

Entwicklerdefinierte Informationen, die an das navigate Ereignis übergeben und in NavigateEvent.info verfügbar gemacht werden. Dies kann jeder Datentyp sein. Sie möchten beispielsweise den neu navigierten Inhalt mit einer anderen Animation anzeigen, je nachdem, wie er navigiert wurde (nach links wischen, nach rechts wischen oder nach Hause gehen). Eine Zeichenfolge, die angibt, welche Animation verwendet werden soll, kann als info übergeben werden.

Rückgabewert

Ein Objekt mit den folgenden Eigenschaften:

committed

Ein Promise, das erfüllt wird, wenn die sichtbare URL geändert wurde und ein neuer NavigationHistoryEntry erstellt wurde.

finished

Ein Promise, das erfüllt wird, wenn alle von dem intercept() Handler zurückgegebenen Versprechen erfüllt sind. Dies entspricht der Erfüllung des NavigationTransition.finished Versprechens, wenn das navigatesuccess Ereignis ausgelöst wird.

Eines dieser Versprechen wird abgelehnt, wenn die Navigation aus irgendeinem Grund fehlgeschlagen ist.

js
async function handleReload() {
  await navigation.reload({
    info: { animation: "fade-in" },
    state: { infoPaneOpen: true },
  }).finished;

  // Update application state
  // …
}

Seite neu laden und ein neues Statusobjekt hinzufügen:

js
async function handleReload() {
  await navigation.reload({
    state: { ...navigation.currentEntry.getState(), newState: 3 },
  }).finished;

  // Update application state
  // …
}

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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

Navigation: reload() Methode

In diesem Artikel

Syntax

Parameter

Rückgabewert

Ausnahmen

Beispiele

Verwendung von info und state

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN