Translator: create() statische Methode

Syntax

Translator.create(options)

Parameter

options

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

sourceLanguage

Ein String, der die erwartete Sprache des zu übersetzenden Eingabetextes angibt, und sollte ein gültiges BCP 47 Sprach-Tag sein.

targetLanguage

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

monitor Optional

Eine Callback-Funktion mit einem CreateMonitor Argument, die das Monitoring des Downloadfortschritts des KI-Modells ermöglicht.

signal Optional

Eine Instanz des AbortSignal Objekts, die es ermöglicht, einen create()-Vorgang über den zugehörigen AbortController abzubrechen. Die genaue Wirkung hängt davon ab, wann AbortController.abort() aufgerufen wird:

• Wenn abort() aufgerufen wird, bevor das create()-Versprechen aufgelöst wird, wird der create()-Vorgang abgebrochen.
• Wenn abort() aufgerufen wird, nachdem das create()-Versprechen erfüllt wurde, hat dies die gleiche Wirkung wie ein Aufruf von Translator.destroy(): Die Ressourcen, die der resultierenden Translator-Instanz zugewiesen sind, werden freigegeben, und laufende sowie nachfolgende Translator-Methodenaufrufe werden mit einem AbortError abgelehnt.

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 nicht verfügbar war, um das KI-Modell herunterzuladen.
• Der Benutzer den KI-Modell Download abgebrochen hat.

NotAllowedError DOMException

Wird ausgelöst, wenn:

• Die Nutzung der Methode durch eine translator Permissions-Policy blockiert wird.
• Der Benutzer den Download des KI-Modells auf irgendeine Weise blockiert hat.
• Die create()-Methode nicht durch transiente Aktivierung aufgerufen wurde.

NotSupportedError DOMException

Wird ausgelöst, wenn:

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

OperationError DOMException

Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des Translator aus einem anderen Grund fehlgeschlagen ist.

Beispiele

Grundlegende Translator Erstellung

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwenden der Translator- und Language Detector APIs