Function createNativeHistory

Create a native history controller backed by in-memory history.

This is the primary native routing primitive when the environment does not provide browser history. It gives shared Route matching a stable path/history source and applies incoming deep links as navigations in that same model.

Lifecycle behavior:

• start() is idempotent.
• stop() is idempotent.
• start() applies getInitialURL() once per start cycle only if navigation state has not changed since startup began.
• This prevents late getInitialURL() resolution from overriding user navigation that happened during startup.

Incoming URL behavior:

• "replace" updates current entry (default).
• "push" appends a new entry.

Example:

const history = createNativeHistory({
  adapter: linkingAdapter,
  onIncomingURL: "replace",
});
await history.start();
Copy