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

js
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 Translator.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

undefined

Basic translate() usage

js
const translator = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "ja",
});

const translation = await translator.translate(myTextString);
console.log(translation);

Specifications

See also