翻译器:translate() 方法

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

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

Translator 接口的 translate() 方法返回输入字符串的翻译。

语法

js
translate(input)
translate(input, options)

参数

input

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

options 可选

一个指定 translate() 操作配置选项的对象。可能的值包括:

signal

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

返回值

一个 Promise,它会以包含生成翻译的字符串来 fulfillment。

异常

InvalidStateError DOMException

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

QuotaExceededError

如果在翻译操作中超出了可用的 inputQuota,则抛出此错误。

示例

基本的 translate() 用法

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

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

规范

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

浏览器兼容性

另见