Document `fetchLater()` #39016

tunetheweb · 2025-04-07T10:15:35Z

Description

Adds docs on fetchLater() API added in Chrome 135.

Motivation

New API that needs documenting.

NOTE the spec changes have NOT been merged yet, so the docs show missing spec at present.

Additional details

ChromeStatus: https://chromestatus.com/feature/4654499737632768
Previous Origin Trail article on developer.chrome.com: https://developer.chrome.com/blog/fetch-later-api-origin-trial

Explainer: https://github.com/WICG/pending-beacon/blob/main/docs/fetch-later-api.md
Spec PR (not merged yet): whatwg/fetch#1647

Related issues and pull requests

Added to BCD in mdn/browser-compat-data#26135 and mdn/browser-compat-data#26437.

github-actions · 2025-04-07T10:56:33Z

Preview URLs (11 pages)

Flaws (1)

Note! 10 documents with no flaws that don't need to be listed. 🎉

URL: /en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy/deferred-fetch
Title: Permissions-Policy: deferred-fetch
Flaw count: 1

unknown:
- No generic content config found

(comment last updated: 2025-04-09 12:10:06)

…Later

chrisdavidmills

@tunetheweb getting there! A few more comments for you, mostly around the quotas guide rewrite.

files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

files/en-us/web/api/deferredrequestinit/activateafter/index.md

files/en-us/web/api/fetchlaterresult/activated/index.md

files/jsondata/GroupData.json

Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>

files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

…Later

tunetheweb · 2025-04-09T10:02:51Z

@chrisdavidmills any thoughts on KB (ambiguous as to whether 1000 bytes or 1024 bytes, though technically it's 1000) versus KiB (explicitly 1024 bytes and technically more accurate)?

@noamr suggested it's technically KiB and so changed it in 44b6681 but doesn't seem like KiB is used much in MDN.

chrisdavidmills · 2025-04-09T11:54:33Z

@chrisdavidmills any thoughts on KB (ambiguous as to whether 1000 bytes or 1024 bytes, though technically it's 1000) versus KiB (explicitly 1024 bytes and technically more accurate)?

@noamr suggested it's technically KiB and so changed it in 44b6681 but doesn't seem like KiB is used much in MDN.

@tunetheweb I've seen KiB used elsewhere on MDN; I think it's good to be accurate.

chrisdavidmills

@tunetheweb I think this is pretty much ready to go. I've just left a few non-blocking suggestions for you. Let me know when you've considered them, and I will get it merged!

chrisdavidmills · 2025-04-09T11:51:46Z

files/en-us/web/http/reference/headers/permissions-policy/deferred-fetch/index.md

@@ -2,6 +2,8 @@
 title: "Permissions-Policy: deferred-fetch"
 slug: Web/HTTP/Reference/Headers/Permissions-Policy/deferred-fetch
 page-type: http-permissions-policy-directive
+status:


Not a blocker, but you actually don't need to add these anymore; the system adds them automatically based on the BCD.

(just informational; you don't need to remove them again)

I noticed that the sidebar didn't show the flask icon without these explicit addition?

Or do you mean they ARE needed, but will be added automatically after merge so I didn't need to add them manually (but no harm that I have done it - but more FYI for next time to save me some bother?).

Or do you mean they ARE needed, but will be added automatically after merge so I didn't need to add them manually (but no harm that I have done it - but more FYI for next time to save me some bother?).

Yes, exactly correct.

files/en-us/web/api/deferredrequestinit/index.md

files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>

tunetheweb · 2025-04-09T12:09:43Z

Thanks for your help reviewing @noamr and @chrisdavidmills !

I've seen some movement on the spec PR so hopefully that'll follow along soon. But this one has dragged on so let's not wait for that in case it's not as close as I think since Chrome has shipped this already. Will add spec links to BCD after it's been merged and it should flow into here.

chrisdavidmills · 2025-04-09T12:12:34Z

Nice work, @tunetheweb.

* Fetch Later API * More updates * Rename api * Add quotas docs * Tweaks * Cleanup * Linting fix * Linting fix * Update PP docs * Fix folder name * Fix example * Linting fixes * More linting fixes * Tweak * Explain example * More linting * Add CSP and more exception details * Update files/en-us/web/api/window/fetchlater/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/en-us/web/api/window/fetchlater/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/en-us/web/api/window/fetchlater/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/en-us/web/api/window/fetchlater/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * more quota examples * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Review feedback * Accepting first batch of review feedback Co-authored-by: Chris Mills <chrisdavidmills@gmail.com> * Second batch of suggestions from code review Co-authored-by: Chris Mills <chrisdavidmills@gmail.com> * Update files/en-us/web/api/fetchlater_api/index.md Co-authored-by: Chris Mills <chrisdavidmills@gmail.com> * Update files/en-us/web/api/fetchlater_api/index.md * Update files/en-us/web/api/fetchlater_api/index.md * Update files/en-us/web/api/fetchlater_api/index.md * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md * Update files/en-us/web/api/fetchlater_api/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md * Update files/en-us/web/api/window/fetchlater/index.md * Review feedback * Update files/en-us/web/api/fetchlaterresult/activated/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Rename file * Meta cleanup * Tweaks * browser-compat for deferred-fetch and deferred-fetch-init * Permissions Policy updates * Apply suggestions from code review Co-authored-by: Chris Mills <chrisdavidmills@gmail.com> * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md * Review feedback * KB -> KiB * Permissions Policy BCD fixes * Frontmatter * Fetch Interfaces * Update files/en-us/web/api/deferredrequestinit/index.md Co-authored-by: Chris Mills <chrisdavidmills@gmail.com> * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md Co-authored-by: Chris Mills <chrisdavidmills@gmail.com> * Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md Co-authored-by: Chris Mills <chrisdavidmills@gmail.com> --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>

tunetheweb added 8 commits April 3, 2025 16:51

Fetch Later API

d619b1e

Merge branch 'main' into fetchLater

1e7aa87

More updates

e6530a5

Rename api

f0242d4

Merge branch 'main' into fetchLater

ba424cd

Add quotas docs

15beb78

Tweaks

f6948d6

Cleanup

a3eb7b6

tunetheweb requested review from a team as code owners April 7, 2025 10:15

tunetheweb requested review from hamishwillee, wbamberg and pepelsbey and removed request for a team April 7, 2025 10:15

github-actions bot added Content:WebAPI Web API docs Content:HTTP HTTP docs size/l [PR only] 501-1000 LoC changed labels Apr 7, 2025

tunetheweb mentioned this pull request Apr 7, 2025

fetchLater updates mdn/browser-compat-data#26437

Merged

tunetheweb added 5 commits April 7, 2025 11:21

Linting fix

9f3d56d

Merge branch 'main' into fetchLater

5d93bd4

Linting fix

687e685

Update PP docs

92e22fb

Fix folder name

d83ed1e

tunetheweb added 3 commits April 7, 2025 11:58

Fix example

94d7d7e

Linting fixes

39286a9

More linting fixes

65eab67

tunetheweb added 5 commits April 8, 2025 22:17

Merge branch 'fetchLater' of github.com:tunetheweb/content into fetch…

cf512b6

…Later

Meta cleanup

5eab466

Tweaks

a65684b

browser-compat for deferred-fetch and deferred-fetch-init

b97ab4e

Permissions Policy updates

9050e2a

chrisdavidmills requested changes Apr 9, 2025

View reviewed changes

Apply suggestions from code review

948a474

Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>

github-actions bot reviewed Apr 9, 2025

View reviewed changes

files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md Outdated Show resolved Hide resolved

Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

42ab726

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

github-actions bot reviewed Apr 9, 2025

View reviewed changes

files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md Outdated Show resolved Hide resolved

tunetheweb added 5 commits April 9, 2025 09:50

Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

298b285

Review feedback

826f7f4

Merge branch 'main' into fetchLater

f63717d

KB -> KiB

44b6681

Merge branch 'fetchLater' of github.com:tunetheweb/content into fetch…

0ff798c

…Later

tunetheweb requested a review from chrisdavidmills April 9, 2025 10:03

tunetheweb added 3 commits April 9, 2025 11:38

Permissions Policy BCD fixes

839e7fe

Frontmatter

b614216

Fetch Interfaces

6171f01

chrisdavidmills approved these changes Apr 9, 2025

View reviewed changes

tunetheweb and others added 3 commits April 9, 2025 13:07

Update files/en-us/web/api/deferredrequestinit/index.md

85607a4

Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>

Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

566700d

Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>

Update files/en-us/web/api/fetchlater_api/fetchlater_quotas/index.md

1d668e7

Co-authored-by: Chris Mills <chrisdavidmills@gmail.com>

chrisdavidmills merged commit 31ba9f6 into mdn:main Apr 9, 2025
9 checks passed

tunetheweb mentioned this pull request Apr 14, 2025

fetchLater corrections and updates #39118

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Document `fetchLater()` #39016

Document `fetchLater()` #39016

tunetheweb commented Apr 7, 2025 •

edited

Loading

github-actions bot commented Apr 7, 2025 •

edited

Loading

chrisdavidmills left a comment

tunetheweb commented Apr 9, 2025

chrisdavidmills commented Apr 9, 2025

chrisdavidmills left a comment

chrisdavidmills Apr 9, 2025

chrisdavidmills Apr 9, 2025

tunetheweb Apr 9, 2025

chrisdavidmills Apr 9, 2025

tunetheweb commented Apr 9, 2025

chrisdavidmills commented Apr 9, 2025

Document fetchLater() #39016

Document fetchLater() #39016

Conversation

tunetheweb commented Apr 7, 2025 • edited Loading

Description

Motivation

Additional details

Related issues and pull requests

github-actions bot commented Apr 7, 2025 • edited Loading

chrisdavidmills left a comment

Choose a reason for hiding this comment

tunetheweb commented Apr 9, 2025

chrisdavidmills commented Apr 9, 2025

chrisdavidmills left a comment

Choose a reason for hiding this comment

chrisdavidmills Apr 9, 2025

Choose a reason for hiding this comment

chrisdavidmills Apr 9, 2025

Choose a reason for hiding this comment

tunetheweb Apr 9, 2025

Choose a reason for hiding this comment

chrisdavidmills Apr 9, 2025

Choose a reason for hiding this comment

tunetheweb commented Apr 9, 2025

chrisdavidmills commented Apr 9, 2025

Document `fetchLater()` #39016

Document `fetchLater()` #39016

tunetheweb commented Apr 7, 2025 •

edited

Loading

github-actions bot commented Apr 7, 2025 •

edited

Loading