Translator: create() static method

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The create() static method of the Translator interface creates a new Translator instance that can be used to translate text.

Note: The create() method requires transient activation, that is, it must be invoked in response to a user action such as a mouse click or button press.

Syntax

js
Translator.create(options)

Parameters

options

An object specifying configuration options for the Translator. Possible values include:

sourceLanguage

A string specifying the expected language of the input text to be translated, which should be a valid BCP 47 language tag (as specified in RFC 5646).

targetLanguage

A string specifying the language that the input text will be translated into, which should be valid BCP 47 language tag.

monitor Optional

A callback function with a CreateMonitor argument that enables monitoring download progress of the AI model.

signal Optional

An AbortSignal object instance, which allows the create() operation to be aborted via the associated AbortController.

Return value

A Promise that fulfills with a Translator object instance.

Exceptions

InvalidStateError DOMException

Thrown if the page's Document is not yet active.

NetworkError DOMException

Thrown if:

  • The network was not available to download the AI model.
  • The user has cancelled the AI model download.
NotAllowedError DOMException

Thrown if:

NotSupportedError DOMException

Thrown if:

  • The language tags specified in sourceLanguage or targetLanguage are invalid, or not supported. This is the case if the specified sourceLanguage and targetLanguage are the same.
  • An AI model to support the specified combination of sourceLanguage and targetLanguage is not available.
OperationError DOMException

General-purpose exception thrown if Translator creation failed for any other reason.

Examples

Basic Translator creation

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

Specifications

Specification
Translator and Language Detector APIs
# dom-translator-create

Browser compatibility

See also