将 Firefox 30 之前的 Greasemonkey 脚本迁移到 GM4+ 时，如何替换 unsafeWindow？

Question

我正在尝试获取对我网页上存在的 jQuery 版本的引用，该脚本在 Firefox 30 之前一直有效。在我的定义下方的评论中，我可以找到另外两个引用，但是当我尝试访问 window 对象上的 jQuery 时，我只得到 ReferenceError: $ is not defined 或 ReferenceError: jQuery is not defined。

var $ = unsafeWindow.jQuery;
//var jQuery = window.jQuery; // From 
//var jQuery = $ || window.wrappedJSObject.$; // https://github.com/greasemonkey/greasemonkey/issues/2700#issuecomment-345538182
function addAccountNameToTitle(jNode) {
  $('title').text(session.name + " | " + $('title').text());
}

waitForKeyElements (".page-breadcrumb", addAccountNameToTitle, false);

/*--- waitForKeyElements():  A handy, utility function that
    does what it says.
*/
function waitForKeyElements (
    selectorTxt,    /* Required: The jQuery selector string that
                        specifies the desired element(s).
                    */
    actionFunction, /* Required: The code to run when elements are
                        found. It is passed a jNode to the matched
                        element.
                    */
    bWaitOnce,      /* Optional: If false, will continue to scan for
                        new elements even after the first match is
                        found.
                    */
    iframeSelector  /* Optional: If set, identifies the iframe to
                        search.
                    */
)
{
    var targetNodes, btargetsFound;

    if (typeof iframeSelector == "undefined")
        targetNodes     = $(selectorTxt);
    else
        targetNodes     = $(iframeSelector).contents ()
                                           .find (selectorTxt);

    if (targetNodes  &&  targetNodes.length > 0) {
        /*--- Found target node(s).  Go through each and act if they
            are new.
        */
        targetNodes.each ( function () {
            var jThis        = $(this);
            var alreadyFound = jThis.data ('alreadyFound')  ||  false;

            if (!alreadyFound) {
                //--- Call the payload function.
                actionFunction (jThis);
                jThis.data ('alreadyFound', true);
            }
        } );
        btargetsFound   = true;
    }
    else {
        btargetsFound   = false;
    }

    //--- Get the timer-control variable for this selector.
    var controlObj      = waitForKeyElements.controlObj  ||  {};
    var controlKey      = selectorTxt.replace (/[^\w]/g, "_");
    var timeControl     = controlObj [controlKey];

    //--- Now set or clear the timer as appropriate.
    if (btargetsFound  &&  bWaitOnce  &&  timeControl) {
        //--- The only condition where we need to clear the timer.
        clearInterval (timeControl);
        delete controlObj [controlKey]
    }
    else {
        //--- Set a timer, if needed.
        if ( ! timeControl) {
            timeControl = setInterval ( function () {
                    waitForKeyElements (    selectorTxt,
                                            actionFunction,
                                            bWaitOnce,
                                            iframeSelector
                                        );
                },
                500
            );
            controlObj [controlKey] = timeControl;
        }
    }
    waitForKeyElements.controlObj   = controlObj;
}

我正在使用 FF 59.0.2 和 Greasemonkey 4.3

Answer 1

unsafeWindow.jQuery 从来都不是一个好主意，而且很少奏效。另请参阅 Error: Permission denied to access property 'handler'。

聪明与问题代码有关的事情是使用 @require，像这样：

// ==UserScript==
// @name     _Changing the title text on some page.
// @match    *://YOUR_SERVER.COM/YOUR_PATH/*
// @require  https://ajax.googleapis.com/ajax/libs/jquery/2.1.0/jquery.min.js
// @require  https://gist.github.com/raw/2625891/waitForKeyElements.js
// @grant    GM_addStyle
// @grant    GM.getValue
// ==/UserScript==
//- The @grant directives are needed to restore the proper sandbox.

waitForKeyElements (".page-breadcrumb", addAccountNameToTitle);

function addAccountNameToTitle (jNode) {
    $('title').text (session.name + " | " + $('title').text() );
}

优点：

简短、简单、清晰。
不容易受到更改目标页面上的 javascript 的副作用的影响。特别是，如果目标页面更改 jQuery 版本。
使用 jQuery 和 waitForKeyElements 的快速本地版本。它们存储在本地磁盘上，通常缓存在内存中。没有服务器获取也没有延迟。

注意：如果session是目标页面全局变量，您可能需要像unsafeWindow.session.name一样访问它。参见：How to access `window` (Target page) objects when @grant values are set?。

您声明要使用页面的 jQuery 实例或版本。很少有充分的理由这样做。而这个问题中显示的代码肯定不会从中受益。

但是，如果您的用户脚本不使用任何 GM 函数，您可以通过 @grant none 模式来做到这一点，例如：

// ==UserScript==
// @name     _Changing the title text on some page.
// @match    *://YOUR_SERVER.COM/YOUR_PATH/*
// @require  https://gist.github.com/raw/2625891/waitForKeyElements.js
// @grant    none
// ==/UserScript==

waitForKeyElements (".page-breadcrumb", addAccountNameToTitle);

function addAccountNameToTitle (jNode) {
    $('title').text (session.name + " | " + $('title').text() );
}

将 Firefox 30 之前的 Greasemonkey 脚本迁移到 GM4+ 时，如何替换 unsafeWindow？

How do I replace unsafeWindow when migrating a pre-Firefox 30 Greasemonkey script to GM4+?

javascript

firefox

greasemonkey

greasemonkey-4