Translator and Language Detector APIs
The measureInputUsage() method of the LanguageDetector interface reports how much input quota would be used by a language detection 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.
- : An AbortSignal object instance, which allows the
- : An object specifying configuration options for the
Return value
A Promise that fulfills with a number specifying the LanguageDetector.inputQuota usage of the given input text.
This number is implementation-dependent; if it is less than the LanguageDetector.inputQuota, the string's language can be detected.
Exceptions
NotAllowedErrorDOMException- : Thrown if usage of the
LanguageDetectorAPI is blocked by a Permissions-Policy/language-detector Permissions-Policy.
- : Thrown if usage of the
UnknownErrorDOMException- : Thrown if the
measureInputUsage()call failed for any other reason, or a reason the user agent did not wish to disclose.
- : Thrown if the
Examples
Checking if you have enough quota
In the below snippet, we create a new LanguageDetector instance using LanguageDetector.create_static, then return the total input quota via LanguageDetector.inputQuota and the input quota usage for a detecting a particular text string's language 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 detecting the string's language using LanguageDetector.detect.
const detector = await LanguageDetector.create({
expectedInputLanguages: ["en-US", "zh"],
});
const totalInputQuota = detector.inputQuota;
const inputUsage = await detector.measureInputUsage(myTextString);
if (inputUsage > totalInputQuota) {
throw new Error("Insufficient quota to detect languages.");
} else {
console.log("Quota available to detect languages.");
const results = await detector.detect(myTextString);
// ...
}
Specifications
Browser compatibility
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
