Translator: `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 Translator-Schnittstelle erstellt eine neue Translator-Instanz, die verwendet werden kann, um Text zu übersetzen.

Hinweis: Die create()-Methode erfordert eine transiente Aktivierung, das heißt, 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 Translator spezifiziert. Mögliche Werte sind:

sourceLanguage: Eine Zeichenkette, die die erwartete Sprache des zu übersetzenden Eingangstextes angibt und ein gültiges BCP 47-Sprachtag sein sollte.
targetLanguage: Eine Zeichenkette, die die Sprache angibt, in die der Eingangstext übersetzt wird und ebenfalls ein gültiges BCP 47-Sprachtag sein sollte.
monitor Optional: Eine Callback-Funktion mit einem CreateMonitor-Argument, das die Überwachung des Downloadfortschritts des KI-Modells ermöglicht.
signal Optional: Eine AbortSignal-Objektinstanz, die es erlaubt, die create()-Operation über den zugehörigen AbortController abzubrechen.

Rückgabewert

Ein Promise, das mit einer Translator-Objektinstanz erfüllt wird.

Ausnahmen

InvalidStateError DOMException

Wird geworfen, wenn das Document der Seite noch nicht aktiv ist.

NetworkError DOMException

Wird geworfen, wenn:

Das Netzwerk nicht verfügbar war, um das KI-Modell herunterzuladen.
Der Benutzer den Download des KI-Modells abgebrochen hat.

NotAllowedError DOMException

Wird geworfen, wenn:

Die Verwendung der Methode durch eine translator Permissions-Policy blockiert ist.
Der Benutzer den Download des KI-Modells in irgendeiner Weise blockiert hat.
Die create()-Methode nicht durch eine transiente Aktivierung aufgerufen wurde.

NotSupportedError DOMException

Wird geworfen, wenn:

Die in sourceLanguage oder targetLanguage angegebenen Sprachtags ungültig oder nicht unterstützt sind. Dies ist der Fall, wenn sourceLanguage und targetLanguage gleich sind.
Ein KI-Modell zur Unterstützung der angegebenen Kombination von sourceLanguage und targetLanguage nicht verfügbar ist.

OperationError DOMException

Allgemeiner Ausnahmefehler, wenn die Erstellung des Translator aus irgendeinem 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

Browser-Kompatibilität

Siehe auch

Verwendung der Translator- und Language Detector-APIs

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden