Translator:translateStreaming() 方法

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

Translator 接口的 translateStreaming() 方法将翻译生成为 ReadableStream

语法

js
translateStreaming(input)
translateStreaming(input, options)

参数

input

表示要翻译的文本的字符串。

options 可选

指定 translateStreaming() 操作配置选项的对象。可能的值包括

signal

一个 AbortSignal 对象实例,它允许通过关联的 AbortController 中止 translateStreaming() 操作。

返回值

包含生成翻译的 ReadableStream

异常

InvalidStateError DOMException

如果当前 Document 未激活,则抛出此异常。

QuotaExceededError

如果翻译操作超过了可用的 inputQuota,则抛出此异常。

示例

基本的 translate() 用法

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);

规范

规范
翻译器和语言检测器 API
# dom-translator-translatestreaming

浏览器兼容性

另见