LanguageDetector: create() statische Methode

Syntax

LanguageDetector.create(options)

Parameter

options

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

expectedInputLanguages

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

monitor Optional

Eine Callback-Funktion mit einem CreateMonitor Argument, das die Überwachung des Downloadfortschritts des KI-Modells ermöglicht.

signal Optional

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

• Wenn abort() aufgerufen wird, bevor das create()-Promise gelöst wird, wird die create()-Operation abgebrochen.
• Wenn abort() aufgerufen wird, nachdem das create()-Promise erfüllt wird, hat es die gleiche Wirkung wie das Aufrufen von LanguageDetector.destroy(): Die dem resultierenden LanguageDetector-Instanz zugewiesenen Ressourcen 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 nicht verfügbar war, 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 ist.
• Der Benutzer auf irgendeine Weise den Download des KI-Modells blockiert hat.
• Die create()-Methode nicht durch transient activation aufgerufen wurde.

NotSupportedError DOMException

Wird ausgelöst, wenn:

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

OperationError DOMException

Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des LanguageDetector aus einem anderen Grund fehlgeschlagen ist.

Beispiele

Grundlegende LanguageDetector-Erstellung

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung der Translator und Language Detector APIs