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
AbortErrorDOMException- : Thrown if the
Translatorwas previously destroyed (had Translator.destroy() called on it, or was aborted via its abortsignalafter creation). InvalidStateErrorDOMException- : 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);