Translator

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

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

Translator 接口是 Translator and Language Detector APIs 的一部分,其中包含所有相关的翻译功能,包括检查 AI 模型可用性、创建新的 Translator 实例、使用它进行翻译等。

实例属性

inputQuota 只读 实验性

浏览器可用于生成翻译的输入配额。

sourceLanguage 只读 实验性

待翻译输入的预期语言。

targetLanguage 只读 实验性

输入文本将要被翻译成的目标语言。

静态方法

availability() 实验性

返回一个指示给定 Translator 配置的 AI 模型可用性的枚举值。

create() 实验性

创建一个新的 Translator 实例,用于生成翻译。

实例方法

destroy() 实验性

销毁调用此方法的 Translator 实例。

measureInputUsage() 实验性

报告给定文本输入的一次翻译操作将使用多少输入配额。

translate() 实验性

返回一个包含输入字符串翻译的字符串。

translateStreaming() 实验性

将输入字符串的翻译生成为一个 ReadableStream

示例

有关完整示例,请参阅 使用 Translator 和 Language Detector API

创建 Translator 实例

js
const translator = await Translator.create({
  sourceLanguage: "en",
  targetLanguage: "ja",
});

生成翻译

js
const translation = await translator.translate(myTextString);
console.log(translation);

生成翻译流

js
const stream = translator.translateStreaming(myTextString);
let translation = "";

for await (const chunk of stream) {
  translation += chunk;
}

console.log("Stream complete");
console.log(translation);

规范

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

浏览器兼容性

另见