Translator: translate() method

Limited availabilitySecure context

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 Optional
  • : 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

• AbortError DOMException
  • : Thrown if the Translator was previously destroyed (had destroy() called on it, or was aborted via its abort signal after creation).
• InvalidStateError DOMException
  • : 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);

Specifications

Browser compatibility

See also

• Using the Translator and Language Detector APIs