`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 zum Übersetzen von Text verwendet werden kann.

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

js
Translator.create(options)

Parameter

options

Ein Objekt, das Konfigurationsoptionen für den Translator festlegt. Mögliche Werte umfassen:

sourceLanguage

Ein String, der die erwartete Sprache des zu übersetzenden Eingangstextes angibt. Es sollte ein gültiges BCP 47-Sprach-Tag sein (wie in RFC 5646 angegeben).

targetLanguage

Ein String, der die Sprache angibt, in die der Eingangstext übersetzt wird. Es sollte ein gültiges BCP 47-Sprach-Tag sein.

monitor Optional

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

signal Optional

Eine AbortSignal-Objektinstanz, die es ermöglicht, 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 ausgelöst, wenn das Document der Seite noch nicht aktiv ist.

NetworkError DOMException

Wird ausgelöst, wenn:

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

Wird ausgelöst, wenn:

NotSupportedError DOMException

Wird ausgelöst, wenn:

  • Die in sourceLanguage oder targetLanguage angegebenen Sprach-Tags ungültig oder nicht unterstützt sind. Dies ist der Fall, wenn die angegebenen sourceLanguage und targetLanguage identisch sind.
  • Kein KI-Modell zur Unterstützung der angegebenen Kombination aus sourceLanguage und targetLanguage verfügbar ist.
OperationError DOMException

Allgemeiner Ausnahmefall, der ausgelöst wird, wenn die Erstellung des Translator aus irgendeinem anderen Grund fehlschlägt.

Beispiele

Grundlegende Erstellung eines Translator

js
const translator = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "ja",
});

Spezifikationen

Specification
Translator and Language Detector APIs
# dom-translator-create

Browser-Kompatibilität

Siehe auch