Translator: translateStreaming() method

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The translateStreaming() method of the Translator interface generates a new translation as a ReadableStream.

Syntax

js
translateStreaming(input)
translateStreaming(input, options)

Parameters

input

A string representing the text to be translated.

options Optional

An object specifying configuration options for the translateStreaming() operation. Possible values include:

signal

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

Return value

A ReadableStream containing the generated translation.

Exceptions

InvalidStateError DOMException

Thrown if the current Document is not active.

Examples

Basic translate() usage

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

const stream = translator.translateStreaming((myTextString);
let translation = "";

for await (const chunk of stream) {
  console.log(chunk);
  translation += chunk;
}

console.log("Complete translation:", translation);

Specifications

No specification found

No specification data found for api.Translator.translateStreaming.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

See also