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, um Sprachen zu erkennen.
Hinweis:
Die create()-Methode erfordert flüchtige Aktivierung, d.h. sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder Tastendruck aufgerufen werden.
Syntax
LanguageDetector.create(options)
Parameter
options-
Ein Objekt, das Konfigurationsoptionen für den
LanguageDetectorangibt. Mögliche Werte sind:expectedInputLanguages-
Ein Array von Zeichenfolgen, das die erwarteten Sprachen des Eingabetextes angibt, um die Genauigkeit der Spracherkennung zu verbessern. Diese sollten gültige BCP 47 Sprach-Tags sein. Standardmäßig
["en"]. monitorOptional-
Eine Callback-Funktion mit einem
CreateMonitor-Argument, die das Überwachen des Downloadfortschritts des KI-Modells ermöglicht. signalOptional-
Eine
AbortSignal-Objektinstanz, die es erlaubt, diecreate()-Operation über den zugehörigenAbortControllerabzubrechen.
Rückgabewert
Ein Promise, das mit einer LanguageDetector-Objektinstanz erfüllt wird.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn das
Documentder Seite noch nicht aktiv ist. NetworkErrorDOMException-
Wird ausgelöst, wenn:
- Das Netzwerk nicht verfügbar war, um das KI-Modell herunterzuladen.
- Der Benutzer den Download des KI-Modells abgebrochen hat.
NotAllowedErrorDOMException-
Wird ausgelöst, wenn:
- Die Nutzung der Methode durch eine
language-detectorPermissions-Policyblockiert wird. - Der Benutzer den Download des KI-Modells irgendwie blockiert hat.
- Die
create()-Methode nicht durch flüchtige Aktivierung aufgerufen wurde.
- Die Nutzung der Methode durch eine
NotSupportedErrorDOMException-
Wird ausgelöst, wenn:
- Die in
expectedInputLanguagesangegebenen Sprach-Tags ungültig oder nicht unterstützt sind. - Kein KI-Modell verfügbar ist, um die angegebenen
expectedInputLanguageszu unterstützen.
- Die in
OperationErrorDOMException-
Allgemeiner Ausnahmefehler, der ausgelöst wird, wenn die Erstellung des
LanguageDetectoraus irgendeinem anderen Grund fehlgeschlagen ist.
Beispiele
Grundlegende LanguageDetector-Erstellung
const detector = await LanguageDetector.create({
expectedInputLanguages: ["en-US", "zh"],
});
Spezifikationen
| Specification |
|---|
| Translator and Language Detector APIs # dom-languagedetector-create |
Browser-Kompatibilität
Loading…