Skip to content

Update exception information for Navigation.navigate() #41915

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
+7 −4
Open

Update exception information for Navigation.navigate() #41915

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3a094eb
Update exception information for Navigation.navigate()
chrisdavidmills Nov 12, 2025
b11863e
Add Fx144 rel note
chrisdavidmills Nov 12, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions files/en-us/mozilla/firefox/releases/144/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,6 +45,7 @@ Firefox 144 was released on [October 14, 2025](https://whattrainisitnow.com/rele
- The [View Transition API](/en-US/docs/Web/API/View_Transition_API) is now supported for [SPAs (single-page applications)](/en-US/docs/Glossary/SPA). This provides a mechanism for easily creating animated transitions between different website views. ([Firefox bug 1985809](https://bugzil.la/1985809)).
- The {{domxref("CSSStyleProperties")}} interface of the [CSS Object Model (CSSOM)](/en-US/docs/Web/API/CSS_Object_Model) is now implemented (this was renamed from a non-standard interface `CSS2Properties`). The new interface is present but not yet used. ([Firefox bug 1919582](https://bugzil.la/1919582)).
- The {{domxref("PerformanceEventTiming.interactionId", "interactionId")}} property of the {{domxref("PerformanceEventTiming")}} interface is a unique identifier that associates related events belonging to a single user interaction. This can be used to calculate the {{glossary("Interaction to next paint")}} metric, which helps analyze responsiveness to user interaction over the lifetime of a page. ([Firefox bug 1956809](https://bugzil.la/1956809)).
- The {{domxref("Navigation.navigate()")}} method of the {{domxref("Navigation API", "Navigation API", "", "nocode")}} no longer accepts URLs with a scheme of `javascript`. Calling `navigate()` with a `javascript:` URL now results in a `NotSupportedError` {{domxref("DOMException")}} being thrown ([Firefox bug 1981104](https://bugzil.la/1981104)).

#### DOM

Expand Down
10 changes: 6 additions & 4 deletions files/en-us/web/api/navigation/navigate/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ navigate(url, options)
### Parameters

- `url`
- : The destination URL to navigate to. Note that when calling `navigate()` on another window's `navigation` object, the URL will be resolved relative to the target window's URL, not the calling window's URL. This matches the behavior of the [History API](/en-US/docs/Web/API/History_API), but not the behavior of the [Location API](/en-US/docs/Web/API/Location).
- : The destination URL to navigate to. Note that when calling `navigate()` on another window's `navigation` object, the URL will be resolved relative to the target window's URL, not the calling window's URL. This matches the behavior of the [History API](/en-US/docs/Web/API/History_API), but not the behavior of the [Location API](/en-US/docs/Web/API/Location). Note also that `javascript:` URLs are disallowed for security reasons.
- `options` {{optional_inline}}
- : An options object containing the following properties:
- `state` {{optional_inline}}
Expand All @@ -50,12 +50,14 @@ Either one of these promises rejects if the navigation has failed for some reaso
### Exceptions

- `DataCloneError` {{domxref("DOMException")}}
- : Thrown if the `state` parameter had values included in it that are not structured-cloneable.
- : Thrown if the `state` parameter has values included in it that are not structured-cloneable.
- `InvalidStateError` {{domxref("DOMException")}}
- : Thrown if the document is not currently active.
- `SyntaxError` {{domxref("DOMException")}}
- : Thrown if the `url` parameter is not a valid URL.
- `NotSupportedError` {{domxref("DOMException")}}
- : Thrown if the `history` option is set to `push`, and any of the following special circumstances are true:
- The browser is currently showing the initial `about:blank` document.
- : Thrown if:
- The `history` option is set to `push`, and the browser is currently showing the initial `about:blank` document.
- The `url`'s scheme is `javascript`.

## Examples
Expand Down