Node.js / 系统课时

发起 HTTP 请求

发起 HTTP 请求

这一节用 Node.js 内置 node:https 调用一个公开 JSON 接口,完整处理请求参数、状态码、响应头和分块响应体。完成后你会得到一个能直接运行的客户端,并知道为什么“收到 response 回调”不等于“响应数据已经接收完”。

学习目标

  • 能用 https.request() 发送 GET 请求并正确结束请求。
  • 能读取 statusCode、响应头和分块数据,并在 end 事件后解析 JSON。
  • 能处理非 2xx、网络错误和超时,避免请求一直悬挂。

请求和响应是两个阶段

https.request() 先返回 ClientRequest,调用 req.end() 后请求才真正结束发送;服务器返回时,回调拿到的是 IncomingMessage。状态码和响应头此时已经可读,但响应体仍会通过多个 data 事件到达,必须等 end 事件后再把完整内容当作 JSON 解析。

Node.js HTTPS 请求与分块响应的时序关系

这种分阶段结构很重要:不要假设一次 data 就能拿到完整 JSON。即使接口只返回几百字节,TCP/TLS 和流缓冲仍可能让数据分多次到达;正确做法是收集所有 Buffer,在 end 中合并后再解析。

用 https.request 调用 JSON 接口

下面示例请求 JSONPlaceholder 的 /todos/1。保存为 request.mjs,Node.js 22+ 可直接运行。代码只输出 HTTP 状态码、规范化后的 content-type 和待办事项的 id、completed,便于直接核对结果。

js
import https from 'node:https';

const options = {
  hostname: 'jsonplaceholder.typicode.com',
  port: 443,
  path: '/todos/1',
  method: 'GET',
  headers: {
    Accept: 'application/json',
    'User-Agent': 'nodejs-basics-demo'
  }
};

const req = https.request(options, (res) => {
  const status = res.statusCode ?? 0;
  const contentType = String(res.headers['content-type'] ?? '').split(';')[0];
  console.log(`status=${status}`);
  console.log(`content-type=${contentType}`);
  const chunks = [];
  res.on('data', (chunk) => chunks.push(chunk));
  res.on('end', () => {
    const body = Buffer.concat(chunks).toString('utf8');
    if (status < 200 || status >= 300) {
      console.error(`request failed: ${body.slice(0, 200)}`);
      process.exitCode = 1;
      return;
    }
    try {
      const todo = JSON.parse(body);
      console.log(`todo=${todo.id} completed=${todo.completed}`);
    } catch (error) {
      console.error(`invalid json: ${error.message}`);
      process.exitCode = 1;
    }
  });
});

req.setTimeout(5000, () => {
  req.destroy(new Error('request timeout'));
});
req.on('error', (error) => {
  console.error(`network error: ${error.message}`);
  process.exitCode = 1;
});
req.end();

预期输出

text
status=200
content-type=application/json
todo=1 completed=false

req.end() 不能漏掉;对 GET 来说它通常不写请求体,但它明确告诉 Node.js 请求已经发送完毕。若改成 POST,再使用 req.write() 发送请求体,也仍要调用 req.end() 收尾。

按状态码、响应头和超时做判断

只要建立了 HTTP 连接,404 或 500 仍然会进入响应回调,因此不能只监听 error。实际代码通常先判断 2xx,再解析业务数据;error 主要处理 DNS、连接被拒绝、TLS 或被 req.destroy() 主动终止等网络级失败。

响应头也应参与判断。示例先取 content-type,再解析 JSON;在更严格的客户端中,可先确认它以 application/json 开头,否则把正文当普通文本记录。这样能避免上游网关返回 HTML 错误页时直接触发难定位的 JSON.parse() 异常。

5 秒超时通过 req.setTimeout(5000) 实现;回调里调用 req.destroy() 才会真正终止请求。公网接口还可能因 DNS、代理、防火墙或服务限流失败,所以生产代码应把“HTTP 非成功状态”和“网络错误”分开记录,而不是统一写成一个“请求失败”。

什么时候改用 fetch

Node.js 22+ 也提供全局 fetch(),对普通 JSON API 更简洁:await fetch() 后可直接读取 response.status、response.headers 与 response.json()。不过 https.request() 更适合理解底层请求生命周期,也便于直接控制 ClientRequest、监听流事件或接入现有基于 Node.js Streams 的代码。

如果业务只是调用 REST API,通常优先使用 fetch();如果需要精细控制请求流、底层事件或与现有 ClientRequest 代码兼容,再选择 http.request() / https.request()。无论使用哪种接口,都要保留状态码判断、超时策略和响应格式验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

发起 HTTP 请求

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通