このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Translator

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

Want more browser support for this feature? Tell us why.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Translator翻訳と言語検出 API のインターフェイスで、AI モデルの利用可能性を調べる、新しい Translator インスタンスを生成する、それを用いた翻訳を作成するなど、翻訳に関連するすべての機能が含まれています。

インスタンスプロパティ

inputQuota 読取専用

ブラウザーが翻訳を生成するために利用できる入力クォータ。

sourceLanguage 読取専用

翻訳される入力テキストの想定言語。

targetLanguage 読取専用

入力テキストの翻訳先となる言語。

静的メソッド

availability()

指定された Translator 構成に対する AI モデルの利用可否を示す列挙値を返します。

create()

翻訳を生成するための新しい Translator インスタンスを生成します。

インスタンスメソッド

destroy()

呼び出された Translator インスタンスに割り当てられたリソースを解放し、そのインスタンスでのそれ以降の処理を停止します。

measureInputUsage()

指定されたテキスト入力の翻訳処理で、どの程度の入力クォータが使用されるかを報告します。

translate()

入力文字列の翻訳を含む文字列を返します。

translateStreaming()

入力文字列の翻訳結果を ReadableStream として生成します。

完全な例については、翻訳と言語検出 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);

仕様書

仕様書
Translator and Language Detector APIs
# translator

ブラウザーの互換性

関連情報