Translator: 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 Translator-Schnittstelle erstellt eine neue Translator-Instanz, die zum Übersetzen von Text verwendet werden kann.
Hinweis:
Die create()-Methode erfordert transiente Aktivierung, d.h. sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder Tastendruck aufgerufen werden.
Syntax
Translator.create(options)
Parameter
options-
Ein Objekt, das Konfigurationsoptionen für den
Translatorangibt. Mögliche Werte sind:sourceLanguage-
Ein String, der die erwartete Sprache des zu übersetzenden Eingabetextes angibt und ein gültiger BCP 47 Sprach-Tag (wie im RFC 5646 spezifiziert) sein sollte.
targetLanguage-
Ein String, der die Sprache angibt, in die der Eingabetext übersetzt wird, und ein gültiger BCP 47 Sprach-Tag sein sollte.
monitorOptional-
Eine Callback-Funktion mit einem
CreateMonitor-Argument, das die Überwachung des Download-Fortschritts des KI-Modells ermöglicht. signalOptional-
Ein
AbortSignal-Objekt, das es ermöglicht, dencreate()-Vorgang über den zugehörigenAbortControllerabzubrechen.
Rückgabewert
Ein Promise, das mit einer Translator-Objektinstanz erfüllt wird.
Ausnahmen
InvalidStateErrorDOMException-
Ausgelöst, wenn das
Documentder Seite noch nicht aktiv ist. NetworkErrorDOMException-
Ausgelöst, wenn:
- Das Netzwerk nicht verfügbar war, um das KI-Modell herunterzuladen.
- Der Benutzer den Download des KI-Modells abgebrochen hat.
NotAllowedErrorDOMException-
Ausgelöst, wenn:
- Die Verwendung der Methode durch eine
translatorPermissions-Policyblockiert ist. - Der Benutzer hat den Download des KI-Modells auf irgendeine Weise blockiert.
- Die
create()-Methode wurde nicht über transiente Aktivierung aufgerufen.
- Die Verwendung der Methode durch eine
NotSupportedErrorDOMException-
Ausgelöst, wenn:
- Die in
sourceLanguageodertargetLanguageangegebenen Sprache-Tags ungültig oder nicht unterstützt sind. Dies ist der Fall, wenn die angegebenensourceLanguageundtargetLanguageidentisch sind. - Kein KI-Modell verfügbar ist, um die angegebene Kombination von
sourceLanguageundtargetLanguagezu unterstützen.
- Die in
OperationErrorDOMException-
Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des
Translatorsaus einem anderen Grund fehlgeschlagen ist.
Beispiele
Grundlegende Translator-Erstellung
const translator = await Translator.create({
sourceLanguage: "en",
targetLanguage: "ja",
});
Spezifikationen
| Specification |
|---|
| Translator and Language Detector APIs # dom-translator-create |