Translator: Methode create()

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 ein gültiger BCP 47 Sprach-Tag sein sollte.

targetLanguage

Ein String, der die Sprache angibt, in die der Eingabetext übersetzt wird. Auch dieser sollte ein gültiger BCP 47 Sprach-Tag sein.

monitor Optional

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

signal Optional

Ein AbortSignal-Objekt-Instanz, die es ermöglicht, eine create()-Operation ü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 die create()-Operation abgebrochen.
• Wenn abort() aufgerufen wird, nachdem das create()-Versprechen erfüllt wurde, hat es denselben Effekt wie ein Aufruf von Translator.destroy(): Die Ressourcen, die der resultierenden Translator-Instanz zugewiesen sind, werden freigegeben, und alle laufenden und nachfolgenden Translator-Methodenaufrufe werden mit einem AbortError abgelehnt.

Rückgabewert

Ein Promise, das mit einer Translator-Objekt-Instanz 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 Download des KI-Modells 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 über eine transiente Aktivierung aufgerufen wurde.

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 für die Unterstützung der angegebenen Kombination von sourceLanguage und targetLanguage verfügbar ist.

OperationError DOMException

Allgemeiner Ausnahmetyp, der ausgelöst wird, wenn die Erstellung des Translator aus irgendeinem anderen Grund fehlgeschlagen ist.

Beispiele

Basis-Erstellung eines Translator

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung der Translator- und Language Detector-APIs