Translator: translate() メソッド
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more browser support for this feature? Tell us why.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
translate() は Translator インターフェイスのメソッドで、入力文字列の翻訳結果を返します。
構文
js
translate(input)
translate(input, options)
引数
input-
翻訳されるテキストを表す文字列です。
options省略可-
translate()操作の構成オプションを指定するオブジェクト。利用可能な値は次の通りです。signal-
AbortSignalオブジェクトのインスタンス。これを使用すると、関連付けられたAbortControllerを通じてtranslate()操作を中止することができます。
返値
生成された翻訳が含まれている文字列で履行される Promise です。
例外
AbortErrorDOMException-
Translatorがすでに破棄されていた場合（Translator.destroy()が呼び出されていた場合、または作成後にその中止のsignalによって中止されていた場合）に発生します。 InvalidStateErrorDOMException-
現在の
Documentがまだアクティブでない場合に発生します。 QuotaExceededError-
翻訳操作が利用できる
inputQuotaを超えた場合に発生します。
例
基本的な translate() の使い方
js
const translator = await Translator.create({
sourceLanguage: "en",
targetLanguage: "ja",
});
const translation = await translator.translate(myTextString);
console.log(translation);
仕様書
| 仕様書 |
|---|
| Translator and Language Detector APIs # dom-translator-translate |