Translator: translate() Methode
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 Methode translate() des Translator-Interfaces gibt eine Übersetzung eines Eingabestrings zurück.
Syntax
translate(input)
translate(input, options)
Parameter
input-
Ein String, der den zu übersetzenden Text darstellt.
optionsOptional-
Ein Objekt, das Konfigurationsoptionen für die
translate()-Operation angibt. Mögliche Werte sind:signal-
Eine Instanz des
AbortSignal-Objekts, welche dietranslate()-Operation über den zugehörigenAbortControllerabgebrochen werden kann.
Rückgabewert
Ein Promise, das mit einem String erfüllt wird, der die generierte Übersetzung enthält.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn das aktuelle
Documentnicht aktiv ist. QuotaExceededError-
Wird ausgelöst, wenn die Übersetzungsoperation das verfügbare
inputQuotaüberschreitet.
Beispiele
Grundlegende Verwendung von translate()
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
Loading…