Summarizer: inputQuota 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

Summarizer 介面的只讀屬性 inputQuota 返回瀏覽器用於生成摘要的可用輸入配額。

一個指定可用輸入配額的數字。此數字取決於實現。例如,如果沒有超出使用者記憶體和 JavaScript 字串最大長度的限制,它可能是 Infinity,或者在使用 token/credit 方案的 AI 模型的情況下,它可能是 token 的數量。

示例

檢查您是否有足夠的配額

在下面的程式碼片段中,我們使用 create() 建立一個新的 Summarizer 例項,然後透過 inputQuota 返回總輸入配額,並透過 measureInputUsage() 返回用於摘要特定文字字串的輸入配額使用情況。

然後,我們測試該字串的單個輸入使用量是否大於總可用配額。如果是,則丟擲適當的錯誤;否則,我們使用 summarize() 開始摘要該字串。

js
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 totalInputQuota = summarizer.inputQuota;
const inputUsage = await summarizer.measureInputUsage(myTextString);

if (inputUsage > totalInputQuota) {
  throw new Error("Boo, insufficient quota to generate a summary.");
} else {
  console.log("Yay, quota available to generate a summary.");
  const summary = await summarizer.summarize(myTextString);
  // ...
}

規範

規範
寫作輔助 API
# dom-summarizer-inputquota

瀏覽器相容性

另見