大网数据广告活动
Web 标准与前端开发

Translator: measureInputUsage() method

· 52CE 我爱测

The **`measureInputUsage()`** method of the Translator interface reports how much input quota would be used by a translation operation for a given text input.

Translator and Language Detector APIs

The measureInputUsage() method of the Translator interface reports how much input quota would be used by a translation operation for a given text input.

Syntax

measureInputUsage(input)
measureInputUsage(input, options)

Parameters

  • input
    • : A string representing the input text you want an input usage measurement for.
  • options
    • : An object specifying configuration options for the measureInputUsage() operation. Possible values include:
      • signal
        • : An AbortSignal object instance, which allows the measureInputUsage() operation to be aborted via the associated AbortController.

Return value

A Promise that fulfills with a number specifying the Translator.inputQuota usage of the given input text.

This number is implementation-dependent; if it is less than the Translator.inputQuota, the string can be translated.

Exceptions

  • NotAllowedError DOMException
    • : Thrown if usage of the Translator API is blocked by a Permissions-Policy/translator Permissions-Policy.
  • NotReadableError DOMException
    • : Thrown if the output translation was filtered by the user agent, for example because it was detected to be harmful, inaccurate, or nonsensical.
  • UnknownError DOMException
    • : Thrown if the measureInputUsage() call failed for any other reason, or a reason the user agent did not wish to disclose.

Examples

Checking if you have enough quota

In the below snippet, we create a new Translator instance using Translator.create_static, then return the total input quota via Translator.inputQuota and the input quota usage for a translating a particular text string via measureInputUsage().

We then test to see if the individual input usage for that string is greater than the total available quota. If so, we throw an appropriate error; it not, we commence translating the string using Translator.translate.

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);
  // ...
}

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。