Docs:

[bkdiehl]

What is the documentation issue?

Native history api only integrates with the app router

Is there any context that might help us understand?

It's pretty frustrating that the native history api doesn't integrate with the nextjs router unless you're using the app directory.

It is not documented that this only integrates with the app router. I just spent a lot of time upgrading my nextjs version, expecting to have this functionality in the pages router, to no avail. I certainly don't understand why the pages router can't also support this.

Does the docs page already exist? Please link to it.

https://nextjs.org/docs/app/building-your-application/routing/linking-and-navigating#using-the-native-history-api

[samcx]

@bkdiehl When you switch the toggle to Pages Router, that section is not available.

Is there a reason why the router methods are not suitable → https://nextjs.org/docs/pages/api-reference/functions/use-router#routerreplace?