kit: False positive pushstate warnings
This PR, released as part of `v2.3.4` results in a new warning that wasn't previously there:
[Warning] Avoid using `history.pushState(...)` and `history.replaceState(...)` as these will conflict with SvelteKit's router. Use the `pushState` and `replaceState` imports from `$app/navigation` instead. (client.js, line 2580)
I’m not using history as suggested by the warning. I’m using goto in a couple of places, from $app/navigation. I haven’t changed anything. The warning is not present with v2.3.3.
From a quick test, commenting out all the goto calls still resulted in the warning.
_Originally posted by @lukasmalkmus in https://github.com/sveltejs/kit/issues/11657#issuecomment-1899297322_
I think this happens because when a library like Google Analytics monkey patches pushstate it will be next in the call stack, resulting in the false positive. I’m not sure how to solve this other than checking the whole stack for an occurrence of the client file, which may result in false negatives.
About this issue
- Original URL
- State: closed
- Created 3 years ago
- Reactions: 9
- Comments: 17 (7 by maintainers)
Getting a false positive as well, also with any
gotoandreplaceStatecalls commented out. This is with SvelteKit 2.5.0.Getting this when using Open Telemetry tracing on client side. The library is using push state, none of my internal code calls push state.
Also receiving a false positive when calling goto. Given the warnings we’re receiving, it would be helpful if the documentation was also updated to include multiple examples of replaceState / pushState. Page state as a required parameter for replaceState is confusing and inconsistent with the original History API.
We’d ideally do a drop-in replacement for history.replaceState when changing the query parameters via shallow routing, but we cannot do so currently and instead have to wrestle with the unclear example usage of replaceState. StackOverflow currently recommends using goto but as mentioned in #11465, this behavior is also inconsistent. If replaceState and pushState could mirror the History API as closely as possible, thorough documentation of example usage wouldn’t be necessary. Thanks so much for the help!
I get this warning as soon as I do use
history.pushState().As much as I appreciate the work that went into
pushStatefrom'$app/navigation'I’m not sure I can actually use it in our (very special, indeed) setup. But SvelteKit overriding/extending a browser API (history.pushState) makes me feel uneasy.I’d much prefer to be able to use
history.pushStateas usual, but still have the added ease-of-use of $app/navigation.pushState() if I chose to use it.Hi! I get the same warning when using
history.replaceStateintentionally. I read through the docs and GitHub issues, but I don’t quite understand, how to replicate the behavior ofhistory.replaceStatewithreplaceStatefrom SvelteKit. I need to update query params without changing page state and running the load function, but when I do this withreplaceStateI get an error:My code roughly looks like this:
Then I run
replaceStateWithQuerywhen a user changes some filters on the page to persist the state of the filters in URL.SvelteKit is not overriding a browser API - we only patch the
pushState/replaceStateat dev time to add this warning in case someone would call it themselves directly. SvelteKit always used the history state to place state on it, so this warning just surfaced potentially dangerous behavior anyway. That said, I’m wondering if we should not warn in dev mode if the user did preserve the internal SvelteKit state (i.e. the SvelteKit history index etc entries are still there). @Rich-Harris you originally added the warning in #11307 to discourage usage. What dangers do you saw besides not usingpushState/replaceStatewhich may not behave the way people want them to (because of https://github.com/sveltejs/kit/issues/11503#issuecomment-1876724453)?