MDN self-hosted library · e01.org

NavigationTransition: to property

Navigation API

Open notebook · 1 cells web-api-instance-property upstream source

Navigation API

The to read-only property of the NavigationTransition interface returns the NavigationDestination that the transition is navigating to.

This mirrors the NavigateEvent.destination property but, unlike that, is available outside of the navigate event handler. It is especially useful when calling functions prior to the URL changing (e.g., during precommit or on error).

Value

A NavigationDestination object.

Examples

Handling a navigation error

navigation.onnavigateerror = (e) => {
  if (navigation.transition?.to?.url === loginPageURL) {
    /* do something when failing to go to login page */
  }
};

Specifications

Browser compatibility

See also