Translator: create() statische Methode

Syntax

Translator.create(options)

Parameter

options

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

sourceLanguage

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

targetLanguage

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

monitor Optional

Eine Callback-Funktion mit einem CreateMonitor Argument, das die Überwachung des Downloadfortschritts des AI-Modells ermöglicht.

signal Optional

Eine AbortSignal Objektinstanz, 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 erfüllt wird, wird die create() Operation abgebrochen.
• Wenn abort() aufgerufen wird, nachdem das create() Versprechen erfüllt wurde, hat es die gleiche Wirkung wie ein Aufruf von Translator.destroy(): Die für die resultierende Translator Instanz zugewiesenen Ressourcen werden freigegeben, und alle laufenden und nachfolgenden Translator Methodenaufrufe werden mit einem AbortError abgelehnt.

Rückgabewert

Ein Promise, der 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 AI-Modell herunterzuladen.
• Der Benutzer den Download des AI-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 AI-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 oder nicht unterstützt sind. Dies ist der Fall, wenn die angegebene sourceLanguage und targetLanguage gleich sind.
• Kein AI-Modell zur Unterstützung der angegebenen Kombination von sourceLanguage und targetLanguage verfügbar ist.

OperationError DOMException

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

Beispiele

Grundlegende Translator Erstellung

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Verwendung der Translator und Language Detector APIs