更新记录

1.0.1（2026-09-10）

明文 HTTP 改为全局放行

1.0.0（2026-09-10）

首次发布

平台兼容性

uni-app(5.0)

uni-app x(5.0)

nj-sse-request

iOS / Android 原生 SSE 客户端。uni.request 无法持续接收 text/event-stream，本插件用原生长连接把事件逐条回传给 JS。

仅支持 App 端 vue / nvue，不支持 H5、小程序、鸿蒙。Android 最低 8.0（API 26），iOS 最低 15.0。首次使用需制作包含本插件的自定义基座。

使用

import { startSSE, stopSSE } from '@/uni_modules/nj-sse-request'

const requestId = startSSE({
  url: 'https://example.com/events',
  authorization: 'Bearer token',
  connectTimeout: 15000,
  open: ({ statusCode }) => {
    console.log('connected', statusCode)
  },
  event: ({ event, data, lastEventId }) => {
    console.log(event, lastEventId, data)
  },
  fail: ({ errCode, statusCode, errMsg }) => {
    console.error(errCode, statusCode, errMsg)
  },
  complete: () => {
    console.log('closed')
  },
})

stopSSE(requestId)

页面卸载或不再需要数据时务必调用 stopSSE。

API

startSSE(options)

发起 GET 请求，返回 requestId。

event 回调里的 data 是原始字符串，需要自行 JSON.parse。

stopSSE(requestId)

主动关闭指定连接。

错误码

说明

• 仅 GET，不支持 POST body
• 解析标准 SSE：event / data / id、多行 data、注释心跳、分包
• 响应必须是 text/event-stream
• 明文 HTTP 已全局放行（iOS ATS NSAllowsArbitraryLoads，Android usesCleartextTraffic）