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 translate() Methode 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 spezifiziert. Mögliche Werte sind:signal-
Eine Instanz des
AbortSignalObjekts, die es ermöglicht, dietranslate()-Operation über den zugehörigenAbortControllerabzubrechen.
Rückgabewert
Ein Promise, das mit einem String erfüllt wird, der die generierte Übersetzung enthält.
Ausnahmen
AbortErrorDOMException-
Wird ausgelöst, wenn der
Translatorzuvor zerstört wurde (entweder durch Aufruf vonTranslator.destroy()oder durch Abbruch über das zugehörigesignalnach Erzeugung). InvalidStateErrorDOMException-
Wird ausgelöst, wenn das aktuelle
Documentnicht aktiv ist. QuotaExceededError-
Wird ausgelöst, wenn die Übersetzungsoperation das verfügbare
inputQuotaübersteigt.
Beispiele
Grundlegende Nutzung 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…