Translator: translateStreaming() method

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

Syntax

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.

QuotaExceededError

Thrown if the translation operation exceeds the available inputQuota.

Examples

Basic translate() usage

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

Browser compatibility

See also

• Using the Translator and Language Detector APIs