NavigationActivation: navigationType property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The navigationType read-only property of the NavigationActivation interface contains a string indicating the type of navigation.

Value

A string representing the type of navigation the NavigationActivation relates to. Possible values are:

  • push: A new location was navigated to, causing a new entry to be pushed onto the history list.
  • reload: The NavigationActivation.entry was reloaded.
  • replace: The NavigationActivation.entry was replaced with a new history entry. This new entry will reuse the same key, but be assigned a different id.
  • traverse: The browser navigated from one existing history entry to another existing history entry.

Examples

js
window.addEventListener("pageswap", (event) => {
  // For example, the page was hidden, or the navigation is cross-document.
  if (!event.viewTransition) return;

  // Skip the view transition for back/forward navigations.
  if (event.activation.navigationType === "traverse") {
    event.viewTransition.skipTransition();
  }
});

Specifications

Specification
HTML Standard
# dom-navigationactivation-navigationtype

Browser compatibility

BCD tables only load in the browser

See also