Translator: translate() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

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

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

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							server
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS	Deno	Node.js
`translate()` instance method Experimental	Chrome – Full support Chrome 138 (Release date: 2025-06-24) footnote footnote Availability may be subject to geographical restrictions.	Edge – No support Edge footnote No support	Firefox – No support Firefox footnote No support	Opera – Full support Opera 122 (Release date: 2025-09-11) footnote footnote Availability may be subject to geographical restrictions.	Safari – No support Safari footnote No support	Chrome Android – No support Chrome Android footnote No support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – No support Opera Android footnote No support	Safari on iOS – No support Safari on iOS footnote No support	Samsung Internet – No support Samsung Internet footnote No support	WebView Android – No support WebView Android footnote No support	WebView on iOS – No support WebView on iOS footnote No support	Deno – No support Deno footnote No support	Node.js – No support Node.js footnote No support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: Experimental. Expect behavior to change in the future.
: See implementation notes.

Translator: translate() method

Legend