WebSocket API是纯事件驱动的。应用程序代码监听WebSocket对象上的事件，以便处理输入数据和连接状态的改变。WebSocket协议也是事件驱动的。客户端应用程序不需要轮询服务器来得到更新的数据。消息和事件将在服务器发送它们的时候异步到达。

WebSocket编程遵循异步编程模式，也就是说，只要WebSocket连接打开，应用程序就简单地监听事件。客户端不需要主动轮询服务器得到更多的信息。要开始监听事件，只要为WebSocket对象添加回调函数。也可以使用addEventListener() DOM方法为WebSocket对象添加事件监听器。

WebSocket对象调度4个不同的事件：

 open

 message

 error

 close

和所有Web API一样，可以用on<事件名称>处理程序属性监听这些事件，也可以使用addEventListener();方法。

1. WebSocket事件：open

一旦服务器响应了WebSocket连接请求，open事件触发并建立一个连接。open事件对应的回调函数称作onopen。

代码清单2-4说明建立WebSocket连接时如何处理该事件。


 

到open事件触发时，协议握手已经完成，WebSocket已经准备好发送和接收数据。如果应用程序接收到一个open事件，那么 可以确定WebSocket服务器成功地处理了连接请求，并且同意与应用程序通信。

2. WebSocket事件：message

WebSocket消息包含来自服务器的数据。你也可能听说过组成WebSocket消息的WebSocket帧（Frame）。第3章将详细讨论消息和帧的概念。为了理解消息使用API的方式，WebSocket API只输出完整的消息，而不是WebSocket帧。message事件在接收到消息时触发，对应于该事件的回调函数是onmessage。

代码清单2-5展示了一个接收文本消息并显示消息内容的消息处理程序。


 

除了文本，WebSocket消息还可以处理二进制数据，这种数据作为Blob消息（见代码清单2-6）或者ArrayBuffer消息处理（见代码清单2-7）。因为设置WebSocket消息二进制数据类型的应用程序会影响二进制消息，所以必须在读取数据之前决定用于客户端二进制输入数据的类型。

 

3. WebSocket事件：error

error事件在响应意外故障的时候触发。与该事件对应的回调函数为onerror。错误还会导致WebSocket连接关闭。如果你接收一个error事件，可以预期很快就会触发close事件。close事件中的代码和原因有时候能告诉你错误的根源。error事件处理程序是调用服务器重连逻辑以及处理来自WebSocket对象的异常的最佳场所。代码清单2-8展示了监听error事件的一个例子。



 

4. WebSocket事件：close
close事件在WebSocket连接关闭时触发。对应于close事件的回调函数是onclose。一旦连接关闭，客户端和服务器不再能接收或者发送消息。

说明 WebSocket规范还定义了ping和pong帧，可以用于持续连接（keep-alive）、心跳、网络状态检测、延迟测量等，但是WebSocket API目前没有输出这些特性。尽管浏览器接受ping帧，但是不会触发对应WebSocket上的ping事件。相反，浏览器将自动响应pong帧。然而，浏览器实例化的ping如果在一段时间内没有得到pong应答，可能会触发连接的close事件。第8章将详细介绍WebSocket的ping和pong。

当调用close()方法终止与服务器的连接时，也会触发onclose事件处理程序，如代码清单2-9所示。


 

WebSocket close事件在连接关闭时触发，这可能有多种原因，比如连接失败或者成功的WebSocket关闭握手。WebSocket对象特性readyState反映了连接的状态（2为正在关闭，3为已关闭）。

close事件有3个有用的属性（property），可以用于错误处理和恢复：wasClean、code和error。wasClean属性是一个布尔属性，表示连接是否顺利关闭。如果WebSocket的关闭是对来自服务器的一个close帧的响应，则该属性为true。如果连接是因为其他原因（例如，因为底层TCP连接关闭）关闭，则该属性为false。code和reason属性表示服务器发送的关闭握手状态。这些属性和WebSocket.close()方法中的code和reason参数一致，我们将在本章后面详加介绍。在第3章中，我们将在讨论WebSocket协议时讨论关闭的代码和它们的含义。

说明 关于WebSocket事件的更多细节，参见WebSocket API规范：http://www.w3.org/TR/websockets/。