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 eine transiente Aktivierung, d.h. sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder einen Tastendruck aufgerufen werden.
Syntax
Translator.create(options)
Parameter
options-
Ein Objekt, das Konfigurationsoptionen für den
Translatorspezifiziert. Mögliche Werte sind:sourceLanguage-
Ein String, der die erwartete Sprache des zu übersetzenden Eingabetextes angibt, und der ein gültiges BCP 47-Sprach-Tag (wie in RFC 5646 spezifiziert) sein sollte.
targetLanguage-
Ein String, der die Sprache angibt, in die der Eingabetext übersetzt wird, und der ein gültiges BCP 47-Sprach-Tag sein sollte.
monitorOptional-
Eine Callback-Funktion mit einem
CreateMonitor-Argument, das das Monitoring des Download-Fortschritts des KI-Modells ermöglicht. signalOptional-
Eine Instanz eines
AbortSignal-Objekts, die es ermöglicht, diecreate()-Operation über den zugehörigenAbortControllerabzubrechen.
Rückgabewert
Ein Promise, das mit einer Translator-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
translatorPermissions-Policyblockiert wird. - Der Benutzer den Download des KI-Modells auf irgendeine Weise blockiert hat.
- Die
create()-Methode nicht über eine transiente Aktivierung aufgerufen wurde.
- Die Nutzung der Methode durch eine
NotSupportedErrorDOMException-
Wird ausgelöst, wenn:
- Die in
sourceLanguageodertargetLanguageangegebenen Sprach-Tags ungültig oder nicht unterstützt sind. Dies ist der Fall, wenn die angegebenensourceLanguageundtargetLanguagegleich sind. - Kein KI-Modell zur Unterstützung der angegebenen Kombination von
sourceLanguageundtargetLanguageverfügbar ist.
- Die in
OperationErrorDOMException-
Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des
Translatoraus einem anderen Grund fehlschlug.
Beispiele
Grundlegende Translator-Erstellung
const translator = await Translator.create({
sourceLanguage: "en",
targetLanguage: "ja",
});
Spezifikationen
| Specification |
|---|
| Translator and Language Detector APIs # dom-translator-create |