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
translateStreaming(input)
translateStreaming(input, options)
Parameters
input-
A string representing the text to be translated.
optionsOptional-
An object specifying configuration options for the
translateStreaming()operation. Possible values include:signal-
An
AbortSignalobject instance, which allows thetranslateStreaming()operation to be aborted via the associatedAbortController.
Return value
A ReadableStream containing the generated translation.
Exceptions
InvalidStateErrorDOMException-
Thrown if the current
Documentis 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
| Specification |
|---|
| Translator and Language Detector APIs # dom-translator-translatestreaming |
Browser compatibility
Loading…