LanguageDetector: availability() statische Methode

options

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

expectedInputLanguages

Ein Array von Zeichenketten, das die erwarteten Sprachen des Eingabetexts angibt, 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 gegebene 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 gegebene Konfiguration und sie kann sofort verwendet werden.

downloadable

Der Browser unterstützt die gegebene Konfiguration, aber es muss zuerst ein KI-Modell oder einige Feinabstimmungsdaten für das Modell heruntergeladen werden.

downloading

Der Browser unterstützt die gegebene Konfiguration, aber ein laufender Download muss abgeschlossen sein, bevor er fortfahren kann.

unavailable

Der Browser unterstützt die gegebene 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 KI-Modells aus irgendeinem Grund fehlgeschlagen ist.

UnknownError DOMException

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

Wenn die Nutzung 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 der Konsole aus.
• Wenn es available zurückgibt, erstellen wir einen Sprachdetektor mit der Methode create(), indem wir die expectedInputLanguages übergeben. Das erforderliche KI-Modell ist verfügbar, also können wir es sofort verwenden.
• Wenn es einen anderen Wert zurückgibt (das heißt, downloadable oder downloading), führen wir denselben Aufruf der Methode create() aus, aber diesmal mit einem monitor, der den Prozentsatz des heruntergeladenen Modells protokolliert, jedes Mal 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 Übersetzer- und Sprachdetektor-APIs