Translator: inputQuota-Eigenschaft

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 inputQuota schreibgeschützte Eigenschaft der Translator-Schnittstelle gibt die verfügbare Eingabequote des Browsers zur Generierung von Übersetzungen zurück.

Wert

Eine Zahl, die die verfügbare Eingabequote angibt.

Diese Zahl ist implementationsabhängig. Zum Beispiel könnte sie Infinity sein, wenn es keine Beschränkungen über den Speicher des Benutzers und die maximale Länge von JavaScript-Strings hinaus gibt, oder es könnte eine Anzahl von Tokens sein, im Falle von KI-Modellen, die ein Token/Credits-System verwenden.

Die einzige Garantie ist, dass inputQuota - measureInputUsage() nicht negativ sein wird, wenn eine ausreichende Quote vorhanden ist, um den Text zu übersetzen.

Beispiele

Überprüfen, ob Sie genügend Quote haben

Im folgenden Code-Snippet erstellen wir eine neue Translator-Instanz mit create(), geben dann die gesamte Eingabequote über inputQuota und die Eingabequoten-Nutzung für die Übersetzung eines bestimmten Textstrings über measureInputUsage() zurück.

Wir prüfen dann, ob die individuelle Eingabenutzung für diesen String größer ist als die insgesamt verfügbare Quote. Falls ja, werfen wir einen entsprechenden Fehler; falls nicht, beginnen wir mit der Übersetzung des Strings mittels translate().

js
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

Specification
Translator and Language Detector APIs
# dom-translator-inputquota

Browser-Kompatibilität

Siehe auch