Skip to content

Update specs and standard status of Speculation Rules API #41212

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

Merged
merged 6 commits into from
Sep 29, 2025
Merged

Update specs and standard status of Speculation Rules API #41212

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
17c818f
Update specs and standard status of Speculation Rules API
tunetheweb Sep 19, 2025
c758491
Remove inline non-standards
tunetheweb Sep 19, 2025
0d819f7
Review feedback
tunetheweb Sep 19, 2025
b5387c7
Merge branch 'main' into spec-rules-standards
tunetheweb Sep 25, 2025
7dc7375
Merge branch 'main' into spec-rules-standards
tunetheweb Sep 27, 2025
1bcad63
Merge branch 'main' into spec-rules-standards
bsmth Sep 29, 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
3 changes: 1 addition & 2 deletions files/en-us/web/api/document/prerendering/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,10 @@ slug: Web/API/Document/prerendering
page-type: web-api-instance-property
status:
- experimental
- non-standard
browser-compat: api.Document.prerendering
---

{{ APIRef("Speculation Rules API") }}{{seecompattable}}{{non-standard_header}}
{{ APIRef("Speculation Rules API") }}{{seecompattable}}

The **`prerendering`** read-only property of the {{domxref("Document")}} interface returns `true` if the document is currently in the process of prerendering, as initiated via the [Speculation Rules API](/en-US/docs/Web/API/Speculation_Rules_API).

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/api/performancenavigationtiming/activationstart/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,10 @@ slug: Web/API/PerformanceNavigationTiming/activationStart
page-type: web-api-instance-property
status:
- experimental
- non-standard
browser-compat: api.PerformanceNavigationTiming.activationStart
---

{{APIRef("Performance API")}}{{SeeCompatTable}}{{non-standard_header}}
{{APIRef("Performance API")}}{{SeeCompatTable}}
Copy link
Contributor

@chrisdavidmills chrisdavidmills Sep 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is also an inline non-standard badge to remove from the activationStart property entry in the list at https://developer.mozilla.org/en-US/docs/Web/API/PerformanceNavigationTiming.

Copy link
Contributor Author

@tunetheweb tunetheweb Sep 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Got this one already in c758491#diff-5f8941d9eeb6bdd909084f20a29fe19b4fad8448085434d803f1f8ab50b63d76 I think?


The **`activationStart`** read-only property represents the time between when a document starts prerendering and when it is activated.

Expand Down
11 changes: 8 additions & 3 deletions files/en-us/web/api/speculation_rules_api/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,22 @@ slug: Web/API/Speculation_Rules_API
page-type: web-api-overview
status:
- experimental
- non-standard
browser-compat:
- api.Document.prerendering
- api.Document.prerenderingchange_event
- api.PerformanceNavigationTiming.activationStart
- html.elements.script.type.speculationrules
- http.headers.Content-Security-Policy.script-src.inline-speculation-rules
- http.headers.Sec-Purpose.speculationrules
- http.headers.Sec-Speculation-Tags
- http.headers.Speculation-Rules
- http.headers.Supports-Loading-Mode
spec-urls:
- https://wicg.github.io/nav-speculation/speculation-rules.html
- https://html.spec.whatwg.org/multipage/speculative-loading.html#speculative-loading
- https://wicg.github.io/nav-speculation/prerendering.html
---

{{SeeCompatTable}}{{DefaultAPISidebar("Speculation Rules API")}}{{non-standard_header}}
{{SeeCompatTable}}{{DefaultAPISidebar("Speculation Rules API")}}

The **Speculation Rules API** is designed to improve performance for future navigations. It targets document URLs rather than specific resource files, and so makes sense for multi-page applications (MPAs) rather than single-page applications (SPAs).

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/html/reference/elements/script/type/speculationrules/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,11 @@ slug: Web/HTML/Reference/Elements/script/type/speculationrules
page-type: html-attribute-value
status:
- experimental
- non-standard
browser-compat: html.elements.script.type.speculationrules
sidebar: htmlsidebar
---

{{SeeCompatTable}}{{non-standard_header}}
{{SeeCompatTable}}

The **`speculationrules`** value of the [`type`](/en-US/docs/Web/HTML/Reference/Elements/script/type) attribute of the [`<script>` element](/en-US/docs/Web/HTML/Reference/Elements/script) indicates that the body of the element contains speculation rules.

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/http/reference/headers/sec-speculation-tags/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,11 @@ slug: Web/HTTP/Reference/Headers/Sec-Speculation-Tags
page-type: http-header
status:
- experimental
- non-standard
browser-compat: http.headers.Sec-Speculation-Tags
sidebar: http
---

{{SeeCompatTable}}{{non-standard_header}}
{{SeeCompatTable}}

The HTTP **`Sec-Speculation-Tags`** {{Glossary("request header")}} contains one or more `tag` values from the [speculation rules](/en-US/docs/Web/API/Speculation_Rules_API) that resulted in the speculation. This allows a server to identify which rule(s) caused a speculation and potentially block them.

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/http/reference/headers/speculation-rules/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,11 @@ slug: Web/HTTP/Reference/Headers/Speculation-Rules
page-type: http-header
status:
- experimental
- non-standard
browser-compat: http.headers.Speculation-Rules
sidebar: http
---

{{SeeCompatTable}}{{non-standard_header}}
{{SeeCompatTable}}

The HTTP **`Speculation-Rules`** {{Glossary("response header")}} provides one or more URLs pointing to text resources containing speculation rule JSON definitions. When the response is an HTML document, these rules will be added to the document's speculation rule set. See the [Speculation Rules API](/en-US/docs/Web/API/Speculation_Rules_API) for more information.

Expand Down
3 changes: 1 addition & 2 deletions files/en-us/web/http/reference/headers/supports-loading-mode/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,11 @@ slug: Web/HTTP/Reference/Headers/Supports-Loading-Mode
page-type: http-header
status:
- experimental
- non-standard
browser-compat: http.headers.Supports-Loading-Mode
sidebar: http
---

{{securecontext_header}}{{SeeCompatTable}}{{non-standard_header}}
{{securecontext_header}}{{SeeCompatTable}}

The HTTP **`Supports-Loading-Mode`** {{Glossary("response header")}} allows a response to opt-in to being loaded in a novel, higher-risk context that it would otherwise fail to be loaded in.

Expand Down