Translator: measureInputUsage() Methode

input

Ein String, der den Eingangstext darstellt, für den Sie eine Eingabenutzungsmessung wünschen.

options Optional

Ein Objekt, das Konfigurationsoptionen für den measureInputUsage() Vorgang angibt. Mögliche Werte umfassen:

signal

Eine AbortSignal Objektinstanz, die es ermöglicht, den measureInputUsage() Vorgang über den zugehörigen AbortController abzubrechen.

Ein Promise, das mit einer Zahl erfüllt wird, die die Nutzung der inputQuota des gegebenen Eingangstexts angibt.

Diese Zahl ist implementationsabhängig; wenn sie kleiner als die inputQuota ist, kann der String übersetzt werden.

NotAllowedError DOMException

Wird ausgelöst, wenn die Nutzung der Translator API durch ein translator Permissions-Policy blockiert ist.

NotReadableError DOMException

Wird ausgelöst, wenn die Ausgabeübersetzung vom User-Agent gefiltert wurde, zum Beispiel, weil sie als schadhaft, ungenau oder unsinnig erkannt wurde.

UnknownError DOMException

Wird ausgelöst, wenn der measureInputUsage() Aufruf aus irgendeinem anderen Grund fehlschlug oder ein Grund, den der User-Agent nicht offenlegen wollte.

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

Dann testen wir, ob die individuelle Eingabenutzung für diesen String größer als die insgesamt verfügbare Quote ist. Wenn ja, werfen wir einen entsprechenden Fehler; wenn nicht, beginnen wir mit der Übersetzung des Strings mit 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);
  // ...
}

• Verwendung der Translator und Language Detector APIs