LanguageDetector: create() statische Methode

Syntax

LanguageDetector.create(options)

Parameter

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 angibt, was die Genauigkeit der Spracherkennung verbessert. Diese sollten gültige BCP 47 Sprach-Tags sein. Standardmäßig ["en"].

monitor Optional

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

signal Optional

Ein AbortSignal Objektinstanz, die es erlaubt, einen create()-Vorgang ü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() Versprechen aufgelöst wird, wird der create()-Vorgang abgebrochen.
• Wenn abort() aufgerufen wird, nachdem das create() Versprechen erfüllt wurde, hat es die gleiche Wirkung wie der Aufruf von LanguageDetector.destroy(): Die Ressourcen, die der resultierenden LanguageDetector Instanz zugewiesen sind, werden freigegeben, und alle laufenden und folgenden LanguageDetector Methodenaufrufe werden mit einem AbortError abgelehnt.

Rückgabewert

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

Ausnahmen

InvalidStateError DOMException

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

NetworkError DOMException

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

Ausgelöst, wenn:

• Die Nutzung der Methode von einer 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

Ausgelöst, wenn:

• Die in expectedInputLanguages angegebenen Sprach-Tags 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 Übersetzer- und Spracherkennungsschnittstellen