i18n.getMessage()

獲取指定訊息的本地化字串。

有關使用此函式的指南,請參閱國際化頁面。

語法

js
browser.i18n.getMessage(
  messageName,  // string
  substitutions // optional any
)

引數

messageName

string。訊息的名稱,如 messages.json 檔案中指定。如果在 messages.json 中找不到該訊息

  • Firefox 返回 "" 並記錄錯誤。
  • Chrome 返回 "" 且不記錄錯誤。
substitutions 可選

stringstringarray。單個替換字串或替換字串陣列。

在 Chrome 中,如果您提供超過 9 個替換字串,getMessage() 將返回 undefined

返回值

string。針對當前區域設定本地化的訊息。

示例

獲取 "messageContent" 的本地化字串,並替換 target.url

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

這將與包含以下內容的 _locales/en/messages.json 檔案一起使用:

json
{
  "messageContent": {
    "message": "You clicked $URL$.",
    "description": "Tells the user which link they clicked.",
    "placeholders": {
      "url": {
        "content": "$1",
        "example": "https://mdn.club.tw"
      }
    }
  }
}

如果 target.url 是 "https://mdn.club.tw",則在 "en" 區域設定中,訊息的值將是:

"You clicked https://mdn.club.tw."

擴充套件程式示例

瀏覽器相容性

注意:此 API 基於 Chromium 的chrome.i18n API。本文件摘自 Chromium 程式碼中的i18n.json