Translator: translate() method
Translator and Language Detector APIs
Translator and Language Detector APIs
The translate() method of the Translator interface returns a translation of an input string.
Syntax
translate(input)
translate(input, options)
Parameters
input- : A string representing the text to be translated.
options- : An object specifying configuration options for the
translate()operation. Possible values include:signal- : An AbortSignal object instance, which allows the
translate()operation to be aborted via the associated AbortController.
Return value
A Promise that fulfills with a string containing the generated translation.
Exceptions
AbortErrorDOMException- : Thrown if the
Translatorwas previously destroyed (had Translator.destroy() called on it, or was aborted via its abortsignalafter creation). InvalidStateErrorDOMException- : Thrown if the current Document is not active.
- QuotaExceededError
- : Thrown if the translation operation exceeds the available inputQuota.
Examples
Basic translate() usage
const translator = await Translator.create({
sourceLanguage: "en",
targetLanguage: "ja",
});
const translation = await translator.translate(myTextString);
console.log(translation);