首页 > 代码库 > Javascript框架的自定义事件(转)

Javascript框架的自定义事件(转)

很多 javascript 框架都提供了自定义事件(custom events),例如 jquery、yui 以及 dojo 都支持“document ready”事件。而部分自定义事件是源自回调(callback)。

回调将多个事件句柄存储在数组中,当满足触发条件时,回调系统则会从数组中获取对应的句柄并执行。那么,这会有什么陷阱呢?在回答这个问题之前,我们先看下代码。

下面是两段代码依次绑定到 domcontentloaded 事件中

document.addeventlistener("domcontentloaded", function() {
  console.log("init: 1");
  does_not_exist++; // 这里会抛出异常
}, false);

document.addeventlistener("domcontentloaded", function() {
  console.log("init: 2");
}, false);

那么运行这段代码会返回什么信息?显然,会看见这些(或者类似的):

init: 1
error: does_not_exist is not defined
init: 2

可以看出,两段函数都被执行。即使第一个函数抛出了个异常,但并不影响第二段代码运行。

麻烦

ok,我们回来看下常见框架中的回调系统。首先,我们看下 jquery 的(因为它很流行):

$(document).ready(function() {
  console.log("init: 1");
  does_not_exist++; // 这里会抛出异常
});

$(document).ready(function() {
  console.log("init: 2");
});

然后控制台中输出了什么?

init: 1
error: does_not_exist is not defined

这样问题就很明了了。回调系统其实很脆弱 -- 如果中间有段代码抛出了异常,那么其余将不会被执行。想象下在实际情况中,这后果可能会更严重,譬如有些糟糕的插件可能会“一粒老屎坏了一锅粥”。

其他的框架,dojo 的情况和 jquery 类似,不过 yui 的情况有些许不同。在它的回调系统中,使用了 try/catch 语句避免因异常发生的中断。但有个小小的负面影响,就是看不到相应的异常了。

yahoo.util.event.ondomready(function() {
  console.log("init: 1");
  does_not_exist++; // 这里会抛出异常
});

yahoo.util.event.ondomready(function() {
  console.log("init: 2");
});

输出:

init: 1
init: 2

那么,有无完美的解决方案呢?

解决方案

我想到了个解决方案,就是将回调和事件结合起来。可以先建立个事件,当回调触发时才运行它。由于每个事件都有其独立的运行环境(execution context),那么即使其中某个事件抛出了异常将不会影响其他的回调。

这听起来有点复杂,还是代码说话吧。

var currenthandler;

// 标准事件支持
if (document.addeventlistener) {
    document.addeventlistener("fakeevents", function() {
        // 执行回调
        currenthandler();
    }, false);

    // 新建事件
    var dispatchfakeevent = function() {
        var fakeevent = document.createevent("uievents");
        fakeevent.initevent("fakeevents", false, false);
        document.dispatchevent(fakeevent);
    };
} else {
    // 针对 ie 的代码在后面详细阐述
}

var onl oadhandlers = [];

// 将回调加入数组中
function addonload(handler) {
    onl oadhandlers.push(handler);
};

// 逐条取出回调,并利用上述新建的事件执行
onload = function() {
    for (var i = 0; i < onl oadhandlers.length; i++) {
        currenthandler = onl oadhandlers[i];
        dispatchfakeevent();
    }
};

万事俱备,让我们将上面坨代码扔到我们新的回调系统中

addonload(function() {
  console.log("init: 1");
  does_not_exist++; // 这里会抛出异常
});

addonload(function() {
  console.log("init: 2");
});

上帝保佑,看运行结果我们看到了如下的信息:

init: 1
error: does_not_exist is not defined
init: 2

赞!这就是我们期望的。这两个回调都运行而且互不影响,并且还能获得异常的信息,太好了!

好了,我们回过头来扶起 internet explorer 这个“阿斗”(我已经听见场下观众的建议了)。internet explorer 不支持 w3c 的标准事件规范,谢天谢地好在它有自身的实现 -- 有个 fireevents 的方法,但只能在用户事件的时候触发(例如用户点击 click)。

不过终于找到了门道,我们来看下具体代码:

var currenthandler;

if (document.addeventlistener) {
    // 省略上述的代码
} else if (document.attachevent) { // msie
    // 利用扩展属性,当此对象被改变时触发
    document.documentelement.fakeevents = 0;
    document.documentelement.attachevent("onpropertychange", function(event) {
        if (event.propertyname == "fakeevents") {
            // 执行回调
            currenthandler();
        }
    });

    dispatchfakeevent = function(handler) {
        // 触发 propertychange 事件
        document.documentelement.fakeevents++;
    };
}

简而言之,殊途同归,只是针对 internet explorer 使用了 propertychange 事件作为触发器。

更新

有些用户留言建议使用 settimeout:

try { callback(); } catch(e){ settimeout(function(){ throw e; }, 0); }

而下面是我的考虑

如没特别的要求,其实定时器的确也能搞定这问题。
上面仅仅是举例说明了这一技术的可行性。

意义在于,目前很多框架在回调系统的实现都非常的
脆弱,这或许能给这些框架能它们提供更优化的思路。
而定时器的实现并非实际的触发了事件,在实际事件
中,事件会被顺序的执行、可相互影响(譬如冒泡)、
还可以停止 -- 而这些是定时器无法做到的。

总之,最重要的是已经实现了包括 internet explorer 在内,使用事件执行回调的实现。如果你正编写基于事件代理的回调系统,我想你会对这一技术感兴趣的。

更新2

prototype 在针对 internet explorer 的自定义事件处理上,也是同上述的方法触发回调:

http://andrewdupont.net/2009/03/24/link-dean-edwards/

译注,prototype 1.6 对应的代码,摘记如下:

function createwrapper(element, eventname, handler) {
    var id = geteventid(element); // 获取绑定事件的 id
    var c = getwrappersforeventname(id, eventname); // 获取对应的事件的所有回调
    if (c.pluck("handler").include(handler)) return false; // 避免重复绑定

    // 新建回调
    var wrapper = function(event) {
        if (!event || !event.extend ||
                (event.eventname && event.eventname != eventname))
            return false;

        event.extend(event);
        handler.call(element, event);
    };

    // 加入到回调数组
    wrapper.handler = handler;
    c.push(wrapper);
    return wrapper;
}

function observe(element, eventname, handler) {
    element = $(element);                  // 对应事件的元素
    var name = getdomeventname(eventname); // 事件执行方式

    var wrapper = createwrapper(element, eventname, handler); // 封装回调

    if (!wrapper) return element;

    // 绑定事件
    if (element.addeventlistener) {
        element.addeventlistener(name, wrapper, false);
    } else {
        element.attachevent("on" + name, wrapper);
    }

    return element;
}

// 调用方式
document.observe("dom:loaded", function() {
    console.log("init: 1");
    does_not_exist++;
});

document.observe("dom:loaded", function() {
    console.log("init: 2");
});

看把 prototype 的作者给乐的 :-/

-- split --

在本人看来,原文的作者表述的技术点,除了如何创建健壮的回调系统外,其实还有两条。

其一,就是如何保证在出现异常的时,继续运行期望的代码;其二,就是如何创建互不干扰的“运行环境”。

原文提到的 createevent 和 settimeout 都是好办法,只是处理原作者所言在回调系统中,的确使用 createevent 会比较合适。settimeout 相对应的详细信息,可移步到 realazy 兄的相关文章。

而即使出错也能继续运行期望的代码,其实可以考虑使用 finally 语句,下面是个例子:

var callbacks = [
  function() { console.log(0); },
  function() { console.log(1); throw new error; },
  function() { console.log(2); },
  function() { console.log(3); }
];

for(var i = 0, len = callbacks.length; i < len; i++) {
    try {
        callbacks[i]();
    } catch(e) {
        console.info(e); // 获得异常信息
    } finally {
        continue;
    }
}

这一灵感同样来自 dean edwards 文章后的回复,在这里也贴下吧:

function iterate(callbacks, length, i) {
    if (i >= length) return;

    try {
        callbacks[i]();
    } catch(e) {
        throw e;
    } finally {
        iterate(callbacks, length, i+1);
    }
}

最后,留个小问题。谁知道上述的代码中,留言者提出的为什么异常到最后才打印出来不?