Editorial review: Document the Summarizer API

[chrisdavidmills]

Description

Chrome 138 onwards supports the Summarizer API; the relevant ChromeStatus entry says 139, but I've been told this is incorrect.

Note

During review, you may need to enable the chrome://flags/#summarization-api-for-gemini-nano flag to get the demos running in Chrome.

Specifically, this PR adds:

• A Summarizer API landing page
• A usage guide
• A reference for the Summarizer interface.
• A reference for the CreateMonitor interface.

Motivation

Additional details

Related issues and pull requests

[github-actions]

Preview URLs (21 pages)

• /en-US/docs/Web/API/CreateMonitor/downloadprogress_event
• /en-US/docs/Web/API/CreateMonitor
• /en-US/docs/Web/API/Summarizer/availability_static
• /en-US/docs/Web/API/Summarizer/create_static
• /en-US/docs/Web/API/Summarizer/destroy
• /en-US/docs/Web/API/Summarizer/expectedContextLanguages
• /en-US/docs/Web/API/Summarizer/expectedInputLanguages
• /en-US/docs/Web/API/Summarizer/format
• /en-US/docs/Web/API/Summarizer/inputQuota
• /en-US/docs/Web/API/Summarizer/length
• /en-US/docs/Web/API/Summarizer/measureInputUsage
• /en-US/docs/Web/API/Summarizer/outputLanguage
• /en-US/docs/Web/API/Summarizer/sharedContext
• /en-US/docs/Web/API/Summarizer/summarizeStreaming
• /en-US/docs/Web/API/Summarizer/summarize
• /en-US/docs/Web/API/Summarizer/type
• /en-US/docs/Web/API/Summarizer_API/Using
• /en-US/docs/Web/API/Summarizer_API
• /en-US/docs/Web/API/Summarizer
• /en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy/summarizer
• /en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy

Flaws (7)

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

URL: /en-US/docs/Web/API/CreateMonitor
Title: CreateMonitor
Flaw count: 2

• macros:
  • Can't resolve /en-US/docs/Web/API/LanguageDetector/create_static
  • Can't resolve /en-US/docs/Web/API/Translator/create_static

---

URL: /en-US/docs/Web/API/Summarizer/summarize
Title: Summarizer: summarize() method
Flaw count: 1

• macros:
  • Can't resolve /en-US/docs/Web/API/Summarize/inputQuota

---

URL: /en-US/docs/Web/API/Summarizer/summarizeStreaming
Title: Summarizer: summarizeStreaming() method
Flaw count: 1

• macros:
  • Can't resolve /en-US/docs/Web/API/Summarize/inputQuota

---

URL: /en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy/summarizer
Title: Permissions-Policy: summarizer
Flaw count: 3

• unknown:
  • No generic content config found
  • no blog root
  • no blog root

External URLs (31)

URL: /en-US/docs/Web/API/CreateMonitor
Title: CreateMonitor

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/CreateMonitor/downloadprogress_event
Title: CreateMonitor: downloadprogress event

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer
Title: Summarizer

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer_API
Title: Summarizer API

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)
• https://developer.chrome.com/docs/ai/summarizer-api (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer_API/Using
Title: Using the Summarizer API

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/availability_static
Title: Summarizer: availability() static method

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)
• https://datatracker.ietf.org/doc/html/rfc5646 (1 time) (Note! This may be a new URL 👀)
• https://en.wikipedia.org/wiki/IETF_language_tag (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/create_static
Title: Summarizer: create() static method

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)
• https://datatracker.ietf.org/doc/html/rfc5646 (1 time) (Note! This may be a new URL 👀)
• https://en.wikipedia.org/wiki/IETF_language_tag (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/destroy
Title: Summarizer: destroy() method

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/expectedContextLanguages
Title: Summarizer: expectedContextLanguages property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)
• https://datatracker.ietf.org/doc/html/rfc5646 (1 time) (Note! This may be a new URL 👀)
• https://en.wikipedia.org/wiki/IETF_language_tag (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/expectedInputLanguages
Title: Summarizer: expectedInputLanguages property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)
• https://datatracker.ietf.org/doc/html/rfc5646 (1 time) (Note! This may be a new URL 👀)
• https://en.wikipedia.org/wiki/IETF_language_tag (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/format
Title: Summarizer: format property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)
• https://spec.commonmark.org/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/inputQuota
Title: Summarizer: inputQuota property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/length
Title: Summarizer: length property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/measureInputUsage
Title: Summarizer: measureInputUsage() method

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/outputLanguage
Title: Summarizer: outputLanguage property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)
• https://datatracker.ietf.org/doc/html/rfc5646 (1 time) (Note! This may be a new URL 👀)
• https://en.wikipedia.org/wiki/IETF_language_tag (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/sharedContext
Title: Summarizer: sharedContext property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/summarize
Title: Summarizer: summarize() method

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/summarizeStreaming
Title: Summarizer: summarizeStreaming() method

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/API/Summarizer/type
Title: Summarizer: type property

• https://chrome.dev/web-ai-demos/ (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-05-21 15:33:41)

[alexandrascript]

Answering some editorial questions

[bsmth]

Thanks, @chrisdavidmills - all done if you want a look 👀

[bsmth]

+1 from me, thanks! 👍🏻