Node.js 的 https 模块介绍

前言

https 模块是 Node.js 内置的一个模块，它用于创建 HTTPS 服务器或客户端，支持 HTTPS请求和响应的处理和操作。HTTPS 是 HTTP 协议在 TLS/SSL 协议上的封装，它可以提供数据的加密、身份验证和完整性保护。

如何使用 https 模块？

使用 https 模块的方法，比如创建一个 HTTPS 服务器，可以使用 https.createServer() 方法，如下：

const https = require('https');
const fs = require('fs');

const options = {
  key: fs.readFileSync('server-key.pem'),
  cert: fs.readFileSync('server-cert.pem')
};

https.createServer(options, (req, res) => {
  res.writeHead(200);
  res.end('hello world\n');
}).listen(8000);

这个例子中，我们使用了 fs 模块读取了服务器的私钥和证书，

• 然后传递给 https.createServer() 方法的 options 参数。 这个方法返回一个 https.Server 实例，它是一个 EventEmitter，可以监听请求事件，回调函数接受两个参数，分别是 req 和 res，表示请求和响应对象。
• 我们可以在回调函数中设置响应头和响应内容，然后调用 res.end() 方法结束响应。 最后，我们调用 listen() 方法让服务器监听 8000 端口。

如果我们想创建一个 HTTPS 客户端，可以使用 https.request() 方法，如下：

const options = {
  hostname: 'example.com',
  port: 443,
  path: '/',
  method: 'GET'
};

const req = https.request(options, res => {
  console.log('statusCode:', res.statusCode);
  console.log('headers:', res.headers);

  res.on('data', d => {
    process.stdout.write(d);
  });
});

req.on('error', e => {
  console.error(e);
});

req.end();

这个例子中，我们传递了一个 options 对象给 https.request() 方法，指定了目标服务器的主机名、端口、路径和方法。

• 这个方法返回一个 https.ClientRequest 实例，它是一个可写流，可以用来发送请求体。
• 监听它的响应事件，回调函数接受一个参数，即 res，表示响应对象。
• 从 res 中获取响应的状态码、头部和数据，然后处理它们。
• 监听请求对象的错误事件，以便捕获可能发生的异常。
• 最后，调用 req.end() 方法结束请求。

https 模块有哪些常用的方法和类？

https 模块有很多方法和类，我们无法在这里一一介绍，但是我们可以列举一些常用的方法和类，如下：

• https.createServer() 和 https.Server：用于创建 HTTPS 服务器，返回一个 https.Server 实例，它继承自 http.Server，可以监听 request、connection、close 等事件，也可以使用 close()、listen()、setTimeout() 等方法。
• https.request() 和 https.get()：用于创建 HTTPS 客户端，返回一个 https.ClientRequest 实例，它继承自 http.ClientRequest，可以监听 response、error、abort 等事件，也可以使用 write()、end()、abort() 等方法。https.get() 是 https.request() 的简化版，只用于发送 GET 请求。
• https.Agent 和 https.globalAgent：用于管理 HTTPS客户端的连接池，可以复用和销毁连接，提高性能。https.Agent是一个类，可以创建自定义的代理对象，https.globalAgent 是一个默认的代理对象，可以被共享使用。
• https.ServerResponse 和 https.IncomingMessage：用于表示 HTTPS服务器和客户端的响应和请求对象，它们分别继承自 http.ServerResponse 和 http.IncomingMessage，可以获取和设置响应和请求的头部、状态码、内容等。

总结

https 模块是 Node.js 的一个重要的模块，它可以让我们在 Node.js 中创建和使用 HTTPS 服务，实现数据的安全传输，提高用户的信任度。https 模块提供了一些简单易用的方法和类，让我们可以方便地创建 HTTPS 服务器和客户端，处理 HTTPS 请求和响应，管理 HTTPS 连接等。