Translator: measureInputUsage() Methode

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.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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 measureInputUsage() Methode der Translator Schnittstelle gibt an, wie viel Eingabequote für eine Übersetzungsoperation für einen bestimmten Texteingang verwendet werden würde.

Syntax

measureInputUsage(input)
measureInputUsage(input, options)

Parameter

input

Ein String, der den Eingabetext darstellt, für den Sie eine Eingabeverwendungsbewertung wünschen.

options Optional

Ein Objekt, das Konfigurationsoptionen für die measureInputUsage()-Operation spezifiziert. Mögliche Werte sind:

signal: Eine Instanz des AbortSignal Objekts, die es ermöglicht, die measureInputUsage()-Operation über den verbundenen AbortController abzubrechen.

Rückgabewert

Ein Promise, das mit einer Zahl erfüllt wird, die die inputQuota Verwendung des angegebenen Eingabetextes angibt.

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

Ausnahmen

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 Ausgabeübersetzung vom Benutzeragenten gefiltert wurde, beispielsweise weil sie als schädlich, ungenau oder unsinnig erkannt wurde.
UnknownError DOMException: Wird ausgelöst, wenn der measureInputUsage() Aufruf aus einem anderen Grund fehlschlägt oder aus einem Grund, den der Benutzeragent nicht offenlegen wollte.

Im unten stehenden Codebeispiel erstellen wir eine neue Translator Instanz mit create(), geben dann die gesamte Eingabequote über inputQuota und die Eingabequotenutzung 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 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);
  // ...
}