首页 > web前端 > js教程 > 正文

怎样利用Server-Sent Events实现服务端推送功能?

betcha
发布: 2025-09-26 10:59:01
原创
510人浏览过
SSE基于HTTP实现服务端向浏览器的单向实时推送,使用EventSource API建立连接,服务端以text/event-stream格式持续发送数据,支持自动重连与自定义事件,适合通知类低频实时场景。

怎样利用server-sent events实现服务端推送功能?

Server-Sent Events(SSE)是一种让服务器主动向浏览器推送数据的技术,基于HTTP协议,使用简单,适合实时性要求不高的场景,比如通知、状态更新或实时日志展示。它比WebSocket轻量,且天然支持文本数据的有序传输。

基本原理

SSE 建立在标准 HTTP 之上,客户端通过 EventSource API 发起连接,服务端保持连接不关闭,并以特定格式持续发送数据。每次推送的消息都会触发客户端的 message 事件。

关键特点:

  • 单向通信:仅服务端推送到客户端
  • 自动重连:断开后客户端会尝试重新连接
  • 支持自定义事件类型
  • 数据格式为 text/event-stream

前端实现

使用原生 EventSource 即可监听服务端推送:

const eventSource = new EventSource('/api/sse');

eventSource.onmessage = function(event) {
  console.log('收到消息:', event.data);
};

eventSource.onerror = function(err) {
  console.error('SSE 连接出错', err);
};

// 可监听自定义事件
eventSource.addEventListener('customEvent', function(event) {
  console.log('自定义事件:', event.data);
});

后端实现(Node.js 示例)

服务端需设置正确的响应头,并持续输出符合 SSE 格式的数据:

AppMall应用商店
AppMall应用商店

AI应用商店,提供即时交付、按需付费的人工智能应用服务

AppMall应用商店 56
查看详情 AppMall应用商店
app.get('/api/sse', (req, res) => {
  // 设置响应头
  res.writeHead(200, {
    'Content-Type': 'text/event-stream',
    'Cache-Control': 'no-cache',
    'Connection': 'keep-alive'
  });

  // 发送普通消息
  setInterval(() => {
    res.write(`data: ${Date.now()}\n\n`);
  }, 1000);

  // 发送自定义事件
  setInterval(() => {
    res.write(`event: customEvent\ndata: {"msg": "hello"}\n\n`);
  }, 5000);

  // 客户端断开时清理
  req.on('close', () => {
    res.end();
  });
});

SSE 数据格式说明

每条消息由一个或多个字段组成,常见字段包括:

  • data: 消息内容,可多行,以 \n\n 结尾
  • event: 自定义事件名称,对应前端 addEventListener 的类型
  • id: 消息ID,用于断线重连时定位位置
  • retry: 重连间隔毫秒数

示例:

event: userUpdate
data: {"id": 123, "status": "online"}
id: 456
retry: 3000
\n\n

基本上就这些。只要前后端遵守 SSE 协议格式,就能轻松实现实时推送。相比轮询更高效,比 WebSocket 更简单,适合大多数通知类场景。注意连接长时间保持可能受代理或Nginx配置影响,需调整超时设置。

以上就是怎样利用Server-Sent Events实现服务端推送功能?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号