一次性掌握 Node.js 中 HTTP 请求的艺术:使用已弃用的 Request 库

仓库地址:github.com/request/req...

尽管 request 库已经被弃用,它曾经是 Node.js 中最流行的 HTTP 客户端库之一,以其简单和强大的功能而闻名。在这篇文章中,我们将回顾 request 库的基本用法和一些高级特性,以及谈论它的替代方案。如果你正在维护一个仍然使用 request 的旧项目,或者对历史上的 Node.js 库感兴趣,这篇文章或许能带给你一些启发。

🌐 简易 HTTP 请求

发送一个简单的 GET 请求,并打印出结果,你可以如下操作:

javascript 复制代码
const request = require('request');

request('http://www.google.com', function (error, response, body) {
  console.error('error:', error);
  console.log('statusCode:', response && response.statusCode);
  console.log('body:', body);
});

在这段代码中,我们引入了 request 模块,并调用它来发送一个 GET 请求到 Google 的主页。然后,在回调函数中,我们打印出错误信息(如果有的话)、响应的状态码以及响应体。

🔄 重定向处理

request 默认会跟随 3xx 响应的重定向。如果你想要改变这一行为,可以调整相应的选项:

javascript 复制代码
request({
  url: 'http://some.url',
  followRedirect: false
}, function (error, response, body) {
  if (!error && response.statusCode == 302) {
    console.log('The resource has been moved to ' + response.headers.location);
  }
});

在这个例子中,如果遇到了一个 302 重定向响应,request 将不会自动跟随重定向。我们可以通过 response.headers.location 访问新的资源位置。

🖥️ 处理流

request 也支持请求和响应的流式处理。这使得将数据流向文件或从文件流向请求变得简单。

javascript 复制代码
const fs = require('fs');

// 流式下载图片
request('http://google.com/doodle.png').pipe(fs.createWriteStream('doodle.png'));

// 流式上传文件
fs.createReadStream('file.json').pipe(request.put('http://mysite.com/obj.json'));

上面的代码示例一部分展示了如何将网上的图片下载并保存到本地文件中,另一部分则是将本地的文件上传到服务器。

🔒 HTTPS和SSL

对于需要使用 HTTPS 或者需要 SSL/TLS 协议参数的请求,request 提供了多种配置方法:

javascript 复制代码
const fs = require('fs');
const https = require('https');

const options = {
  url: 'https://secure.example.com',
  agentOptions: {
    ca: fs.readFileSync('./ca.pem')
  }
};

request(options, function(err, res, body) {
  if (!err && res.statusCode == 200) {
    console.log(body);
  }
});

在这里,我们为 HTTPS 请求配置了 agentOptions,其中包括一个 SSL 证书认证。

🍪 使用Cookie

request 提供了对 cookie 的处理能力,可以使用内置的 cookie jar 管理 cookie。

javascript 复制代码
const request = require('request').defaults({ jar: true });

request('http://www.google.com', function () {
  // 自此,随后对 google.com 的请求会携带之前设置的 cookies
  request('http://www.google.com/preferences');
});

在这个例子中,我们启动了一个带有 cookie jar 的 request 实例,它将自动处理 cookie 的发送和接收。

💣 异常和超时处理

处理异常和正确配置超时是任何网络相关操作中不可忽视的一环:

javascript 复制代码
request('http://some.url/that/may/not/exist', {timeout: 5000}, function (err, res, body) {
  if (err && err.code === 'ETIMEDOUT') {
    console.error('Request has been timed out.');
  } else {
    console.log(body);
  }
});

如果在5秒钟内没有得到响应,上述请求将会超时。

request 库虽然已不再维护,但它的设计理念和实现细节仍然具有参考价值。如今有许多替代库,如 axiosfetchgot 等,它们提供了类似或更好的功能和性能。

了解 request 的用法对于迁移旧代码以及理解现代 Node.js HTTP 请求库的设计亦有实际意义。记住,在开始新项目时,最好选择活跃维护的库。

相关推荐
郏国上2 小时前
图片上传阿里云
阿里云·node.js·云计算
tryCbest7 小时前
Linux使用Docker部署Node.js+Express+SQLite项目
docker·centos·node.js
GISer_Jing10 小时前
LLM对话框项目技术栈&重难点总结
前端·ai·node.js
用户25191624271111 小时前
Node之单表基本查询
前端·javascript·node.js
谢尔登12 小时前
【Node.js】为什么擅长处理 I/O 密集型应用?
node.js
郏国上12 小时前
node.js上传图片接口
开发语言·node.js
星空下的曙光12 小时前
Node.js zlib模块所有 API 详解 + 常用 API + 使用场景
node.js
闫辉16 小时前
HackerNews 播客生成器
node.js·js
Rhys..16 小时前
JS - npm init
开发语言·javascript·npm
夏天想17 小时前
复制了一个vue的项目然后再这个基础上修改。可是通过npm run dev运行之前的老项目,发现运行的竟然是拷贝后的项目。为什么会这样?
前端·vue.js·npm