LanguageDetector: create() static method

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die statische Methode create() der LanguageDetector-Schnittstelle erstellt eine neue LanguageDetector-Instanz zur Erkennung von Sprachen.

Hinweis: Die create()-Methode erfordert eine transiente Aktivierung, das heißt, sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder das Drücken eines Buttons aufgerufen werden.

Syntax

js
LanguageDetector.create(options)

Parameter

options

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

expectedInputLanguages

Ein Array von Strings, das die erwarteten Sprachen des Eingabetextes angibt, was zur Verbesserung der Genauigkeit der Spracherkennung beiträgt. Diese sollten gültige BCP 47-Sprachtags sein (wie in RFC 5646 spezifiziert). Standardmäßig ["en"].

monitor Optional

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

signal Optional

Eine Instanz eines AbortSignal-Objekts, die es erlaubt, den create()-Vorgang über den zugehörigen AbortController abzubrechen.

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:

NotSupportedError DOMException

Wird ausgelöst, wenn:

  • Die in expectedInputLanguages angegebenen Sprachtags ungültig oder nicht unterstützt sind.
  • Kein KI-Modell verfügbar ist, um die angegebenen expectedInputLanguages zu unterstützen.
OperationError DOMException

Allgemeiner Ausnahmefehler, der ausgelöst wird, wenn die Erstellung des LanguageDetector aus einem anderen Grund fehlschlägt.

Beispiele

Grundlegende Erstellung eines LanguageDetector

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

Spezifikationen

Specification
Translator and Language Detector APIs
# dom-languagedetector-create

Browser-Kompatibilität

Siehe auch