Übersetzer: measureInputUsage() Methode

input

Ein String, der den Eingabetext darstellt, für den Sie eine Messung der Eingabenutzung durchführen möchten.

options Optional

Ein Objekt, das Konfigurationsoptionen für den measureInputUsage()-Vorgang spezifiziert. 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 Eingabetextes angibt.

Diese Zahl ist implementierungsabhä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 eine translator Permissions-Policy blockiert wird.

NotReadableError DOMException

Wird ausgelöst, wenn die Ausgabetranslation vom Benutzeragenten gefiltert wurde, beispielsweise weil sie als schädlich, ungenau oder unsinnig erkannt wurde.

UnknownError DOMException

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

Im untenstehenden Schnipsel erstellen wir eine neue Translator-Instanz mit create(), dann geben wir die gesamte Eingabenutzungsquote über inputQuota und die Eingabenutzungsquote für die Übersetzung eines bestimmten Text-Strings über measureInputUsage() zurück.

Wir testen dann, ob die individuelle Eingabenutzung für diesen String größer ist als die insgesamt verfügbare Quote. Wenn 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);
  // ...
}

• Verwendung der APIs für Übersetzer und Spracherkennung