Translator: inputQuota-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die schreibgeschützte inputQuota-Eigenschaft des Translator-Interfaces gibt das verfügbare Eingabekontingent des Browsers zur Generierung von Übersetzungen zurück.
Wert
Eine Zahl, die das verfügbare Eingabekontingent angibt.
Diese Zahl ist implementierungsabhängig. Zum Beispiel könnte sie Infinity sein, wenn es keine anderen Einschränkungen als den Speicher des Benutzers und die maximale Länge von JavaScript-Strings gibt, oder es könnte sich um eine Anzahl von Token handeln, im Falle von AI-Modellen, die ein Token-/Kredit-Schema verwenden.
Die einzige Garantie ist, dass inputQuota - measureInputUsage() nicht negativ sein wird, wenn ausreichend Kontingent vorhanden ist, um den Text zu übersetzen.
Beispiele
Überprüfen, ob genügend Kontingent vorhanden ist
Im folgenden Codeausschnitt erstellen wir eine neue Translator-Instanz mit create() und geben das gesamte Eingabekontingent über inputQuota sowie die Eingabekontingentnutzung für die Übersetzung eines bestimmten Textstrings über measureInputUsage() zurück.
Wir testen dann, ob die individuelle Eingabenutzung für diesen String größer ist als das insgesamt verfügbare Kontingent. Falls ja, werfen wir einen entsprechenden Fehler; wenn nicht, beginnen wir mit der Übersetzung des Strings mittels 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);
// ...
}
Spezifikationen
| Spezifikation |
|---|
| Translator and Language Detector APIs # dom-translator-inputquota |