learnyounode HTTP CLIENT 练习实战:用 `http.get()` 与响应流事件编写 Node.js HTTP 客户端

原创2026-09-28 21:51:231,923 阅读
文章标签:教程CLI

learnyounode HTTP CLIENT 练习实战:用 http.get() 与响应流事件编写 Node.js HTTP 客户端

本篇技术指南围绕 learnyounode 仓库中的 HTTP CLIENT 练习(韩文版说明见 exercises/http_client/problem.ko.md,英文原版见 exercises/http_client/problem.md)展开,完整讲解如何用 Node.js 内置的 http 核心模块编写一个接收命令行 URL 参数、发起 HTTP GET 请求并把响应内容逐行输出到 stdout 的命令行程序。读完本文,你将掌握 http.get() 的调用签名与回调形态、Node 流对象(Stream)的事件模型(data / error / end)、setEncoding() 的用法,以及 learnyounode 如何自动起一个测试 HTTP 服务器来校验你的代码。

练习目标:第一个真正的 HTTP 客户端

该练习要求你创建一个 http-client.js 文件,编写一个程序:

  • 对命令行第一个参数传入的 URL 发起 HTTP GET 请求;
  • 从响应中读取字符串内容,并把 每一次 "data" 事件的字符串内容各占一行输出到控制台(stdout)。

也就是说,响应体被分成多个数据块(chunk)到达时,每一块都要单独打一行,而不是等到全部接收完毕再一次性输出。这要求你以事件驱动的方式消费响应,而不是同步地"取回整个响应体"。

前置知识:http 核心模块

本练习明确指定使用 Node.js 的 http 核心模块,无需安装任何第三方依赖。仓库为此在 docs-nodejs/http.html 中随项目内置了一份 Node.js v12.10.0 的官方 http 模块文档快照,方便学习者在本地随时查阅 http.get()、http.request()、响应对象等 API 细节。

从仓库结构上看,该练习属于 learnyounode 的第七个关卡(见 learnyounode.js 中 addAll 列表的 'HTTP CLIENT' 条目),它承接了前面基于 fs、path 的 I/O 练习,是整套课程里第一个真正面向网络编程(TCP/HTTP)的关卡,为后续的 HTTP COLLECT、JUGGLING ASYNC、TIME SERVER、HTTP FILE SERVER、HTTP UPPERCASERER 和 HTTP JSON API SERVER 等网络练习打下基础。

使用 http.get() 发起 GET 请求

http.get() 是 Node.js 对"简单 GET 请求"的便捷封装:它等价于 http.request() 并在内部自动调用 req.end(),因此不需要手动结束请求。它的两个参数是:

参数 含义
第一个参数 要 GET 的 URL,通常是 http://host:port/path 形式的字符串
第二个参数 回调函数,在收到响应时被调用

与普通的 Node 回调风格(function (err, result))不同,http.get() 的回调签名是:

function callback (response) { /* ... */ }

回调的唯一参数 response 就是服务端返回的响应对象。注意这里没有 err 参数,错误不是通过回调的第一参数传递的,而是通过返回的请求对象和 response 流上派发的 "error" 事件来传递(后文会展开)。

理解 response 对象:Node 流与事件

response 对象是一个 Node Stream(流) 对象。流是"可以像事件发射器一样对待"的对象——它会在数据到达、出错、结束时向外派发事件。对于本练习,最值得关注的事件有三个:

事件 触发时机
"data" 有一块数据可用且可处理时触发,回调收到当前数据块
"error" 传输过程中发生错误时触发
"end" 响应数据全部接收完毕、流结束时触发

监听事件的标准写法:

response.on('data', function (data) { /* ... */ })

"data" 事件是流的核心:每当底层数据源送来一块数据,回调就会执行一次。数据块的大小取决于底层数据源——网络包的大小、服务器端的写入节奏等都会影响每一块数据的字节数,因此你无法预先假定每块数据对应一行文本,这正是练习要求"每个 data 事件单独输出一行"的原因:它考验的是对事件粒度的直接感知。

setEncoding('utf8'):让 data 事件直接给出字符串

默认情况下,"data" 事件回调收到的 data 是 Node 的 Buffer 对象(二进制数据),需要手动调用 data.toString() 之类的方法才能转成字符串。但 http.get() 返回的 response 流自带 setEncoding() 方法:

response.setEncoding('utf8')

以 "utf8" 调用该方法后,"data" 事件就会直接派发 String,而不是 Buffer,省去显式转换的步骤,代码更简洁、输出更直接。

参考解答

仓库在 exercises/http_client/solution/solution.js 中给出了官方参考解答,仅 8 行,把本练习的四个知识点全部浓缩其中:

'use strict'
const http = require('http')

http.get(process.argv[2], function (response) {
  response.setEncoding('utf8')
  response.on('data', console.log)
  response.on('error', console.error)
}).on('error', console.error)

逐行拆解:

  • process.argv[2]:命令行第一个参数,即练习传入的 URL;
  • http.get(url, callback):发起 GET 请求;
  • response.setEncoding('utf8'):让后续 "data" 事件直接产出字符串;
  • response.on('data', console.log):把每个数据块各占一行打印到 stdout——console.log 自带换行,恰好满足"每个 data 事件输出到新行"的要求;
  • response.on('error', console.error):打印响应流上的错误;
  • .on('error', console.error):请求对象本身也可能出错(如 DNS 解析失败、连接被拒绝),因此需要在 http.get() 返回的请求对象上再挂一个错误监听,形成双重防御。

一个等价但显式声明回调函数的变体(对应测试文件 test/http_client/valid_01.js 中的写法)如下,它把响应处理逻辑抽成具名函数,逻辑完全一致:

require('http').get(process.argv[2], processResponse)

function processResponse (res) {
  res.setEncoding('utf8')
  res.on('data', console.log)
  res.on('error', console.error)
}

仓库如何校验你的程序

测试服务器的设计:考验时序的事件驱动

本练习的验证逻辑在 exercises/http_client/exercise.js 中实现,值得深读。它用 http.createServer() 起一个本地测试服务器,然后通过 setTimeout 以 每 25 毫秒一个词 的节奏把 lib/words.js 中的单词逐个 res.write() 出去,全部写完才 res.end():

;(function next (i) {
  if (i === words.length) {
    return res.end()
  }
  res.write(words[i].trim())
  setTimeout(next.bind(null, i + 1), 25)
}(0))

这个设计的用意在于:响应体不是一次性送达的,而是被刻意拆成多个小块、跨时间片发送。只有正确监听 "data" 事件并逐块输出的程序,才能忠实地把每一块内容各自打成一行;如果只是等待 "end" 后一次性拼接再输出,行为就会与预期不一致。也就是说,这个测试服务器本身就在逼你采用事件驱动的流式消费方式。

测试单词来自 lib/words.js,它从 boganipsum 依赖中取词并随机抽取 10 个。服务器监听随机端口后,把完整 URL(http://localhost:<port>)作为命令行第一个参数传给被验证的子进程:

this.submissionArgs = [url]
this.solutionArgs = [url]

同时,服务器在处理完验证后由 exercise.addCleanup 负责关闭,确保测试进程不会悬挂。

运行与验证方式

在 learnyounode 交互菜单中选中 HTTP CLIENT(韩文界面中显示为"HTTP 클라이언트",见 i18n/ko.json),然后创建 http-client.js 并执行验证命令:

$ learnyounode verify http-client.js

验证器会同时运行你的程序和官方解答,并比较两者的输出。如果每个 "data" 事件的内容没有各自换行、或错误处理不完整(比如请求对象上的 "error" 监听缺失导致连接失败时进程崩溃),都会导致 FAIL 并给出失败原因。此外也可以用 node http-client.js <url> 直接手动运行你的程序来观察输出效果。

延伸:这是整个 HTTP 练习系列的第一环

理解本练习的流事件模型后,可以顺势挑战后续关卡:

  • HTTP COLLECT(exercises/http_collect/problem.md):反过来要把多个 "data" 块拼成完整响应体再输出,需要自己管理累计缓冲,涉及对 end 事件的配合使用;
  • JUGGLING ASYNC(exercises/juggling_async/problem.md):并发请求多个 URL 并按顺序输出结果,把事件驱动与异步协调组合起来;
  • 之后的 TIME SERVER、HTTP FILE SERVER 等则切换到服务器端,用 http.createServer() 与 net 模块编写服务程序。

这些练习与本关卡共同构成 learnyounode 网络编程训练的完整链条(课程全貌见 learnyounode.js)。

登录后查看全文
learnyounode