Translator：create() 静态方法
Translator 接口的 create() 静态方法创建一个新的 Translator 实例，该实例可用于翻译文本。
注意： create() 方法需要 瞬时激活，也就是说，它必须在响应用户操作（如鼠标点击或按钮按下）时调用。
语法
js
Translator.create(options)
参数
options-
一个指定
Translator配置选项的对象。可能的值包括sourceLanguage-
一个指定待翻译输入文本的预期语言的字符串，该字符串应为一个有效的 BCP 47 语言标签。
targetLanguage-
一个指定输入文本将翻译成的语言的字符串，该字符串应为一个有效的 BCP 47 语言标签。
monitor可选-
一个带有
CreateMonitor参数的回调函数，该函数允许监控 AI 模型的下载进度。 signal可选-
一个
AbortSignal对象实例，允许通过关联的AbortController中止create()操作。
返回值
一个 Promise，该 Promise 会以一个 Translator 对象实例 fulfilled。
异常
InvalidStateErrorDOMException-
如果页面的
Document尚未激活，则抛出此异常。 NetworkErrorDOMException-
在以下情况下抛出
- 网络不可用，无法下载 AI 模型。
- 用户已取消 AI 模型下载。
NotAllowedErrorDOMException-
在以下情况下抛出
- 该方法的使用被
translatorPermissions-Policy阻止。 - 用户以某种方式阻止了 AI 模型下载。
create()方法不是通过 临时激活 调用。
- 该方法的使用被
NotSupportedErrorDOMException-
在以下情况下抛出
- 在
sourceLanguage或targetLanguage中指定的语言标签无效或不受支持。如果指定的sourceLanguage和targetLanguage相同，则会出现这种情况。 - 不支持指定的
sourceLanguage和targetLanguage组合的 AI 模型不可用。
- 在
OperationErrorDOMException-
通用异常，在
Translator创建因任何其他原因失败时抛出。
示例
基本的 Translator 创建
js
const translator = await Translator.create({
sourceLanguage: "en",
targetLanguage: "ja",
});
规范
| 规范 |
|---|
| 翻译器和语言检测器 API # dom-translator-create |
浏览器兼容性
加载中…