翻譯器: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

瀏覽器相容性

另見