LanguageDetector: `availability()` statische Methode

options

Ein Objekt, das Konfigurationsoptionen für den LanguageDetector spezifiziert. Mögliche Werte sind:

expectedInputLanguages

Ein Array von Zeichenfolgen, das die erwarteten Sprachen des Eingabetextes spezifiziert, dessen Sprache erkannt werden soll. Diese sollten gültige BCP 47 Sprach-Tags sein (wie in RFC 5646 spezifiziert). Standardmäßig ["en"]

Ein Promise, das mit einem enumerierten Wert erfüllt wird, der angibt, ob Unterstützung für eine bestimmte LanguageDetector-Konfiguration verfügbar ist (oder verfügbar sein wird), oder null, wenn die Unterstützung nicht bestimmt werden konnte.

Mögliche Werte sind:

available

Der Browser unterstützt die angegebene Konfiguration und sie kann sofort verwendet werden.

downloadable

Der Browser unterstützt die angegebene Konfiguration, muss jedoch zuerst ein AI-Modell oder einige Feinabstimmungsdaten für das Modell herunterladen.

downloading

Der Browser unterstützt die angegebene Konfiguration, muss den laufenden Download jedoch abschließen, bevor fortgefahren werden kann.

unavailable

Der Browser unterstützt die angegebene Konfiguration nicht.

InvalidStateError DOMException

Wird ausgelöst, wenn das Document der Seite noch nicht aktiv ist.

OperationError DOMException

Wird ausgelöst, wenn die Initialisierung des AI-Modells aus irgendeinem Grund fehlgeschlagen ist.

UnknownError DOMException

Wird ausgelöst, wenn der availability() Aufruf aus einem anderen Grund fehlgeschlagen ist, oder einem Grund, den der Benutzeragent nicht offenlegen wollte.

Wenn die Verwendung der Methode durch eine language-detector Permissions-Policy blockiert wird, lehnt das Promise mit einem Wert von unavailable ab.

Im folgenden Ausschnitt überprüfen wir zunächst die Verfügbarkeit des Modells zur Erkennung einiger Sprachen mit der Methode availability():

• Wenn es unavailable zurückgibt, geben wir eine entsprechende Fehlermeldung in die Konsole aus.
• Wenn es available zurückgibt, erstellen wir einen Sprachdetektor mit der Methode create() und übergeben ihm die expectedInputLanguages. Das erforderliche AI-Modell ist verfügbar, sodass wir es sofort verwenden können.
• Wenn es einen anderen Wert zurückgibt (also downloadable oder downloading), führen wir denselben create()-Methodenaufruf durch, jedoch diesmal mit einem monitor, der den Prozentsatz des heruntergeladenen Modells jedes Mal protokolliert, wenn das downloadprogress Ereignis ausgelöst wird.

async function getDetector(languages) {
  const availability = await LanguageDetector.availability({
    expectedInputLanguages: languages,
  });
  if (availability === "unavailable") {
    console.log(`Detection not supported; try a different set of languages.`);
    return undefined;
  } else if (availability === "available") {
    return await LanguageDetector.create({
      expectedInputLanguages: languages,
    });
  }
  return await LanguageDetector.create({
    expectedInputLanguages: languages,
    monitor(monitor) {
      monitor.addEventListener("downloadprogress", (e) => {
        console.log(`Downloaded ${Math.floor(e.loaded * 100)}%`);
      });
    },
  });
}

const detector = await getDetector(["en-US", "zh"]);

• Verwendung der Translator und Language Detector APIs