首页 > 代码库 > Visual Event :快速查看 DOM 上绑定的 JS 事件

Visual Event :快速查看 DOM 上绑定的 JS 事件

http://web.jobbole.com/82503/

 

Javascript中的事件经常被认为如谜一般不可解。Javascript是一个事件驱动的语言,在这样的前提下前面的看法是很奇怪,但是说到它们的复杂本质和调试难度时,这样的看法又是很正常的。为此,我创建了可视化事件(Visual Event)来查看DOM节点上绑定的事件。

简介

Visual Event是一个开源 Javascript 书签,能提供绑定在DOM元素上的事件调试信息。Visual Event能显示如下信息:

1、哪一个元素有事件绑定

2、某元素上绑定的事件类型

3、事件触发后运行的代码段

4、定义绑定函数的源文件和行号(仅限于WebKit和Opera浏览器)

除了对调试你自己的代码大有用途,Visual Event还能被用作教学工具,显示发起了多少网站。

Visual Event是开源软件(GPLv2),并且在GitHub上有一个Git仓库目录,供你去提交或照你所想的去修改

安装

由于Visual Event是一个小书签,所以在任何网页上安装和运行它都很简单:

1、拖拽右侧的“Visual Event”链接到你的书签栏上:Visual Event

2、载入一个使用了浏览器所能支持的js库的网页

3、点击书签栏中的“Visual Event”

4、查看绑定在文档元素上的事件处理器

自动载入的Visual Event例子在这里有提供。这个例子使用Data Tables创建了一个不同元素上绑定了许多事件的测试页面。

它是如何工作的

W3C 没有提供标准的方法推荐能发现特定元素上绑定事件的DOM接口。尽管这似乎是个疏忽,也有一个建议方法能将3级DOM规范的 eventListenerList 属性包含进来,但很不幸的是,在后来的草案中这个方法被移除了。因此,我们不得不研究独立的通常能维护一个事件的高速缓存的Javascript库(所以它们能在后来被移除并执行其他有用的抽象化)。

因此,Visual Event为了能显示事件,它必须能够从 JS 库中解析出事件信息。目前Visual Event能支持的库有如下这些:

  • DOM 0 events
  • jQuery 1.2+
  • YUI 2
  • MooTools 1.2+
  • Prototype 1.6+
  • Glow
  • ExtJS 4.0.x

如何参与

Visual Event是个开源软件,在GPLv2证书下可以获得。通过Git实现开源控制,而且该项目在GitHub 上有一个网页。事实上任何对Visual Event的提高有帮助的建议都是十分受欢迎的!如果你遇到什么问题,请在 GitHub上将你遇到的问题作为讨论(issue)展开,包括出现问题的网页链接地址。Fork代码以及合并分支(pull request)也同样被鼓励!

你可能有一个很感兴趣的地方,就是如何能添加对额外Javascript库的支持。关键是能够获取到该库使用的事件缓存,因为没有事件缓存就不可能知道哪个节点有事件以及绑定代码。

VisualEvent类有一个静态数组叫做“VisualEvent.parsers”,它是一个函数的数组——想增加一个新的解析器,只需要将你的函数加到这个数组里。这个函数必须返回一个带有以下参数的javascript对象数组:

 
 
 
 
 
 
JavaScript
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[
    {
        "node": {element},            // The DOM element that has attached events
        "listeners": [                // Array of attached events
            {
                "type": {string},     // The event type - click, change, keyup etc
                "func": {string},     // The code that will handle the event, from Function.toString()
                "removed": {boolean}, // If the event has been removed or not (typically will be false, but used if the library doesn‘t remove the event from its cache)
                "source": {string}    // Library name and version that attached the event (e.g. "jQuery 1.7")
            },
            ...
        ]
    },
    ...
]

 

建立Visual Event

为了能运行本地的Visual Event副本,你必须先建立一个Visual Event,因为这个过程会有文件级联操作,即将库中的解析器移动到主文件中。建立的过程中还同时会建立 JSDoc文 档并压缩 JS 文件(除非是调试生成的)。

为了建立Visual Event,你在终端只需要一个能运行bash脚本并能输入“./build .sh debug”命令的系统。这会在建立Visual Event和正确的载入器的目录中的“builds”目录里创建一个新目录(注意时间戳是用于防止开发和部署过程中boolmarklet的缓存问题)。以下是建立过程的脚本的使用实例:

 
 
 
 
 
JavaScript
 
1
2
3
4
5
6
7
8
9
10
11
12
13
Visual Event build script - usage:
  ./build.sh [loader-dir] [debug]
    loader-dir - The web-address of the build files. Note that the build
      directory name is automatically appended. For example:
        localhost/VisualEvent/builds - default if no option is provided
        sprymedia.co.uk/VisualEvent/builds
    debug - Debug indicator. Will not compress the Javascript
 
  Example deploy build:
    ./build.sh sprymedia.co.uk/VisualEvent/builds
 
  Example debug build:
    ./build.sh localhost/VisualEvent/builds debug

文件“bookmarklet.html”是为了使你能方便地建立你自己的书签载入器。通常你只需要修改书签的路径地址。链接会在每次按键时更新,你只需要像你安装其他书签插件一样去安装它。

Visual Event :快速查看 DOM 上绑定的 JS 事件