LanguageDetector: 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 des LanguageDetector Interfaces gibt an, wie viel der Eingabequote durch eine Sprachenerkennungsoperation für einen gegebenen Texteingang genutzt würde.

Syntax

measureInputUsage(input)
measureInputUsage(input, options)

Parameter

input

Ein String, der den Eingabetext darstellt, für den Sie eine Messung des Eingabeverbrauchs 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 zugehörigen AbortController abzubrechen.

Rückgabewert

Ein Promise, das mit einer Zahl erfüllt wird, die die inputQuota-Nutzung des gegebenen Eingangstextes angibt.

Diese Zahl ist von der Implementierung abhä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 ist.
UnknownError DOMException: Wird ausgelöst, wenn der measureInputUsage() Aufruf aus irgendeinem anderen Grund fehlschlug oder einem Grund, den der Benutzeragent nicht offenlegen wollte.

Im unten stehenden Beispiel erstellen wir eine neue LanguageDetector-Instanz mithilfe von create(), dann geben wir die gesamte Eingabequote über inputQuota und die Eingabequotennutzung für die Erkennung der Sprache eines bestimmten Textstrings über measureInputUsage() zurück.

Wir testen dann, ob die individuelle Eingabenutzung für diesen String größer als die insgesamt verfügbare Quote ist. Falls ja, werfen wir einen entsprechenden Fehler; wenn nicht, beginnen wir mit der Erkennung der Sprache des Strings mithilfe 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);
  // ...
}