MDN self-hosted library · e01.org

Translator: translateStreaming() method

Translator and Language Detector APIs

Translator and Language Detector APIs

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
  • : 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

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