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.
- : An AbortSignal object instance, which allows the
- : An object specifying configuration options for the
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).
- : Thrown if the
InvalidStateErrorDOMException- : Thrown if the current Document is not active.
- QuotaExceededError
- : Thrown if the translation operation exceeds the available Translator.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
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
