LanguageDetector: Methode measureInputUsage()

input

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

options Optional

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

signal

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

Ein Promise, das sich mit einer Zahl erfüllt, welche die Nutzung des inputQuota des gegebenen Eingabetextes angibt.

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

NotAllowedError DOMException

Ausgelöst, wenn die Nutzung der LanguageDetector-API durch eine language-detector Permissions-Policy blockiert ist.

UnknownError DOMException

Ausgelöst, wenn der measureInputUsage()-Aufruf aus einem anderen Grund fehlgeschlagen ist oder aus einem Grund, den der User-Agent nicht offenlegen wollte.

Im untenstehenden Schnipsel erstellen wir eine neue LanguageDetector-Instanz mithilfe von create() und geben dann das gesamte Eingabe-Kontingent über inputQuota und die Eingabe-Kontingentnutzung für die Erkennung der Sprache eines bestimmten Textstrings über measureInputUsage() zurück.

Wir prüfen dann, ob die individuelle Eingabenutzung für diesen String größer ist als das insgesamt verfügbare Kontingent. Falls ja, werfen wir einen entsprechenden Fehler; falls nein, beginnen wir mit der Erkennung der Sprache des Strings über 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