LanguageDetector: create() statische Methode

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

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

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

Hinweis: Die create() Methode erfordert transiente Aktivierung, das heißt, sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder Tastendruck 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 hilft, die Genauigkeit der Spracherkennung zu verbessern. Diese sollten gültige BCP 47 Sprach-Tags (wie in RFC 5646 spezifiziert) sein. Standardmäßig ["en"].

monitor Optional

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

signal Optional

Ein AbortSignal Objekt, das die create() Operation über den zugehörigen AbortController abbrechen lässt.

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:

NotSupportedError DOMException

Ausgelöst, wenn:

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

Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des LanguageDetector aus irgendeinem anderen Grund fehlschlägt.

Beispiele

Grundlegende LanguageDetector Erstellung

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