翻译器:inputQuota 属性

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

inputQuotaTranslator 接口的一个只读属性,它返回浏览器用于生成翻译的可用输入配额。

一个指定可用输入配额的数字。

此数字取决于具体实现。例如,如果除了用户的内存和 JavaScript 字符串的最大长度之外没有其他限制,它可能为 Infinity;在某些使用 token/credit 方案的 AI 模型中,它可能表示 token 的数量。

唯一的保证是,如果文本的配额足够进行翻译,那么 inputQuota - measureInputUsage() 将是非负的。

示例

检查配额是否足够

在下面的代码片段中,我们使用 create() 创建一个新的 Translator 实例,然后通过 inputQuota 返回总输入配额,并通过 measureInputUsage() 返回翻译特定文本字符串的输入配额使用量。

然后,我们测试该字符串的单个输入使用量是否大于总可用配额。如果是,则抛出相应的错误;如果不是,则使用 translate() 开始翻译字符串。

js
const translator = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "ja",
});

const totalInputQuota = translator.inputQuota;
const inputUsage = await translator.measureInputUsage(myTextString);

if (inputUsage > totalInputQuota) {
  throw new Error("Insufficient quota to translate.");
} else {
  console.log("Quota available to translate.");
  const translation = await translator.translate(myTextString);
  // ...
}

规范

规范
翻译器和语言检测器 API
# dom-translator-inputquota

浏览器兼容性

另见