LanguageDetector: measureInputUsage() Methode

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 LanguageDetector-Schnittstelle gibt an, wie viel Eingabequote durch einen Spracherkennungsvorgang für einen bestimmten Texteingang verwendet wird.

Syntax

measureInputUsage(input)
measureInputUsage(input, options)

Parameter

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.

Rückgabewert

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.

Ausnahmen

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);
  // ...
}