带有 declarativeContent.RequestContentScript 的 Chrome 扩展

Question

我正在尝试制作一个 Chrome 扩展程序，它将监控 GMail 并在用户开始写消息时执行某些操作。在研究了一些示例和文档之后，我发现我应该使用 declarativeContent 来做，它会对页面更改做出反应。

这就是我现在所做的。

manifest.json：

{
  "manifest_version": 2,
  "name": "Gmail helper",
  "version": "0.1",
  "permissions": [ "declarativeContent" ],
  "background": {
    "scripts": ["background.js"],
    "persistent": false
  }
}

background.js：

chrome.runtime.onInstalled.addListener (function (details) {
  chrome.declarativeContent.onPageChanged.removeRules (undefined, function () {
    chrome.declarativeContent.onPageChanged.addRules ([{
      conditions: [
        new chrome.declarativeContent.PageStateMatcher({
          pageUrl: { hostEquals: 'mail.google.com', schemes: ['https'] },
          css: ["div"]
//          css: ["div[aria-label='Message Body']"]
        })
      ],
      actions: [ new chrome.declarativeContent.RequestContentScript({js: ["content.js"]}) ]
    }]);
  });
});

content.js：

alert ("Test");

我的计划是声明一个内容脚本，该脚本将在 GMail 中的页面更改时触发。我添加了一个声明性规则，其中定义了 pageURL、css 和操作。根据我的理解 content.js 应该在 pageUrl 和 css 内容匹配时执行。但是，content.js 没有被执行。

我做错了什么？

谢谢。

Answer 1

在站点上运行内容脚本需要站点的权限，这在 declarativeContent API 的文档中没有明确说明，但可以推断为缺少“此操作可以在没有主机权限的情况下使用”注释，即出现在其他动作中。 declarativeContent API 的目的是在没有任何权限确认警告的情况下从 WebStore 安装扩展程序，因此该 API 自然无法授予您对 mail.google.com 的访问权限，除非您在清单中明确添加它：

"permissions": ["declarativeContent", "https://mail.google.com/"]

Answer 2

从您的任务描述看来，您不需要 declarativeContent。

如果 GMail 页面打开，您需要向页面添加内容脚本，并且在内容脚本中您需要向消息编辑器 DOM 元素（或您需要跟踪的任何其他元素）添加侦听器。

假设您知道如何做第二个，要将内容脚本添加到 GMail 页面，您需要将以下内容添加到清单中：

  "content_scripts": [
    {
      "matches": [
        "https://mail.google.com/*"
      ],
      "js": ["content.js"]
    }

在这种情况下，您也不需要后台脚本和权限。

注意： 尽管您不需要指定权限，但您的扩展程序需要向用户询问权限。 在安装过程中，Chrome 会警告用户您的扩展程序将有权访问页面上的所有用户数据，以便用户在不同意的情况下取消安装。