Summarizer：summarize() 方法

语法

summarize(input)
summarize(input, options)

参数

input

一个代表待摘要文本的字符串。

options 可选

一个指定 summarize() 操作配置选项的对象。可能的值包括：

context

一个描述输入文本使用场景的字符串，这有助于 Summarizer 生成更合适的摘要。

signal

一个 AbortSignal 对象实例，允许通过关联的 AbortController 来中止 summarize() 操作。

返回值

一个 Promise，它将以包含生成摘要的字符串的形式 fulfilled。

异常

InvalidStateError DOMException

如果当前 Document 未激活，则抛出此异常。

NotAllowedError DOMException

如果 Summarizer API 的使用被 summarizer Permissions-Policy 阻止，则会抛出此错误。

NotReadableError DOMException

如果输出摘要被用户代理过滤，例如因为它被检测为有害、不准确或无意义，则抛出此异常。

NotSupportedError DOMException

如果提供的 context 的语言不是 Summarizer 支持的语言，则抛出此异常。

QuotaExceededError

如果 summarize 操作超过了可用的 inputQuota，则会抛出此异常。

UnknownError DOMException

如果 summarize() 调用因任何其他原因失败，或者用户代理不愿披露的原因而失败，则会抛出此异常。

示例

基本的 summarize() 用法

const summarizer = await Summarizer.create({
  sharedContext:
    "A general summary to help a user decide if the text is worth reading",
  type: "tldr",
  length: "short",
});

const summary = await summarizer.summarize(myTextString);
console.log(summary);

规范

浏览器兼容性

另见

• 使用 Summarizer API
• chrome.dev 上的 Web AI 演示