Translator: translate() method
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
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.
optionsOptional-
An object specifying configuration options for the
translate()operation. Possible values include:signal-
An
AbortSignalobject instance, which allows thetranslate()operation to be aborted via the associatedAbortController.
Return value
A Promise that fulfills with a string containing the generated translation.
Exceptions
InvalidStateErrorDOMException-
Thrown if the current
Documentis 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);
Specifications
| Specification |
|---|
| Translator and Language Detector APIs # dom-translator-translate |
Browser compatibility
Loading…