当前位置： 首页 > news >正文

EventSource

news 2025/7/20 2:59:17

什么是EventSource

EventSource 是一个用于服务器推送事件（Server-Sent Events, SSE）的接口，它允许服务器推送实时更新到浏览器。与 WebSocket 不同，SSE 是单向的（服务器到客户端），适用于更新频率不高的实时通知、消息推送等场景。下面是关于 EventSource 的详细介绍，包括使用示例和注意事项。

基本概念

  • 服务器推送事件（SSE）：服务器向客户端推送实时更新，而不需要客户端发起请求。
  • EventSource 接口：浏览器端用于接收服务器推送事件的 API。

创建 EventSource 实例

要创建一个 EventSource 实例，需要传入一个 URL，这个 URL 指向服务器端的事件流端点：

const eventSource = new EventSource('https://example.com/events');

监听事件

EventSource 可以监听三种类型的事件：message、open 和 error。

  • message 事件：当服务器发送一个消息时触发。
  • open 事件：当连接被打开时触发。
  • error 事件：当发生错误时触发。
eventSource.onmessage = function(event) {console.log('Message:', event.data);
};eventSource.onopen = function() {console.log('Connection opened.');
};eventSource.onerror = function(event) {if (event.readyState === EventSource.CLOSED) {console.log('Connection closed.');} else {console.log('Error:', event);}
};

自定义事件

除了默认的 message 事件，你还可以监听自定义事件。服务器可以通过 event 字段来定义事件类型，客户端使用 addEventListener 来监听。

服务器发送（示例）：

event: customEvent
data: This is a custom event

客户端监听：

eventSource.addEventListener('customEvent', function(event) {console.log('Custom Event:', event.data);
});

服务器端设置

服务器端需要设置适当的响应头来支持 SSE：

Content-Type: text/event-stream
Cache-Control: no-cache
Connection: keep-alive

并按照指定的格式发送数据：

data: This is a message\n\n

例如，使用 Node.js 和 Express 的实现：

const express = require('express');
const app = express();app.get('/events', (req, res) => {res.setHeader('Content-Type', 'text/event-stream');res.setHeader('Cache-Control', 'no-cache');res.setHeader('Connection', 'keep-alive');setInterval(() => {res.write(`data: ${JSON.stringify({ message: 'Hello, World!' })}\n\n`);}, 1000);
});app.listen(3000, () => {console.log('Server listening on port 3000');
});

关闭连接

当不再需要接收事件时，可以关闭 EventSource 连接：

eventSource.close();
console.log('Connection closed.');

完整示例

以下是一个完整的前端和后端示例，展示了如何使用 EventSource 和 SSE。

前端（HTML + JavaScript）：

<!DOCTYPE html>
<html>
<head><title>EventSource Example</title>
</head>
<body><h1>Server-Sent Events Example</h1><div id="messages"></div><script>const eventSource = new EventSource('http://localhost:3000/events');eventSource.onmessage = function(event) {const messageElement = document.createElement('div');messageElement.textContent = 'Message: ' + event```htmlmessageElement.textContent = 'Message: ' + event.data;document.getElementById('messages').appendChild(messageElement);};eventSource.onopen = function() {console.log('Connection opened.');};eventSource.onerror = function(event) {if (event.readyState === EventSource.CLOSED) {console.log('Connection closed.');} else {console.log('Error:', event);}};// Example of listening to a custom eventeventSource.addEventListener('customEvent', function(event) {const customEventElement = document.createElement('div');customEventElement.textContent = 'Custom Event: ' + event.data;document.getElementById('messages').appendChild(customEventElement);});// Close the EventSource after 10 seconds for demonstration purposessetTimeout(() => {eventSource.close();console.log('Connection closed.');}, 10000);</script>
</body>
</html>

后端（Node.js + Express）：

const express = require('express');
const app = express();app.get('/events', (req, res) => {res.setHeader('Content-Type', 'text/event-stream');res.setHeader('Cache-Control', 'no-cache');res.setHeader('Connection', 'keep-alive');// Send a simple message every secondconst intervalId = setInterval(() => {res.write(`data: ${JSON.stringify({ message: 'Hello, World!' })}\n\n`);}, 1000);// Send a custom event every 5 secondsconst customEventIntervalId = setInterval(() => {res.write(`event: customEvent\ndata: This is a custom event\n\n`);}, 5000);// Clear intervals when client closes connectionreq.on('close', () => {clearInterval(intervalId);clearInterval(customEventIntervalId);});
});app.listen(3000, () => {console.log('Server listening on port 3000');
});

详细解释

  1. 前端代码解释：

    • EventSource 实例：const eventSource = new EventSource('http://localhost:3000/events'); 创建一个新的 EventSource 实例，连接到服务器的 /events 端点。
    • 事件监听：
      • onmessage 处理默认的 message 事件，显示从服务器接收到的消息。
      • onopen 处理连接打开事件，输出连接已打开的信息。
      • onerror 处理错误事件，输出错误信息或连接关闭信息。
      • addEventListener('customEvent', ...) 处理自定义事件 customEvent，显示从服务器接收到的自定义事件数据。
    • 关闭连接：使用 setTimeout 在 10 秒后关闭 EventSource 连接。

  2. 后端代码解释：

    • Express 服务器：创建一个简单的 Express 服务器，监听 /events 路由。
    • 设置响应头：确保设置 Content-Type, Cache-Control, 和 Connection 头以支持 SSE。
    • 发送数据：
      • 使用 setInterval 每秒发送一个消息。
      • 使用另一个 setInterval 每 5 秒发送一个自定义事件。
    • 清理：当客户端关闭连接时，清理定时器以避免内存泄漏。

注意事项

  • 浏览器支持：EventSource 在现代浏览器中得到广泛支持，但在 IE 和旧版浏览器中不支持。你可能需要考虑替代方案或 Polyfill。
  • 单向通信：SSE 是单向通信，从服务器到客户端。如果需要双向通信，应该考虑使用 WebSocket。
  • 重连机制：EventSource 内置了自动重连机制，连接断开时会自动尝试重新连接。
  • 带宽考虑：SSE 使用 HTTP/1.1 长连接，适合较低频率的消息推送。如果消息频率较高，应考虑 WebSocket。

通过上述示例，你应该能够理解和使用 EventSource 来实现服务器推送事件，从而在你的应用中实现实时更新。

可以使用eventSource向后端传递数据吗

EventSource 是一种用于服务器推送事件（Server-Sent Events, SSE）的技术，主要用于服务器向客户端推送数据。这是一种单向通信，从服务器到客户端。它不支持从客户端向服务器发送数据。

如果你需要双向通信（即从客户端向服务器发送数据并接收服务器的响应），有几种常见的替代方案可以考虑：

替代方案

  1. XHR (XMLHttpRequest) / Fetch API:

    • 用于在需要的时候从客户端向服务器发送请求。
    • 可以与 EventSource 配合使用，处理从服务器接收推送消息。

  2. WebSocket:

    • 支持全双工通信，允许客户端和服务器相互发送数据。
    • 适用于实时性要求较高的应用场景。

使用 Fetch API 发送数据

假设你正在使用 EventSource 接收服务器推送的数据，同时需要发送数据到服务器，你可以使用 fetch API 来实现。

前端示例：

<!DOCTYPE html>
<html>
<head><title>EventSource with Fetch</title>
</head>
<body><h1>EventSource with Fetch Example</h1><div id="messages"></div><button id="sendDataButton">Send Data</button><script>const eventSource = new EventSource('http://localhost:3000/events');eventSource.onmessage = function(event) {const messageElement = document.createElement('div');messageElement.textContent = 'Message: ' + event.data;document.getElementById('messages').appendChild(messageElement);};eventSource.onopen = function() {console.log('Connection opened.');};eventSource.onerror = function(event) {if (event.readyState === EventSource.CLOSED) {console.log('Connection closed.');} else {console.log('Error:', event);}};document.getElementById('sendDataButton').addEventListener('click', () => {fetch('http://localhost:3000/send-data', {method: 'POST',headers: {'Content-Type': 'application/json'},body: JSON.stringify({ message: 'Hello, Server!' })}).then(response => response.json()).then(data => {console.log('Success:', data);}).catch((error) => {console.error('Error:', error);});});</script>
</body>
</html>

后端示例（Node.js + Express）：

const express = require('express');
const app = express();app.use(express.json());app.get('/events', (req, res) => {res.setHeader('Content-Type', 'text/event-stream');res.setHeader('Cache-Control', 'no-cache');res.setHeader('Connection', 'keep-alive');const intervalId = setInterval(() => {res.write(`data: ${JSON.stringify({ message: 'Hello, Client!' })}\n\n`);}, 1000);req.on('close', () => {clearInterval(intervalId);});
});app.post('/send-data', (req, res) => {const clientMessage = req.body.message;console.log('Received from client:', clientMessage);res.json({ status: 'success', receivedMessage: clientMessage });
});app.listen(3000, () => {console.log('Server listening on port 3000');
});

使用 WebSocket 实现双向通信

如果你需要更复杂的双向通信，可以考虑使用 WebSocket：

前端示例：

<!DOCTYPE html>
<html>
<head><title>WebSocket Example</title>
</head>
<body><h1>WebSocket Example</h1><div id="messages"></div><button id="sendDataButton">Send Data</button><script>const socket = new WebSocket('ws://localhost:3000');socket.onopen = function() {console.log('WebSocket connection opened.');};socket.onmessage = function(event) {const messageElement = document.createElement('div');messageElement.textContent = 'Message: ' + event.data;document.getElementById('messages').appendChild(messageElement);};socket.onerror = function(event) {console.error('WebSocket error:', event);};socket.onclose = function() {console.log('WebSocket connection closed.');};document.getElementById('sendDataButton').addEventListener('click', () => {const message = 'Hello, Server!';socket.send(message);console.log('Sent:', message);});</script>
</body>
</html>

后端示例（Node.js + ws 模块）：

const WebSocket = require('ws');
const server = new WebSocket.Server({ port: 3000 });server.on('connection', ws => {console.log('New client connected.');ws.on('message', message => {console.log('Received from client:', message);ws.send(`Hello, Client! Received your message: ${message}`);});ws.on('close', () => {console.log('Client disconnected.');});ws.send('Welcome, Client!');
});

总结

EventSource 仅用于服务器到客户端的单向通信。如果你需要从客户端向服务器发送数据，建议使用 fetch 或 XMLHttpRequest 结合 EventSource，或者采用 WebSocket 进行双向通信。

http://www.lryc.cn/news/355153.html

相关文章：

  • Vue2 Element-UI 分页组件el-pagination 修改 自带的total、跳转等默认文字
  • 【简单介绍下线性回归模型】
  • 有限元法之有限元空间的构造
  • 高通车规芯片分析
  • Flutter 中的 TextButton 小部件：全面指南
  • 通过键值对访问字典
  • 海外仓扫码管理系统怎么选？精准，高效管理需求才是核心需求
  • 基于51单片机的智能灯光控制系统
  • 测试开发面试题
  • 多线程JUC 第2季 BlockingQueue 阻塞队列
  • 【MySQL精通之路】全文搜索(3)-带查询扩展的全文搜索
  • 【面试必看】Java并发
  • C++的第一道门坎:类与对象（一）
  • 经典面试题：MySQL如何调优？
  • 【程序员如何送外卖】
  • 【git pull 和 push详解】
  • 数据挖掘导致直接路径读（direct path read）耗尽了IO
  • 用队列实现栈 用栈实现队列 设计循环队列
  • BFS解决最短路问题(详解)
  • 按尺寸筛选轮廓图中的轮廓
  • VBA高级应用30例：实现在列表框内及列表框间实现数据拖动
  • 「AIGC算法」R-tree算法
  • 2024软考上半年嵌入式系统设计师考试回顾
  • MIT6.828 Lab2-1 Using gdb
  • mysqldump提示Using a password on the command line interface can be insecured的解决办法
  • Java毕业设计 基于springboot vue考勤管理系统
  • C数据结构：二叉树
  • 使用Nginx作为反向代理实现MQTT内外网通信
  • SpringBoot 上传文件示例
  • 9.js函数