Node.js 文件下载指南

1. 简介

在 Web 应用程序中，文件下载是一个常见的功能。 Node.js 提供了许多方法来实现文件下载，本文将详细介绍如何使用 Node.js 进行文件下载。

2. 使用原生 HTTP 模块下载文件

Node.js 提供了原生的 http 模块，可以使用它来发送 HTTP 请求和接收响应。以下是使用原生 http 模块下载文件的步骤：

2.1 创建 HTTP 请求

首先，我们需要创建一个 HTTP 请求来获取文件。可以使用 http.request() 方法来发送一个 GET 请求。

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

const fileUrl = 'http://example.com/file.txt';
const fileName = 'file.txt';

const request = http.request(fileUrl, (response) => {
  // 处理下载的响应
});

request.end();

在上面的代码中，我们定义了要下载的文件的 URL 和文件名。然后，使用 http.request() 方法创建了一个 HTTP 请求对象，并传入文件的 URL 和一个回调函数来处理响应。

2.2 处理响应

在回调函数中，我们可以使用 response 对象来处理服务器响应。以下是几个常用的方法：

response.on('data', callback)：当接收到新的数据时触发 data 事件，可以在回调函数中进行处理。
response.on('end', callback)：当整个响应接收完成时触发 end 事件，可以在回调函数中进行最后的处理。

我们可以使用 response.pipe() 方法将响应数据流式传输到文件中，实现文件下载：

const request = http.request(fileUrl, (response) => {
  const fileStream = fs.createWriteStream(fileName);
  response.pipe(fileStream);
});

在上面的代码中，我们使用 fs.createWriteStream() 方法创建了一个文件写入流，将响应数据流式传输到文件中。

2.3 错误处理

在下载文件时可能会出现错误，我们可以通过监听 error 事件来处理这些错误：

const request = http.request(fileUrl, (response) => {
  const fileStream = fs.createWriteStream(fileName);
  response.pipe(fileStream);
});

request.on('error', (error) => {
  console.error(`下载文件时出现错误：${error.message}`);
});

request.end();

在上面的代码中，我们通过监听 error 事件来处理下载文件时可能出现的错误。

3. 使用第三方模块下载文件

除了原生的 http 模块，还有一些第三方模块可以简化文件下载的过程。这些模块提供了更高级的接口和功能，使文件下载更加方便。以下是两个常用的第三方模块：

3.1 axios

axios 是一个常用的基于 Promise 的 HTTP 客户端，可以在浏览器和 Node.js 中使用。它提供了简洁的 API 来发送 HTTP 请求，并且支持处理响应流。以下是使用 axios 下载文件的示例代码：

$ npm install axios

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

const fileUrl = 'http://example.com/file.txt';
const fileName = 'file.txt';

axios({
  url: fileUrl,
  method: 'GET',
  responseType: 'stream',
}).then((response) => {
  const fileStream = fs.createWriteStream(fileName);
  response.data.pipe(fileStream);
}).catch((error) => {
  console.error(`下载文件时出现错误：${error.message}`);
});

上面的代码首先使用 axios() 方法发送一个 GET 请求，并且设置 responseType 为 stream，以便处理响应流。然后，将响应流式传输到文件流中。

3.2 node-fetch

node-fetch 是一个轻量级的 HTTP 客户端，可以在 Node.js 中使用。它提供了与浏览器的 fetch API 类似的 API。以下是使用 node-fetch 下载文件的示例代码：

$ npm install node-fetch

const fetch = require('node-fetch');
const fs = require('fs');

const fileUrl = 'http://example.com/file.txt';
const fileName = 'file.txt';

fetch(fileUrl)
  .then((response) => {
    const fileStream = fs.createWriteStream(fileName);
    response.body.pipe(fileStream);
  })
  .catch((error) => {
    console.error(`下载文件时出现错误：${error.message}`);
  });

上面的代码首先使用 fetch() 方法发送一个 GET 请求。然后，将响应流式传输到文件流中。