Translator: measureInputUsage() method

input

A string representing the input text you want an input usage measurement for.

options Optional

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.

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

NotAllowedError DOMException

Thrown if usage of the Translator API is blocked by a 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.

In the below snippet, we create a new Translator instance using create(), then return the total input quota via 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 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("Boo, not enough quota left to translate.");
} else {
  console.log("Yay, enough quota left to translate.");
  const translation = await translator.translate(myTextString);
  // ...
}

• Using the Translator and Language Detector APIs