LanguageDetector: measureInputUsage() Methode

input

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

options Optional

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

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 Texteingangs spezifiziert.

Diese Zahl ist implementierungsabhängig; wenn sie kleiner als die inputQuota ist, kann die Sprache des Strings erkannt werden.

NotAllowedError DOMException

Wird ausgelöst, wenn die Nutzung der LanguageDetector-API durch eine language-detector Permissions-Policy blockiert wird.

UnknownError DOMException

Wird ausgelöst, wenn der measureInputUsage()-Aufruf aus anderen Gründen, oder aus einem Grund, den der Benutzeragent nicht offenlegen möchte, fehlschlägt.

Im folgenden Beispiel erstellen wir eine neue LanguageDetector-Instanz mit create(), dann geben wir die Gesamtquote der Eingabe über inputQuota zurück und die Nutzung der Eingabequote für die Erkennung der Sprache eines bestimmten Textstrings über measureInputUsage().

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 Erkennung der Sprache des Strings unter Verwendung von detect().

const detector = await LanguageDetector.create({
  expectedInputLanguages: ["en-US", "zh"],
});

const totalInputQuota = detector.inputQuota;
const inputUsage = await detector.measureInputUsage(myTextString);

if (inputUsage > totalInputQuota) {
  throw new Error("Insufficient quota to detect languages.");
} else {
  console.log("Quota available to detect languages.");
  const results = await detector.detect(myTextString);
  // ...
}

• Verwendung der Translator- und Language Detector-APIs