zlib 模块可以用来实现对 [HTTP] 中定义的 gzip 和 deflate 内容编码机制的支持。

    HTTP 的 [Accept-Encoding] 消息头用来标记客户端接受的压缩编码。 [Content-Encoding] 消息头用于标识实际应用于消息的压缩编码。

    下面给出的示例大幅简化，用以展示了基本的概念。 使用 zlib 编码成本会很高, 结果应该被缓存。 关于 zlib 使用中有关速度/内存/压缩互相权衡的信息，查阅[内存使用的调整][Memory usage tuning]。

    1. // 客户端请求示例。
    2. const zlib = require('zlib');
    3. const http = require('http');
    4. const fs = require('fs');
    5. const { pipeline } = require('stream');
    7. const request = http.get({ host: 'example.com',
    8.                            path: '/',
    9.                            port: 80,
    10.                            headers: { 'Accept-Encoding': 'br,gzip,deflate' } });
    11. request.on('response', (response) => {
    12.   const output = fs.createWriteStream('example.com_index.html');
    14.   const onError = (err) => {
    15.     if (err) {
    16.       console.error('发生错误:', err);
    17.       process.exitCode = 1;
    18.     }
    19.   };
    21.   switch (response.headers['content-encoding']) {
    22.     case 'br':
    23.       pipeline(response, zlib.createBrotliDecompress(), output, onError);
    24.       break;
    25.     // 或者, 只是使用 zlib.createUnzip() 方法去处理这两种情况：
    26.     case 'gzip':
    27.       pipeline(response, zlib.createGunzip(), output, onError);
    28.       break;
    29.     case 'deflate':
    30.       pipeline(response, zlib.createInflate(), output, onError);
    31.       break;
    32.     default:
    33.       pipeline(response, output, onError);
    34.       break;
    35.   }
    36. });
    1. // 服务端示例。
    2. // 对每一个请求运行 gzip 操作的成本是十分高昂的。
    3. // 缓存已压缩的 buffer 是更加高效的方式。
    4. const zlib = require('zlib');
    5. const http = require('http');
    6. const fs = require('fs');
    7. const { pipeline } = require('stream');
    9. http.createServer((request, response) => {
    10.   const raw = fs.createReadStream('index.html');
    11.   // 存储资源的压缩版本和未压缩版本。
    12.   response.setHeader('Vary', 'Accept-Encoding');
    13.   let acceptEncoding = request.headers['accept-encoding'];
    14.   if (!acceptEncoding) {
    15.     acceptEncoding = '';
    16.   }
    18.   const onError = (err) => {
    19.     if (err) {
    20.       // 如果发生错误，则我们将会无能为力，
    21.       // 因为服务器已经发送了 200 响应码，
    22.       // 并且已经向客户端发送了一些数据。 
    23.       // 我们能做的最好就是立即终止响应并记录错误。
    24.       response.end();
    25.       console.error('发生错误:', err);
    26.     }
    27.   };
    29.   // 注意：这不是一个合适的 accept-encoding 解析器。
    30.   // 查阅 https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.3
    31.   if (/\bdeflate\b/.test(acceptEncoding)) {
    32.     response.writeHead(200, { 'Content-Encoding': 'deflate' });
    33.     pipeline(raw, zlib.createDeflate(), response, onError);
    34.   } else if (/\bgzip\b/.test(acceptEncoding)) {
    35.     response.writeHead(200, { 'Content-Encoding': 'gzip' });
    36.     pipeline(raw, zlib.createGzip(), response, onError);
    37.   } else if (/\bbr\b/.test(acceptEncoding)) {
    38.     response.writeHead(200, { 'Content-Encoding': 'br' });
    39.     pipeline(raw, zlib.createBrotliCompress(), response, onError);
    40.   } else {
    41.     response.writeHead(200, {});
    42.     pipeline(raw, response, onError);
    43.   }
    44. }).listen(1337);

    默认情况下，当解压不完整的数据时 zlib 方法会抛出一个错误。 然而，如果它已经知道数据是不完整的，或者仅仅是为了检查已压缩文件的开头，可以通过改变用来解压最后一个的输入数据块的刷新方法来避免默认的错误处理：

    1. // 这是一个上面例子中 buffer 的不完整版本。
    2. const buffer = Buffer.from('eJzT0yMA', 'base64');
    4. zlib.unzip(
    5.   buffer,
    6.   // 对于 Brotli，等效的是 zlib.constants.BROTLI_OPERATION_FLUSH。
    7.   { finishFlush: zlib.constants.Z_SYNC_FLUSH },
    8.   (err, buffer) => {
    9.     if (err) {
    10.       console.error('发生错误:', err);
    11.       process.exitCode = 1;
    12.     }
    13.     console.log(buffer.toString());
    14.   });

    这不会改变其他抛出错误情况下的行为，例如，当输入内容的格式无效时。 使用这个方法，无法确定输入是否过早结束，或者缺乏完整性检查，因此有必要人工检查解压结果是否有效。