Translator: create() 静的メソッド

構文

Translator.create(options)

引数

options

Translator の構成オプションを指定するオブジェクト。取り得る値は以下の通りです。

sourceLanguage

入力テキストの翻訳元言語を指定する文字列。これは、有効な BCP 47 言語タグである必要があります。

targetLanguage

入力テキストの翻訳先言語を指定する文字列。これは、有効な BCP 47 言語タグである必要があります。

monitor 省略可

CreateMonitor 引数を受け取るコールバック関数で、AI モデルのダウンロード進捗状況を監視することができます。

signal 省略可

AbortSignal オブジェクトのインスタンス。これを使用すると、関連付けられた AbortController を通じて create() 操作を中止することができます。具体的な効果は、AbortController.abort() がいつ呼び出されるかによって異なります。

• abort() が create() のプロミスが解決する前に呼び出されると、create() 操作は取り消されます。
• abort() が create() のプロミスが履行された後に呼び出されると、Translator.destroy() を呼び出したのと同じ効果があります。つまり、生成された Translator インスタンスに割り当てられていたリソースが解放され、進行中の Translator メソッド呼び出しやそれ以降の呼び出しはすべて、AbortError を返して失敗します。

返値

Translator オブジェクトインスタンスで履行される Promise です。

例外

InvalidStateError DOMException

このページの Document がまだアクティブでない場合に発生します。

NetworkError DOMException

次の場合に発生します。

• AI モデルのダウンロードに利用できるネットワークに接続できなかった。
• ユーザーが AI モデルのダウンロードを取り消した。

NotAllowedError DOMException

次の場合に発生します。

• このメソッドの使用が translator の Permissions-Policy によってブロックされた。
• ユーザーが何らかの方法で AI モデルのダウンロードをブロックした。
• create() メソッドが、一時的な有効化を通じて呼び出されていない。

NotSupportedError DOMException

次の場合に発生します。

• sourceLanguage または targetLanguage で指定された言語タグが無効であるか、対応していない。これは、指定された sourceLanguage と targetLanguage が同じ場合にも当てはまる。
• 指定された sourceLanguage と targetLanguage の組み合わせに対応する AI モデルが利用できない。

OperationError DOMException

その他の理由で Translator の生成に失敗した場合の汎用例外です。

例

基本的な Translator の生成

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

仕様書

ブラウザーの互換性

関連情報

• 翻訳と言語検出 API の使用