i18n.getMessage()

获取指定消息的本地化字符串。

请参阅国际化页面,了解有关使用此函数的指南。

语法

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

参数

messageName

string。消息的名称,如 messages.json 文件中指定。如果在 messages.json 中找不到消息

  • Firefox 将返回 "" 并记录错误。
  • Chrome 将返回 "" 且不记录错误。
substitutions 可选

stringstring 数组。单个替换字符串或替换字符串数组。

在 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