Interface History

back

• back(): void

  Move back one page in the history.

  Returns void

block

• block(blocker: HistoryBlocker): () => void

  Registers a blocker that prevents navigation with history.

  Parameters

  • blocker: HistoryBlocker

    A blocker to register.

  Returns () => void

  A callback that removes blocker.

forward

• forward(): void

  Move forward one page in the history.

  Returns void

go

• go(delta: number): void

  Move forwards and backwards through the history depending on the delta.

  Parameters

  • delta: number

    The position in the history to which you want to move, relative to the current page. A negative value moves backwards, a positive value moves forwards.

  Returns void

parseURL

• parseURL(url: string): Location

  Parses a URL string as a location.

  Parameters

  • url: string

  Returns Location

push

• push(to: string | To): void

  Adds an entry to the history stack.

  Parameters

  • to: string | To

    A location or a URL to navigate to.

  Returns void

  Example

  const userRoute = createRoute('/users/:userId');
  
  history.push(userRoute.getLocation({ userId: 42 }));
  // or
  history.push('/users/42');
  Copy

replace

• replace(to: string | To): void

  Modifies the current history entry, replacing it with the state object and URL passed in the method parameters.

  Parameters

  • to: string | To

    A location or a URL to navigate to.

  Returns void

  Example

  const userRoute = createRoute('/users/:userId');
  
  history.replace(userRoute.getLocation({ userId: 42 }));
  // or
  history.replace('/users/42');
  Copy

subscribe

• subscribe(listener: () => void): () => void

  Subscribe to location changes.

  Parameters

  • listener: () => void

    A listener to subscribe.

  Returns () => void

  A callback to unsubscribe a listener.

toURL

• toURL(to: To): string

  Converts a location to a URL string.

  Parameters

  • to: To

  Returns string

ReadonlycanGoBack

Readonlylocation

Readonlyurl