Translator: translateStreaming() 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 translateStreaming() method of the Translator interface generates a 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

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

undefined

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

See also