語法
js
browser.i18n.getMessage(
messageName, // string
substitutions // optional any
)
引數
messageName-
string。訊息的名稱,如 messages.json 檔案中指定。如果在 messages.json 中找不到該訊息- Firefox 返回 "" 並記錄錯誤。
- Chrome 返回 "" 且不記錄錯誤。
substitutions可選-
string或string的array。單個替換字串或替換字串陣列。在 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。