HTML SSE API
服务器发送事件 (SSE) 允许网页从服务器获取更新。
服务器发送事件 - 单向消息传递
服务器发送事件是指网页自动从服务器获取更新。
这在之前也是可以实现的，但网页需要询问是否有更新。使用服务器发送事件，更新会自动到来。
例如：Facebook/Twitter 更新、股票价格更新、新闻源、体育结果等。
浏览器支持
表中的数字指定了完全支持服务器发送事件的第一个浏览器版本。
| API | |||||
|---|---|---|---|---|---|
| SSE | 6.0 | 79.0 | 6.0 | 5.0 | 11.5 |
接收服务器发送事件通知
EventSource 对象用于接收服务器发送事件通知
例子
var source = new EventSource("demo_sse.php");
source.onmessage = function(event) {
document.getElementById("result").innerHTML += event.data + "<br>";
};
尝试一下 »
解释示例
- 创建一个新的 EventSource 对象，并指定发送更新的页面的 URL（在本例中为 "demo_sse.php"）
- 每次收到更新时，都会触发 onmessage 事件
- 当 onmessage 事件发生时，将接收到的数据放入 id 为 "result" 的元素中
检查服务器发送事件支持
在上面的尝试示例中，有一些额外的代码行用于检查浏览器对服务器发送事件的支持
if(typeof(EventSource) !== "undefined") {
// 是的！支持服务器发送事件！
// 一些代码.....
} else {
// 抱歉！不支持服务器发送事件..
}
服务器端代码示例
为了使上面的示例正常工作，您需要一个能够发送数据更新的服务器（例如 PHP 或 ASP）。
服务器端事件流语法很简单。将 "Content-Type" 标头设置为 "text/event-stream"。现在您可以开始发送事件流了。
PHP 代码 (demo_sse.php)
<?php
header('Content-Type: text/event-stream');
header('Cache-Control: no-cache');
$time = date('r');
echo "data: The server time is: {$time}\n\n";
flush();
?>
ASP 代码 (VB) (demo_sse.asp)
<%
Response.ContentType = "text/event-stream"
Response.Expires = -1
Response.Write("data: The server time is: " & now())
Response.Flush()
%>
代码解释
- 将 "Content-Type" 标头设置为 "text/event-stream"
- 指定页面不应该缓存
- 输出要发送的数据（始终以 "data: " 开头）
- 将输出数据刷新回网页
EventSource 对象
在上面的示例中，我们使用了 onmessage 事件来获取消息。但还有其他事件可用
| 事件 | 描述 |
|---|---|
| onopen | 当与服务器的连接打开时 |
| onmessage | 当收到消息时 |
| onerror | 当发生错误时 |
