W3cubDocs

/Web APIs

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.

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

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

Specification
Translator and Language Detector APIs> # dom-translator-translate>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`translate`	138 Availability may be subject to geographical restrictions.	No	No	122 Availability may be subject to geographical restrictions.	No	No	No	No	No	No	No	No