LanguageDetector: `create()` statische Methode

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 create() statische Methode der LanguageDetector-Schnittstelle erstellt eine neue LanguageDetector-Instanz zur Erkennung von Sprachen.

Hinweis: Die create()-Methode erfordert transienten Aktivierung, das heißt, sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder das Drücken einer Taste 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 Zeichenfolgen, das die erwarteten Sprachen des Eingabetexts angibt, was hilft, die Genauigkeit der Spracherkennung zu verbessern. Diese sollten gültige BCP 47-Sprachtags (wie in RFC 5646 angegeben) sein. Standardwert ist ["en"].

monitor Optional

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

signal Optional

Eine Instanz des AbortSignal-Objekts, die es ermöglicht, 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 Sprachcodes ungültig oder nicht unterstützt sind.
  • Kein KI-Modell zur Unterstützung der angegebenen expectedInputLanguages verfügbar ist.
OperationError DOMException

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

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