在实时聊天、金融行情、日志监控等场景中,用户对"即时性"的需求日益强烈。传统一次性数据加载会导致界面卡顿,而流式输出(Streaming)技术通过渐进式内容渲染,实现了数据的"边收边显"。这种技术不仅能降低用户等待焦虑,更能显著减少内存占用。本文将深入解析流式输出的实现原理,并提供可直接落地的代码方案。
流式输出的核心在于分块传输(Chunked Transfer)。与传统一次性加载相比,它像"滴水成溪"般持续接收数据片段,实现即时渲染。
指标 | 传统加载 | 流式输出 |
---|---|---|
内存占用 | 随数据量线性增长 | 固定低位占用 |
首屏时间 | 依赖完整数据 | 毫秒级呈现 |
适用场景 | 静态小数据 | 实时大数据流 |
HTTP/1.1 Chunked Encoding:基础分块传输协议
Server-Sent Events (SSE):服务端单向推送
WebSocket:双向实时通信首选
async function renderStream(url, container) {
try {
const response = await fetch(url);
const reader = response.body.getReader();
const decoder = new TextDecoder("utf-8"); // 显式声明编码
while (true) {
const { done, value } = await reader.read();
if (done) break;
// 安全渲染:避免XSS漏洞
const chunk = escapehtml(decoder.decode(value));
container.insertAdjacentHTML('beforeend', chunk);
// 智能滚动:仅当用户未手动滚动时生效
if (isNearBottom()) container.scrollTop = container.scrollHeight;
}
} catch (err) {
showError("数据流异常,请重试");
}
}
// 简易HTML转义函数
const escapeHtml = str => str.replace(/[&<>]/g,
tag => ({ '&': '&', '<': '<', '>': '>' }[tag]));
关键改进:
添加中文编码声明防止乱码
内置XSS防护机制
智能滚动避免干扰用户
const initSSE = () => {
const eventSource = new EventSource('/api/stream');
eventSource.addEventListener('message', event => {
appendTodom(JSON.parse(event.data).content);
});
// 错误恢复:指数退避重连
eventSource.onerror = () => {
eventSource.close();
setTimeout(initSSE, 2000);
};
};
function StreamView() {
const [chunks, dispatch] = useReducer(
(state, chunk) => [...state, chunk],
[]
);
useEffect(() => {
const controller = new AbortController();
(async () => {
const res = await fetch('/stream', {
signal: controller.signal
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
// 递归优化:避免调用栈溢出
const processChunk = async () => {
const { done, value } = await reader.read();
if (done) return;
dispatch(decoder.decode(value));
setTimeout(processChunk, 0); // 异步调度
};
processChunk();
})();
return () => controller.abort();
}, []);
return (
<div className="stream-view">
{chunks.map((text, i) => (
<Fragment key={i}>{text}</Fragment>
))}
</div>
);
}
<script setup>
import { ref, onMounted, onUnmounted } from 'vue';
const output = ref('');
let controller = null;
onMounted(async () => {
controller = new AbortController();
const res = await fetch('/stream', {
signal: controller.signal
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
while (true) {
const { done, value } = await reader.read();
if (done) break;
// 使用textContent防止XSS
output.value += decoder.decode(value);
}
});
onUnmounted(() => controller?.abort());
</script>
<template>
<div class="stream-output" v-text="output"></div>
</template>
let buffer = "";
let renderTimer = null;
const appendChunk = (chunk) => {
buffer += chunk;
if (!renderTimer) {
renderTimer = requestAnimationFrame(() => {
container.textContent += buffer; // 使用textContent更安全
buffer = "";
renderTimer = null;
});
}
};
加载指示器:首个数据块到达前显示动画
暂停控制:通过AbortController中断流
错误恢复:自动重连+手动刷新按钮
动态内容过滤:必须转义HTML标签(推荐DOMPurify库)
内存管控:设置最长运行时间与数据量阈值
// 内存保护示例
let byteCount = 0;
const MAX_BYTES = 10 * 1024 * 1024; // 10MB上限
// 在循环中检查
byteCount += value.byteLength;
if (byteCount > MAX_BYTES) {
reader.cancel("超出内存限制");
break;
}
const chatSocket = new WebSocket('wss://api.example.com/chat');
chatSocket.onmessage = ({ data }) => {
const { user, text } = JSON.parse(data);
const msgEl = document.createElement('div');
// 安全渲染文本
msgEl.textContent = `${user}: ${text}`;
msgEl.className = 'message-bubble';
chatContainer.appendChild(msgEl);
};
function highlightLogs(chunk) {
const el = document.createElement('div');
el.textContent = chunk;
// 避免正则注入风险
const safeReplace = (text, word, className) => {
const idx = text.indexOf(word);
if (idx === -1) return text;
const before = text.slice(0, idx);
const after = text.slice(idx + word.length);
return `${before}<spantoken interpolation">${className}">${word}</span>${safeReplace(after, word, className)}`;
};
el.innerHTML = safeReplace(chunk, 'ERROR', 'error');
return el;
}
问题现象 | 排查方向 | 工具命令 |
---|---|---|
流提前中断 | 检查服务端Connection头 | curl -iN http://api |
中文乱码 | 确保服务端UTF-8编码 | Chrome网络面板 |
内存泄漏 | 确认取消订阅/AbortController | Memory Profiler |
浏览器调试技巧:
Chrome开发者工具 → Network → 点击流请求 → Response标签实时查看分块
使用curl -N测试SSE服务完整性
流式输出将数据消费主动权交还给客户端,在提升用户体验的同时优化服务端资源分配。随着Web Streams API的全面支持(包括Deno/Node.js),开发者可在全栈范围内实现高效数据管道。建议:
SSE:适用于只读数据流(如股票行情)
Fetch Streaming:简单分块请求场景
WebSocket:双向交互应用(如在线协作)
技术选型应始终平衡实时性要求、数据安全性和设备兼容性,在2023年全球浏览器统计中,90%以上的设备已原生支持ReadableStream。
在react中是单向数据绑定,而在vue和augular中的特色是双向数据绑定。为什么会选择两种不同的机制呢?我猜测是两种不同的机制有不同的适应场景,查了一些资料后,总结一下。
双向数据绑定是非常重要的特性 —— 将JS模型与HTML视图对应,能减少模板编译时间同时提高用户体验。我们将学习在不使用框架的情况下,使用原生JS实现双向绑定 —— 一种为Object.observe
js判断数据类型的多种方法,主要包括:typeof、instanceof、 constructor、 prototype.toString.call()等,下面就逐一介绍它们的异同。
由于js为弱类型语言拥有动态类型,这意味着相同的变量可用作不同的类型。 typeof 运算符返回一个用来表示表达式的数据类型的字符串,目前typeof返回的字符串有以下这些: undefined、boolean、string、number、object、function、“symbol
在js中我们直接这样写typeof obj===‘object’有什么问题呢?发现Array, Object,null都被认为是一个对象了。如何解决这种情况,能保证判断obj是否为一个对象
js要处理十六进制,十进制,字符之间的转换,发现有很多差不多且书写不正确的方法.一个一个实践才真正清楚如何转换,现在来记录一下它们之间转换的方法。
奇数和偶数的判断是数学运算中经常碰到的问题,这篇文章主要讲解通过JavaScript来实现奇偶数的判断。2种判断方法:求余% 、&1
质数又称素数。指在一个大于1的自然数中,除了1和此整数自身外,没法被其他自然数整除的数。比如100以内共25个,js实现代码如下。
JavaScript自动类型转换真的非常常见,常用的一些便捷的转类型的方式,都是依靠自动转换产生的。比如 转数字 : + x 、 x - 0 , 转字符串 : \\\"\\\" + x 等等。现在总算知道为什么可以这样便捷转换。
XML是标准通用标记语言 (SGML) 的子集,非常适合 Web 传输。XML 提供统一的方法来描述和交换独立于应用程序或供应商的结构化数据。 这篇文章主要介绍Js中实现XML和String相互转化
内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!