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

View in English Always switch to English

Translator: translateStreaming() メソッド

利用可能性は限定的

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

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

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

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

translateStreaming()Translator インターフェイスのメソッドで、翻訳結果を ReadableStream として生成します。

構文

js
translateStreaming(input)
translateStreaming(input, options)

引数

input

翻訳されるテキストを表す文字列です。

options 省略可

translateStreaming() 操作の構成オプションを指定するオブジェクト。利用可能な値は次の通りです。

signal

AbortSignal オブジェクトのインスタンス。これを使用すると、関連付けられた AbortController を通じて translateStreaming() 操作を中止することができます。

返値

生成された翻訳を出力する ReadableStream です。

例外

AbortError DOMException

Translator がすでに破棄されていた場合(Translator.destroy() が呼び出されていた場合、または作成後にその中止の signal によって中止されていた場合)に発生します。

InvalidStateError DOMException

現在の Document がまだアクティブでない場合に発生します。

QuotaExceededError

翻訳操作が利用できる inputQuota を超えた場合に発生します。

基本的な translate() の使い方

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

const stream = translator.translateStreaming(myTextString);
let translation = "";

for await (const chunk of stream) {
  console.log(chunk);
  translation += chunk;
}

console.log("翻訳完了:", translation);

仕様書

仕様書
Translator and Language Detector APIs
# dom-translator-translatestreaming

ブラウザーの互換性

関連情報