CustomEvent.detail “污染”？

Question

我正在开发一个 Chrome 扩展程序来增加网站的便利性。
我可以访问页面的 DOM，但我还需要与该页面上的“第一方”JS 进行交互，而我的扩展程序无法做到这一点。

我可以在页面中注入任意标签（最值得注意的是<script>标签），但由于转义字符串如

{
    html: '<div onclick="doSomething(this, \'someName\')"></div>'
}

真的很痛苦，我希望将注入的代码保持在绝对最低限度。

我尝试将事件侦听器注入页面以从页面中获取 JS 变量，但遇到了问题。
似乎如果 CustomEvent 从扩展程序传递到网站或返回，并且如果 CustomEvent.detail 在某处包含某些类型的对象（至少是函数和错误），则整个 CustomEvent.detail 将被清除，即设置为空值。

示例

脚本（扩展名.js）：

(function()
{
    var script = document.createElement('script');
    script.innerHTML = [
"window.addEventListener('xyz', function(ev)",
"    {                                      ",
"        console.log('after dispatch:');    ",
"        console.log(ev.detail);            ",
"    });                                    ",
    ].join('\n');
    document.head.appendChild(script);
    // JSON-serializable data
    var e = new CustomEvent('xyz', { detail: { x: 42, name: 'Schroedinger' } });
    console.log('before dispatch:')
    console.log(e.detail);
    window.dispatchEvent(e);
    // non-JSON-serializable data
    var detail = { x: 42, name: 'Schroedinger' };
    detail.detail = detail; // Create circular reference
    e = new CustomEvent('xyz', { detail: detail });
    console.log('before dispatch:')
    console.log(e.detail);
    window.dispatchEvent(e);
    // data with function
    e = new CustomEvent('xyz', { detail: { x: 42, name: 'Schroedinger', func: function(){} } });
    console.log('before dispatch:');
    console.log(e.detail);
    window.dispatchEvent(e);
    // data with error object
    e = new CustomEvent('xyz', { detail: { x: 42, name: 'Schroedinger', err: new Error() } });
    console.log('before dispatch:');
    console.log(e.detail);
    window.dispatchEvent(e);
})();

输出（为便于阅读而分段）：

before dispatch:
Object {x: 42, name: "Schroedinger"}
after dispatch:
Object {x: 42, name: "Schroedinger"}

before dispatch:
Object {x: 42, name: "Schroedinger", detail: Object}
after dispatch:
Object {x: 42, name: "Schroedinger", detail: Object}

before dispatch:
Object {x: 42, name: "Schroedinger", func: function (){}}
after dispatch:
null

before dispatch:
Object {x: 42, name: "Schroedinger", err: Error at chrome-extension://...}
after dispatch:
null

我最初认为 JSON 可序列化是问题所在，但循环引用在事件中传递得很好，如果 JSON 序列化它们会中断。
感觉就像某些对象以相同的方式“污染”事件细节 non-crossorigin images taint canvases，除了控制台中没有任何内容。

我无法找到有关此行为的任何文档，并且（正如 Paul S. 建议的那样），Chrome permissions list 上似乎没有“特权”。

在 Chrome 40.0.2214.115m、43.0.2357.124m 和 48.0.2547.0-dev 中测试。

Answer 1

我发现了什么

我最初认为这是一项安全功能，主要是因为 Firefox 的行为方式如此。

In 在 Firefox 中运行了一个等效的测试，将事件侦听器放在一个单独的文件中，该文件可以通过 mozIJSSubScriptLoader 加载：

test.js：

(function()
{
    window.addEventListener('xyz', function(ev)
    {
        console.log('after dispatch:');
        console.log(ev.detail);
    });
})();

firefox.js：

(function()
{
    var mozIJSSubScriptLoader = Components.classes["@mozilla.org/moz/jssubscript-loader;1"].getService(Components.interfaces.mozIJSSubScriptLoader);
    window.addEventListener('load', function load(event)
    {
        window.removeEventListener('load', load);
        window.gBrowser.addEventListener('DOMContentLoaded', function(event)
        {
            mozIJSSubScriptLoader.loadSubScript('chrome://my-extension/content/test.js', window.content, 'UTF-8');
            // JSON-serializable data
            var e = new CustomEvent('xyz', { detail: { x: 42, name: 'Schroedinger' } });
            console.log('before dispatch:')
            console.log(e.detail);
            window.content.dispatchEvent(e);
            // non-JSON-serializable data
            e = new CustomEvent('xyz', { detail: { x: 42, name: 'Schroedinger', func: function(){} } });
            console.log('before dispatch:');
            console.log(e.detail);
            window.content.dispatchEvent(e);
        });
    });
})();

结果：

（注意错误出现两次。）

因此，在 Firefox 中，detail 包含的内容甚至都无关紧要 - 只要它来自扩展程序，就不允许该页面访问它。
对我来说，这似乎是一项安全功能。

我之所以将上述内容放在引号中是因为这在 Chrome 中有些不同！

经过更深入的调查后，看起来虽然扩展程序和页面共享 DOM 树，但它们存在于两种不同的上下文中。
我不知道这实际上是一个安全功能还是只是一个技术后果，但这当然会导致只能来回传递可克隆对象。

但令我困惑的是，操作会默默地失败，而根据the HTML standard, §2.7.5 (structured clone)，整个操作应该会失败并出现错误：

↪ 如果输入是另一个原生对象类型（例如错误、函数）
↪ 如果输入是宿主对象（例如 DOM 节点）
抛出DataCloneError 异常并中止整个structured clone 算法。

解决方法

我最终使用了一个相当简单（虽然不是那么漂亮）的解决方法：
在 Chrome 中，没有与 mozIJSSubScriptLoader 等效的标签，但您可以在扩展程序中将 <script> 标记附加到页面（在 FF 中不允许这样做）。
与chrome.extension.getURL一起，可以在页面上下文中运行一个扩展名打包的JS文件：

(function()
{
    var script = document.createElement('script');
    script.src = chrome.extension.getURL('extension.js');
    document.head.appendChild(script);
})();

当然需要这样

"web_accessible_resources": [ "extension.js" ]

设置在manifest.json，这不是很漂亮，但不应该是一个实际问题。

当然，这样做的缺点是，在 extension.js 中，您不再可以访问您的扩展程序可以访问的任何 chrome API，但在我的情况下，我不需要它。不过，通过 CustomEvent 设置代理并不难，因为 Chrome API 的最大部分只需要并返回 可克隆的数据。