Die schreibgeschütztekey-Eigenschaft derNavigationHistoryEntry-Schnittstelle gibt denkey des Verlaufseintrags zurück oder einen leeren String, wenn das aktuelle Dokument nicht vollständig aktiv ist. Dies ist ein einzigartiger, vom Benutzeragenten (UA) generierter Wert, der den Slot des Verlaufseintrags in der Liste der Einträge darstellt. Er wird verwendet, um zu diesem bestimmten Slot überNavigation.traverseTo() zu navigieren. Derkey wird von anderen Einträgen, die den Eintrag in der Liste ersetzen (das heißt, wenn derNavigateEvent.navigationTypereplace ist), wiederverwendet.

Dies unterscheidet sich von derid eines Verlaufseintrags. Dieid ist ein einzigartiger, vom UA generierter Wert, der immer einen bestimmten Verlaufseintrag darstellt, anstatt seinen Slot in der Liste der Einträge. Dies ist nützlich, um ihn mit einer externen Ressource wie einem Speicher-Cache zu korrelieren.

Wert

Ein String, der denkey derNavigationHistoryEntry darstellt.

Beispiele

Grundlegende Verwendung

const current = navigation.currentEntry;console.log(current.key);

Ein Home-Button einrichten

function initHomeBtn() {  // Get the key of the first loaded entry  // so the user can always go back to this view.  const { key } = navigation.currentEntry;  backToHomeButton.onclick = () => {    navigation.traverseTo(key);  };}// Intercept navigate events, such as link clicks, and// replace them with single-page navigationsnavigation.addEventListener("navigate", (event) => {  event.intercept({    async handler() {      // Navigate to a different view,      // but the "home" button will always work.    },  });});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Modernes clientseitiges Routing: die Navigation API
• Navigation API Erklärung