Translator: translate() Methode

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die translate() Methode der Translator Schnittstelle gibt eine Übersetzung eines Eingabestrings zurück.

Syntax

js
translate(input)
translate(input, options)

Parameter

input

Ein String, der den zu übersetzenden Text repräsentiert.

options Optional

Ein Objekt, das Konfigurationsoptionen für die translate() Operation spezifiziert. Mögliche Werte sind:

signal

Eine AbortSignal Objektinstanz, die es ermöglicht, die translate() Operation über den zugehörigen AbortController abzubrechen.

Rückgabewert

Ein Promise, das mit einem String erfüllt wird, der die generierte Übersetzung enthält.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn das aktuelle Document nicht aktiv ist.

QuotaExceededError DOMException

Wird ausgelöst, wenn die Übersetzungsoperation das verfügbare inputQuota überschreitet.

Beispiele

Grundlegende Verwendung von translate()

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

const translation = await translator.translate(myTextString);
console.log(translation);

Spezifikationen

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

Browser-Kompatibilität

Siehe auch