Translator: inputQuota property
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The inputQuota
read-only property of the Translator
interface returns the input quota available to the browser for generating translations.
Value
A number specifying the available input quota. This number is implementation-dependant. For example, it might be Infinity
if there are no limits beyond the user's memory and the maximum length of JavaScript strings, or it might be a number of tokens in the case of AI models that use a token/credits scheme.
Examples
Checking if you have enough quota
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);
// ...
}
Specifications
No specification found
No specification data found for api.Translator.inputQuota
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.