i18n.getMessage()

構文

browser.i18n.getMessage(
  messageName, // 文字列
  substitutions, // 任意
);

引数

messageName

文字列。messages.json で指定されたメッセージ名です。messages.json 内にメッセージを見つけられない場合は:

• Firefox は "" を返し、エラーログを出力します。
• Chrome は "" を返し、エラーログを出力しません。

substitutions省略可

文字列 または 文字列 の 配列。単一の置換文字列、または置換文字列の配列です。 Chrome では、9 個より多くの置換文字列を与えると、getMessage() は undefined を返します。

戻り値

文字列。現在のロケール向けにローカライズされたメッセージ。

ブラウザーの互換性

例

target.url を置換文字列として渡し、"messageContent" のローカライズされた文字列を取得します:

var message = browser.i18n.getMessage("messageContent", target.url);
console.log(message);

これは、_locales/en/messages.json ファイルに含まれた次の内容で動作します:

{
  "messageContent": {
    "message": "You clicked $URL$.",
    "description": "Tells the user which link they clicked.",
    "placeholders": {
      "url": {
        "content": "$1",
        "example": "https://big.rakal.top"
      }
    }
  }
}

target.url が "https://big.rakal.top" である場合、"en" ロケールでのメッセージの値は次のようになります:

"You clicked https://big.rakal.top."

Example extensions

• menu-accesskey-visible
• menu-demo
• notify-link-clicks-i18n