i18n.getMessage()
获取指定消息的本地化字符串。
请参阅国际化页面,了解有关使用此函数的指南。
语法
js
browser.i18n.getMessage(
messageName, // string
substitutions // optional any
)
参数
messageName
-
string
。消息的名称,如 messages.json 文件中指定。如果在 messages.json 中找不到消息- Firefox 将返回 "" 并记录错误。
- Chrome 将返回 "" 且不记录错误。
substitutions
可选-
string
或string
数组。单个替换字符串或替换字符串数组。在 Chrome 中,如果您提供超过 9 个替换字符串,
getMessage()
将返回undefined
。
返回值
string
。当前区域设置的本地化消息。
浏览器兼容性
BCD 表仅在浏览器中加载
示例
获取"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.org.cn"
}
}
}
}
如果target.url
为"https://mdn.org.cn",则在“en”区域设置中,消息的值将为
"You clicked https://mdn.org.cn."
扩展示例
注意:此 API 基于 Chromium 的chrome.i18n
API。本文档源自 Chromium 代码中的i18n.json
。