@ahoo-wang/fetcher-eventstream 1.0.8 → 1.2.0

package/README.md

@@ -23,6 +23,7 @@ APIs.
 - **💬 Comment Handling**: Properly ignores comment lines (lines starting with `:`) as per SSE specification
 - **🛡️ TypeScript Support**: Complete TypeScript type definitions
 - **⚡ Performance Optimized**: Efficient parsing and streaming for high-performance applications
+- **🤖 LLM Streaming Ready**: Native support for streaming responses from popular LLM APIs like OpenAI GPT, Claude, etc.
 
 ## 🚀 Quick Start
 
@@ -39,6 +40,26 @@ pnpm add @ahoo-wang/fetcher-eventstream
 yarn add @ahoo-wang/fetcher-eventstream
 ```
 
+### Module Import
+
+To use the event stream functionality, you need to import the module for its side effects:
+
+```typescript
+import '@ahoo-wang/fetcher-eventstream';
+```
+
+This import automatically extends the `Response` interface with methods for handling Server-Sent Events streams:
+
+- `eventStream()` - Converts a Response with `text/event-stream` content type to a `ServerSentEventStream`
+- `jsonEventStream<DATA>()` - Converts a Response with `text/event-stream` content type to a
+  `JsonServerSentEventStream<DATA>`
+- `isEventStream` getter - Checks if the Response has a `text/event-stream` content type
+- `requiredEventStream()` - Gets a `ServerSentEventStream`, throwing an error if not available
+- `requiredJsonEventStream<DATA>()` - Gets a `JsonServerSentEventStream<DATA>`, throwing an error if not available
+
+This is a common pattern in JavaScript/TypeScript for extending existing types with additional functionality without
+modifying the original type definitions.
+
 ### Integration Test Example: LLM Client with Event Stream
 
 The following example shows how to create an LLM client with event stream support, similar to the integration test in
@@ -64,10 +85,8 @@ import {
   post,
   ResultExtractors,
 } from '@ahoo-wang/fetcher-decorator';
-import {
-  EventStreamInterceptor,
-  JsonServerSentEventStream,
-} from '@ahoo-wang/fetcher-eventstream';
+import '@ahoo-wang/fetcher-eventstream';
+import { JsonServerSentEventStream } from '@ahoo-wang/fetcher-eventstream';
 import { ChatRequest, ChatResponse } from './types';
 
 export const llmFetcherName = 'llm';
@@ -100,7 +119,6 @@ export function createLlmFetcher(options: LlmOptions): NamedFetcher {
     },
   });
   llmFetcher.interceptors.request.use(new LlmRequestInterceptor(options));
-  llmFetcher.interceptors.response.use(new EventStreamInterceptor());
   return llmFetcher;
 }
 
@@ -111,14 +129,14 @@ export function createLlmFetcher(options: LlmOptions): NamedFetcher {
 export class LlmClient {
   @post('/completions')
   streamChat(
-    @body() _body: ChatRequest,
+    @body() body: ChatRequest,
   ): Promise<JsonServerSentEventStream<ChatResponse>> {
-    throw autoGeneratedError();
+    throw autoGeneratedError(body);
   }
 
   @post('/completions', { resultExtractor: ResultExtractors.Json })
-  chat(@body() _body: ChatRequest): Promise<ChatResponse> {
-    throw autoGeneratedError();
+  chat(@body() body: ChatRequest): Promise<ChatResponse> {
+    throw autoGeneratedError(body);
   }
 }
 ```
@@ -203,33 +221,27 @@ try {
 }
 ```
 
-### Basic Usage with Interceptor
+### Basic Usage
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
+import '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://api.example.com',
 });
 
-// Add the event stream interceptor
-fetcher.interceptors.response.use(new EventStreamInterceptor());
-
-// Using the eventStream method on responses with text/event-stream content type
+// In responses with text/event-stream content type,
+// Response objects will automatically have eventStream() and jsonEventStream() methods
 const response = await fetcher.get('/events');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    console.log('Received event:', event);
-  }
+for await (const event of response.requiredEventStream()) {
+  console.log('Received event:', event);
 }
 
-// Using the jsonEventStream method for JSON data
+// Using jsonEventStream for JSON data
 const jsonResponse = await fetcher.get('/json-events');
-if (response.jsonEventStream) {
-  for await (const event of response.jsonEventStream<MyDataType>()) {
-    console.log('Received JSON event:', event.data);
-  }
+for await (const event of response.requiredJsonEventStream<MyDataType>()) {
+  console.log('Received JSON event:', event.data);
 }
 ```
 
@@ -257,20 +269,48 @@ try {
 
 ## 📚 API Reference
 
-### EventStreamInterceptor
+### Module Import
+
+To use the event stream functionality, you need to import the module for its side effects:
+
+```typescript
+import '@ahoo-wang/fetcher-eventstream';
+```
+
+This import automatically extends the global `Response` interface with methods for handling Server-Sent Events streams:
 
-A response interceptor that automatically adds an `eventStream()` method to responses with `text/event-stream` content
-type.
+- `eventStream()` - Converts a Response with `text/event-stream` content type to a `ServerSentEventStream`
+- `jsonEventStream<DATA>()` - Converts a Response with `text/event-stream` content type to a
+  `JsonServerSentEventStream<DATA>`
+- `isEventStream` getter - Checks if the Response has a `text/event-stream` content type
+- `requiredEventStream()` - Gets a `ServerSentEventStream`, throwing an error if not available
+- `requiredJsonEventStream<DATA>()` - Gets a `JsonServerSentEventStream<DATA>`, throwing an error if not available
 
-#### Usage
+This is a common pattern in JavaScript/TypeScript for extending existing types with additional functionality without
+modifying the original type definitions.
+
+In integration tests and real applications, this import is essential for working with event streams. For example:
 
 ```typescript
-fetcher.interceptors.response.use(new EventStreamInterceptor());
+import { Fetcher } from '@ahoo-wang/fetcher';
+import '@ahoo-wang/fetcher-eventstream';
+
+const fetcher = new Fetcher({
+  baseURL: 'https://api.example.com',
+});
+
+// Response objects will automatically have eventStream() and jsonEventStream() methods
+const response = await fetcher.get('/events');
+// Handle event stream
+for await (const event of response.requiredEventStream()) {
+  console.log('Received event:', event);
+}
 ```
 
 ### toJsonServerSentEventStream
 
-Converts a ServerSentEventStream to a JsonServerSentEventStream for consuming server-sent events with JSON data.
+Converts a `ServerSentEventStream` to a `JsonServerSentEventStream<DATA>` for handling Server-Sent Events with JSON
+data.
 
 #### Signature
 
@@ -282,11 +322,11 @@ function toJsonServerSentEventStream<DATA>(
 
 #### Parameters
 
-- `serverSentEventStream`: The ServerSentEventStream to convert
+- `serverSentEventStream`: The `ServerSentEventStream` to convert
 
 #### Returns
 
-- `JsonServerSentEventStream<DATA>`: A readable stream of ServerSentEvent objects with JSON data
+- `JsonServerSentEventStream<DATA>`: A readable stream of `JsonServerSentEvent<DATA>` objects
 
 ### JsonServerSentEvent
 
@@ -294,13 +334,13 @@ Interface defining the structure of a Server-Sent Event with JSON data.
 
 ```typescript
 interface JsonServerSentEvent<DATA> extends Omit<ServerSentEvent, 'data'> {
-  data: DATA; // Event data as parsed JSON
+  data: DATA; // The event data parsed as JSON
 }
 ```
 
 ### JsonServerSentEventStream
 
-Type alias for a readable stream of ServerSentEvent objects with JSON data.
+Type alias for a readable stream of `JsonServerSentEvent<DATA>` objects.
 
 ```typescript
 type JsonServerSentEventStream<DATA> = ReadableStream<
@@ -310,7 +350,7 @@ type JsonServerSentEventStream<DATA> = ReadableStream<
 
 ### toServerSentEventStream
 
-Converts a Response object with a `text/event-stream` body to a readable stream of ServerSentEvent objects.
+Converts a `Response` object with a `text/event-stream` body to a `ServerSentEventStream`.
 
 #### Signature
 
@@ -320,11 +360,11 @@ function toServerSentEventStream(response: Response): ServerSentEventStream;
 
 #### Parameters
 
-- `response`: The HTTP response with `text/event-stream` content type
+- `response`: An HTTP response with `text/event-stream` content type
 
 #### Returns
 
-- `ServerSentEventStream`: A readable stream of ServerSentEvent objects
+- `ServerSentEventStream`: A readable stream of `ServerSentEvent` objects
 
 ### ServerSentEvent
 
@@ -332,16 +372,16 @@ Interface defining the structure of a Server-Sent Event.
 
 ```typescript
 interface ServerSentEvent {
-  data: string; // Event data (required)
-  event?: string; // Event type (optional, defaults to 'message')
-  id?: string; // Event ID (optional)
-  retry?: number; // Retry timeout in milliseconds (optional)
+  data: string; // The event data (required)
+  event?: string; // The event type (optional, defaults to 'message')
+  id?: string; // The event ID (optional)
+  retry?: number; // The reconnection time in milliseconds (optional)
 }
 ```
 
 ### ServerSentEventStream
 
-Type alias for a readable stream of ServerSentEvent objects.
+Type alias for a readable stream of `ServerSentEvent` objects.
 
 ```typescript
 type ServerSentEventStream = ReadableStream<ServerSentEvent>;
@@ -353,30 +393,27 @@ type ServerSentEventStream = ReadableStream<ServerSentEvent>;
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
+import '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://api.example.com',
 });
-fetcher.interceptors.response.use(new EventStreamInterceptor());
 
 // Listen for real-time notifications
 const response = await fetcher.get('/notifications');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    switch (event.event) {
-      case 'message':
-        showNotification('Message', event.data);
-        break;
-      case 'alert':
-        showAlert('Alert', event.data);
-        break;
-      case 'update':
-        handleUpdate(JSON.parse(event.data));
-        break;
-      default:
-        console.log('Unknown event:', event);
-    }
+for await (const event of response.requiredEventStream()) {
+  switch (event.event) {
+    case 'message':
+      showNotification('Message', event.data);
+      break;
+    case 'alert':
+      showAlert('Alert', event.data);
+      break;
+    case 'update':
+      handleUpdate(JSON.parse(event.data));
+      break;
+    default:
+      console.log('Unknown event:', event);
   }
 }
 ```
@@ -385,24 +422,20 @@ if (response.eventStream) {
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://api.example.com',
 });
-fetcher.interceptors.response.use(new EventStreamInterceptor());
 
 // Track long-running task progress
 const response = await fetcher.get('/tasks/123/progress');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    if (event.event === 'progress') {
-      const progress = JSON.parse(event.data);
-      updateProgressBar(progress.percentage);
-    } else if (event.event === 'complete') {
-      showCompletionMessage(event.data);
-      break;
-    }
+for await (const event of response.requiredEventStream()) {
+  if (event.event === 'progress') {
+    const progress = JSON.parse(event.data);
+    updateProgressBar(progress.percentage);
+  } else if (event.event === 'complete') {
+    showCompletionMessage(event.data);
+    break;
   }
 }
 ```
@@ -411,25 +444,21 @@ if (response.eventStream) {
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://chat-api.example.com',
 });
-fetcher.interceptors.response.use(new EventStreamInterceptor());
 
 // Real-time chat messages
 const response = await fetcher.get('/rooms/123/messages');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    if (event.event === 'message') {
-      const message = JSON.parse(event.data);
-      displayMessage(message);
-    } else if (event.event === 'user-joined') {
-      showUserJoined(event.data);
-    } else if (event.event === 'user-left') {
-      showUserLeft(event.data);
-    }
+for await (const event of response.requiredEventStream()) {
+  if (event.event === 'message') {
+    const message = JSON.parse(event.data);
+    displayMessage(message);
+  } else if (event.event === 'user-joined') {
+    showUserJoined(event.data);
+  } else if (event.event === 'user-left') {
+    showUserLeft(event.data);
   }
 }
 ```

package/README.zh-CN.md

@@ -13,12 +13,13 @@
 ## 🌟 特性
 
 - **📡 事件流转换**：将 `text/event-stream` 响应转换为 `ServerSentEvent` 对象的异步生成器
-- **🔌 拦截器集成**：自动为 `text/event-stream` 内容类型的响应添加 `eventStream()` 和 `jsonEventStream()` 方法
+- **🔌 自动扩展**：模块导入时自动扩展 `Response` 原型，添加事件流方法
 - **📋 SSE 解析**：根据规范解析服务器发送事件，包括数据、事件、ID 和重试字段
 - **🔄 流支持**：正确处理分块数据和多行事件
 - **💬 注释处理**：正确忽略注释行（以 `:` 开头的行）
 - **🛡️ TypeScript 支持**：完整的 TypeScript 类型定义
 - **⚡ 性能优化**：高效的解析和流处理，适用于高性能应用
+- **🤖 LLM 流准备就绪**: 原生支持来自流行 LLM API（如 OpenAI GPT、Claude 等）的流式响应
 
 ## 🚀 快速开始
 
@@ -35,6 +36,24 @@ pnpm add @ahoo-wang/fetcher-eventstream
 yarn add @ahoo-wang/fetcher-eventstream
 ```
 
+### 模块导入
+
+要使用事件流功能，您需要导入模块以执行其副作用：
+
+```typescript
+import '@ahoo-wang/fetcher-eventstream';
+```
+
+此导入会自动扩展 `Response` 接口以处理服务器发送事件流：
+
+- `eventStream()` - 将带有 `text/event-stream` 内容类型的响应转换为 `ServerSentEventStream`
+- `jsonEventStream<DATA>()` - 将带有 `text/event-stream` 内容类型的响应转换为 `JsonServerSentEventStream<DATA>`
+- `isEventStream` getter - 检查响应是否具有 `text/event-stream` 内容类型
+- `requiredEventStream()` - 获取 `ServerSentEventStream`，如果不可用则抛出错误
+- `requiredJsonEventStream<DATA>()` - 获取 `JsonServerSentEventStream<DATA>`，如果不可用则抛出错误
+
+这是 JavaScript/TypeScript 中常见的模式，用于在不修改原始类型定义的情况下扩展现有类型的功能。
+
 ### 集成测试示例：带事件流的 LLM 客户端
 
 以下示例展示了如何创建带事件流支持的 LLM 客户端，类似于 Fetcher
@@ -59,10 +78,8 @@ import {
   post,
   ResultExtractors,
 } from '@ahoo-wang/fetcher-decorator';
-import {
-  EventStreamInterceptor,
-  JsonServerSentEventStream,
-} from '@ahoo-wang/fetcher-eventstream';
+import '@ahoo-wang/fetcher-eventstream';
+import { JsonServerSentEventStream } from '@ahoo-wang/fetcher-eventstream';
 import { ChatRequest, ChatResponse } from './types';
 
 export const llmFetcherName = 'llm';
@@ -95,7 +112,6 @@ export function createLlmFetcher(options: LlmOptions): NamedFetcher {
     },
   });
   llmFetcher.interceptors.request.use(new LlmRequestInterceptor(options));
-  llmFetcher.interceptors.response.use(new EventStreamInterceptor());
   return llmFetcher;
 }
 
@@ -106,14 +122,14 @@ export function createLlmFetcher(options: LlmOptions): NamedFetcher {
 export class LlmClient {
   @post('/completions')
   streamChat(
-    @body() _body: ChatRequest,
+    @body() body: ChatRequest,
   ): Promise<JsonServerSentEventStream<ChatResponse>> {
-    throw autoGeneratedError();
+    throw autoGeneratedError(body);
   }
 
   @post('/completions', { resultExtractor: ResultExtractors.Json })
-  chat(@body() _body: ChatRequest): Promise<ChatResponse> {
-    throw autoGeneratedError();
+  chat(@body() body: ChatRequest): Promise<ChatResponse> {
+    throw autoGeneratedError(body);
   }
 }
 ```
@@ -176,33 +192,27 @@ function updateUI(content: string) {
 }
 ```
 
-### 带拦截器的基本用法
+### 基本用法
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
+import '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://api.example.com',
 });
 
-// 添加事件流拦截器
-fetcher.interceptors.response.use(new EventStreamInterceptor());
-
 // 在响应中使用 eventStream 方法处理 text/event-stream 内容类型
+// Response 对象将自动具有 eventStream() 和 jsonEventStream() 方法
 const response = await fetcher.get('/events');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    console.log('收到事件:', event);
-  }
+for await (const event of response.requiredEventStream()) {
+  console.log('收到事件:', event);
 }
 
 // 使用 jsonEventStream 方法处理 JSON 数据
 const jsonResponse = await fetcher.get('/json-events');
-if (response.jsonEventStream) {
-  for await (const event of response.jsonEventStream<MyDataType>()) {
-    console.log('收到 JSON 事件:', event.data);
-  }
+for await (const event of response.requiredJsonEventStream<MyDataType>()) {
+  console.log('收到 JSON 事件:', event.data);
 }
 ```
 
@@ -230,19 +240,45 @@ try {
 
 ## 📚 API 参考
 
-### EventStreamInterceptor
+### 模块导入
+
+要使用事件流功能，您需要导入模块以执行其副作用：
+
+```typescript
+import '@ahoo-wang/fetcher-eventstream';
+```
+
+此导入会自动扩展全局 `Response` 接口以处理服务器发送事件流：
 
-响应拦截器，自动为 `text/event-stream` 内容类型的响应添加 `eventStream()` 方法。
+- `eventStream()` - 将带有 `text/event-stream` 内容类型的响应转换为 `ServerSentEventStream`
+- `jsonEventStream<DATA>()` - 将带有 `text/event-stream` 内容类型的响应转换为 `JsonServerSentEventStream<DATA>`
+- `isEventStream` getter - 检查响应是否具有 `text/event-stream` 内容类型
+- `requiredEventStream()` - 获取 `ServerSentEventStream`，如果不可用则抛出错误
+- `requiredJsonEventStream<DATA>()` - 获取 `JsonServerSentEventStream<DATA>`，如果不可用则抛出错误
 
-#### 用法
+这是 JavaScript/TypeScript 中常见的模式，用于在不修改原始类型定义的情况下扩展现有类型的功能。
+
+在集成测试和实际应用中，此导入对于处理事件流至关重要。例如：
 
 ```typescript
-fetcher.interceptors.response.use(new EventStreamInterceptor());
+import { Fetcher } from '@ahoo-wang/fetcher';
+import '@ahoo-wang/fetcher-eventstream';
+
+const fetcher = new Fetcher({
+  baseURL: 'https://api.example.com',
+});
+
+// Response 对象将自动具有 eventStream() 和 jsonEventStream() 方法
+const response = await fetcher.get('/events');
+// 处理事件流
+for await (const event of response.requiredEventStream()) {
+  console.log('收到事件:', event);
+}
 ```
 
 ### toJsonServerSentEventStream
 
-将 ServerSentEventStream 转换为 JsonServerSentEventStream，用于处理带有 JSON 数据的服务器发送事件。
+将 `ServerSentEventStream` 转换为 `JsonServerSentEventStream<DATA>`，用于处理带有 JSON 数据的服务器发送事件。
 
 #### 签名
 
@@ -325,30 +361,27 @@ type ServerSentEventStream = ReadableStream<ServerSentEvent>;
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
+import '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://api.example.com',
 });
-fetcher.interceptors.response.use(new EventStreamInterceptor());
 
 // 监听实时通知
 const response = await fetcher.get('/notifications');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    switch (event.event) {
-      case 'message':
-        showNotification('消息', event.data);
-        break;
-      case 'alert':
-        showAlert('警报', event.data);
-        break;
-      case 'update':
-        handleUpdate(JSON.parse(event.data));
-        break;
-      default:
-        console.log('未知事件:', event);
-    }
+for await (const event of response.requiredEventStream()) {
+  switch (event.event) {
+    case 'message':
+      showNotification('消息', event.data);
+      break;
+    case 'alert':
+      showAlert('警报', event.data);
+      break;
+    case 'update':
+      handleUpdate(JSON.parse(event.data));
+      break;
+    default:
+      console.log('未知事件:', event);
   }
 }
 ```
@@ -357,24 +390,20 @@ if (response.eventStream) {
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://api.example.com',
 });
-fetcher.interceptors.response.use(new EventStreamInterceptor());
 
 // 跟踪长时间运行的任务进度
 const response = await fetcher.get('/tasks/123/progress');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    if (event.event === 'progress') {
-      const progress = JSON.parse(event.data);
-      updateProgressBar(progress.percentage);
-    } else if (event.event === 'complete') {
-      showCompletionMessage(event.data);
-      break;
-    }
+for await (const event of response.requiredEventStream()) {
+  if (event.event === 'progress') {
+    const progress = JSON.parse(event.data);
+    updateProgressBar(progress.percentage);
+  } else if (event.event === 'complete') {
+    showCompletionMessage(event.data);
+    break;
   }
 }
 ```
@@ -383,25 +412,21 @@ if (response.eventStream) {
 
 ```typescript
 import { Fetcher } from '@ahoo-wang/fetcher';
-import { EventStreamInterceptor } from '@ahoo-wang/fetcher-eventstream';
 
 const fetcher = new Fetcher({
   baseURL: 'https://chat-api.example.com',
 });
-fetcher.interceptors.response.use(new EventStreamInterceptor());
 
 // 实时聊天消息
 const response = await fetcher.get('/rooms/123/messages');
-if (response.eventStream) {
-  for await (const event of response.eventStream()) {
-    if (event.event === 'message') {
-      const message = JSON.parse(event.data);
-      displayMessage(message);
-    } else if (event.event === 'user-joined') {
-      showUserJoined(event.data);
-    } else if (event.event === 'user-left') {
-      showUserLeft(event.data);
-    }
+for await (const event of response.requiredEventStream()) {
+  if (event.event === 'message') {
+    const message = JSON.parse(event.data);
+    displayMessage(message);
+  } else if (event.event === 'user-joined') {
+    showUserJoined(event.data);
+  } else if (event.event === 'user-left') {
+    showUserLeft(event.data);
   }
 }
 ```
@@ -413,17 +438,16 @@ if (response.eventStream) {
 pnpm test
 
 # 运行带覆盖率的测试
-pnpm test --coverage
+pnpm test -- --coverage
 ```
 
 测试套件包括：
 
 - 事件流转换测试
-- 拦截器功能测试
-- 边界情况处理（畸形事件、分块数据等）
+- 边缘情况处理（格式错误的事件、分块数据等）
 - 大事件流的性能测试
 
-## 📋 服务器发送事件规范合规性
+## 📋 服务器发送事件规范兼容性
 
 此包完全实现了 [服务器发送事件规范](https://html.spec.whatwg.org/multipage/server-sent-events.html)：