Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

`translate()` Methode des Übersetzers

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 translate() Methode des Translator Interfaces gibt eine Übersetzung eines Eingabestrings zurück.

Syntax

js
translate(input)
translate(input, options)

Parameter

input

Ein String, der den zu übersetzenden Text darstellt.

options Optional

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

signal

Eine Instanz des AbortSignal Objekts, 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 Nutzung 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