diff --git a/packages/common/src/location/location.ts b/packages/common/src/location/location.ts index f531104c3c9..4df0e7f420e 100644 --- a/packages/common/src/location/location.ts +++ b/packages/common/src/location/location.ts @@ -30,7 +30,7 @@ export interface PopStateEvent { * * @usageNotes * - * It's better to use the `Router#navigate` service to trigger route changes. Use + * It's better to use the `Router.navigate()` service to trigger route changes. Use * `Location` only if you need to interact with or create normalized URLs outside of * routing. * @@ -228,9 +228,14 @@ export class Location { /** * Subscribes to the platform's `popState` events. * + * Note: `Location.go()` does not trigger the `popState` event in the browser. Use + * `Location.onUrlChange()` to subscribe to URL changes instead. + * * @param value Event that is triggered when the state history changes. * @param exception The exception to throw. * + * @see [onpopstate](https://developer.mozilla.org/en-US/docs/Web/API/WindowEventHandlers/onpopstate) + * * @returns Subscribed events. */ subscribe(