使用stream-http构建强大的浏览器端HTTP应用

使用stream-http构建强大的浏览器端HTTP应用

项目地址:https://gitcode.com/gh_mirrors/st/stream-http

stream-http 是一个专为浏览器设计的实现Node.js原生http模块的库。它尽力保持与Node.js接口和行为的一致性，尽管有些特性在浏览器环境中无法实现。

这个项目受到了http-browserify的启发，旨在替代其成为浏览器环境中的首选HTTP解决方案。

项目简介

stream-http的核心特性是尽可能地在请求完成前提供数据流。在支持回压的浏览器中（如Chrome 58以上版本），它可以按需从服务器拉取数据，避免了不必要的内存压力。

对于支持真正流式处理的浏览器（如Chrome 43+ 和Firefox 9+），数据可以小批量地存储，减少内存占用。对于其他浏览器，虽然也能提前获取数据，但整个响应仍会暂存在内存中。

技术剖析

这个模块实现了http.request、http.get以及大部分http.ClientRequest和http.IncomingMessage的方法，还有http.METHODS和http.STATUS_CODES。它的目标是提供与Node.js相仿的API，尽管由于浏览器限制无法做到完全相同。

此外，stream-http还提供了与Node.js不同的额外功能：

• message.url属性可访问经过所有重定向后的最终URL，这对于浏览器自动处理重定向的情况非常有用。
• options.withCredentials布尔值，用于指示浏览器是否在跨域请求时发送cookie或认证信息，默认为false。

应用场景

无论是在实时数据传输的Web应用中，还是在需要高效处理大量HTTP请求的场景下，stream-http都是一个理想的选择。尤其在处理大文件上传下载、实时流媒体或者复杂网络交互时，其优势尤为明显。

项目特点

• 兼容性广 - 支持多种浏览器，包括Chrome、Firefox等主流浏览器，以及部分旧版IE浏览器。
• 智能模式选择 - 提供多种模式以适应不同需求，如默认模式、允许错误的Content-Type、优先流式处理等。
• 超时设置 - 可设置请求超时时间，控制请求耗时。
• 数据预读 - 在请求结束前提供部分数据，提高效率。
• 安全特性 - 遵循严格的规则，防止不安全的选项，例如限制特定头的设置。

示例代码

http.get('/bundle.js', function (res) {
	var div = document.getElementById('result');
	div.innerHTML += 'GET /beep<br>';

	res.on('data', function (buf) {
		div.innerHTML += buf;
	});

	res.on('end', function () {
		div.innerHTML += '<br>__END__';
	});
})

测试验证

项目包含了针对Node.js环境和浏览器环境的测试，通过npm test可运行完整的测试，而针对Sauce Labs的浏览器测试则需要注册Sauce Labs账户并配置.airtaprc文件。若要仅运行Node.js测试，执行npm run test-node；要本地运行浏览器测试，则运行npm run test-browser-local。

许可证

该项目遵循MIT许可证，由John Hiesey和其他贡献者共同创作。

使用stream-http，让您的浏览器端HTTP应用程序更加强大、高效且易于管理。立即开始探索这个奇妙的开源项目吧！

stream-http Streaming node http in the browser 项目地址: https://gitcode.com/gh_mirrors/st/stream-http