ContextQMD
Back to Content

NavigationHistoryEntry: dispose event

files/en-us/web/api/navigationhistoryentry/dispose_event/index.md

latest1.3 KB
Original Source

{{APIRef("Navigation API")}}

The dispose event of the {{domxref("NavigationHistoryEntry")}} interface is fired when the entry is no longer part of the history entry list.

Disposal occurs when:

  • Forward history entries are cleared. See the example at Notifications on entry disposal for more information.
  • The user clears their browser history using settings or provided UI controls.
  • The history limit is exceeded. This is not specified anywhere, but browsers tend to have a history limit of 50 pages.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

js-nolint
addEventListener("dispose", (event) => { })

ondispose = (event) => { }

Event type

A generic {{domxref("Event")}}.

Examples

js
navigation.addEventListener("currententrychange", () => {
  navigation.currentEntry.addEventListener("dispose", disposeHandler);
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also