NavigationHistoryEntry: свойство key

Ограниченная доступность

Эта функция не является базовой, так как она не работает в некоторых из самых широко используемых браузеров.

Экспериментально: Это экспериментальная технология
Перед использованием в производстве внимательно изучите таблицу совместимости браузеров.

Свойство key только для чтения интерфейса NavigationHistoryEntry возвращает key записи истории, или пустую строку, если текущий документ не полностью активен. Это уникальное значение, сгенерированное UA, которое представляет собой место записи в списке записей. Оно используется для перехода к этому конкретному месту с помощью Navigation.traverseTo(). Свойство key будет повторно использовано другими записями, которые заменяют запись в списке (то есть, если NavigateEvent.navigationType имеет значение replace).

Это отличается от id записи истории. id — уникальное значение, сгенерированное UA, которое всегда представляет собой определённую запись истории, а не её позицию в списке записей. Это полезно для сопоставления с внешним ресурсом, например, кэшем хранения.

Значение

Строка, представляющая key NavigationHistoryEntry.

Примеры

Базовое использование

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

Настройка кнопки «Домой»

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 navigations
navigation.addEventListener("navigate", (event) => {
  event.intercept({
    async handler() {
      // Navigate to a different view,
      // but the "home" button will always work.
    },
  });
});

Спецификации

Спецификация
HTML # dom-navigationhistoryentry-key-dev

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`key`	102	102	Нет	88	Нет	102	Нет	70	Нет	19.0	102

См. также

Современное клиентское маршрутизирование: API навигации
Описание API навигации
Демонстрация API навигации Domenic Denicola

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/NavigationHistoryEntry/key