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

瀏覽器相容性

另見