LanguageDetector: `create()` statische Methode

Syntax

LanguageDetector.create(options)

Parameter

options

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

expectedInputLanguages

Ein Array von Zeichenfolgen, das die erwarteten Sprachen des Eingabetextes angibt, was die Genauigkeit der Spracherkennung verbessert. Diese sollten gültige BCP 47 Sprachcodes sein. Standardmäßig ["en"].

monitor Optional

Eine Callback-Funktion mit einem CreateMonitor-Argument, die es ermöglicht, den Downloadfortschritt des KI-Modells zu überwachen.

signal Optional

Eine AbortSignal-Objektinstanz, die es ermöglicht, eine create()-Operation über den zugehörigen AbortController abzubrechen. Die genaue Auswirkung hängt davon ab, wann AbortController.abort() aufgerufen wird:

• Wenn abort() vor der Auflösung des create()-Promises aufgerufen wird, wird die create()-Operation abgebrochen.
• Wenn abort() nach der Erfüllung des create()-Promises aufgerufen wird, hat es die gleiche Auswirkung wie der Aufruf von LanguageDetector.destroy(): Die Ressourcen, die der resultierenden LanguageDetector-Instanz zugewiesen wurden, werden freigegeben, und alle laufenden und nachfolgenden LanguageDetector-Methodenaufrufe werden mit einem AbortError abgelehnt.

Rückgabewert

Ein Promise, das mit einer LanguageDetector-Objektinstanz erfüllt wird.

Ausnahmen

InvalidStateError DOMException

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

NetworkError DOMException

Wird ausgelöst, wenn:

• Das Netzwerk war nicht verfügbar, um das KI-Modell herunterzuladen.
• Der Benutzer den Download des KI-Modells abgebrochen hat.

NotAllowedError DOMException

Wird ausgelöst, wenn:

• Die Nutzung der Methode durch eine language-detector Permissions-Policy blockiert wird.
• Der Benutzer den Download des KI-Modells auf irgendeine Weise blockiert hat.
• Die create()-Methode nicht über eine transiente Aktivierung aufgerufen wurde.

NotSupportedError DOMException

Wird ausgelöst, wenn:

• Die in expectedInputLanguages angegebenen Sprachcodes ungültig oder nicht unterstützt sind.
• Kein KI-Modell zur Unterstützung der angegebenen expectedInputLanguages verfügbar ist.

OperationError DOMException

Allgemeiner Zweckausnahmefehler, der ausgelöst wird, wenn die Erstellung des LanguageDetector aus irgendeinem anderen Grund fehlgeschlagen ist.

Beispiele

Grundlegende Erstellung eines LanguageDetector

const detector = await LanguageDetector.create({
  expectedInputLanguages: ["en-US", "zh"],
});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung der Translator und Language Detector APIs