快捷導(dǎo)航

Node.js進行http/https請求和下載的實現(xiàn)實例

更新時間：2025年09月11日 11:06:40 作者：卿·靜

本文將介紹使用使用 Node.js 的 https 模塊和 fs 模塊實現(xiàn)了三個 HTTP 請求的功能,分別展示了如何通過 HTTPS 發(fā)起 GET 請求獲取 JSON 數(shù)據(jù)、發(fā)送帶有請求頭的 POST 請求,以及下載圖片并保存到本地,

本文將介紹如何使用使用 Node.js 的 https 模塊和 fs 模塊實現(xiàn)了三個 HTTP 請求的功能。分別展示了如何通過 HTTPS 發(fā)起 GET 請求獲取 JSON 數(shù)據(jù)、發(fā)送帶有請求頭的 POST 請求，以及下載圖片并保存到本地。以下是對每個部分的詳細說明。

1. 引入必要的模塊

const http = require("http");   // 用于發(fā)起HTTP請求
const https = require("https"); // 用于發(fā)起HTTPS請求
const fs = require("fs");       // 用于文件操作（如保存圖片）

http模塊：Node.js內(nèi)置的一個核心模塊，可用于創(chuàng)建HTTP服務(wù)器或發(fā)起HTTP客戶端請求。
https模塊：這是Node.js內(nèi)置的模塊，專門用于處理HTTPS協(xié)議的網(wǎng)絡(luò)請求。與http模塊相比，https模塊支持SSL/TLS加密，確保數(shù)據(jù)傳輸?shù)陌踩浴?/li>
fs模塊：用于文件系統(tǒng)的操作，例如創(chuàng)建文件流以保存下載的圖片。

下面的代碼例子將使用 https 模塊發(fā)送請求，如需發(fā)送 http 請求，可將代碼中的 https 換成 http。

2. GET請求獲取JSON數(shù)據(jù)

功能描述

通過HTTPS發(fā)起一個GET請求，從jsonplaceholder.typicode.com/posts/5獲取指定ID的文章數(shù)據(jù)，并將返回的JSON數(shù)據(jù)解析后輸出到控制臺。

核心代碼分析

const get_options = {
  hostname: "jsonplaceholder.typicode.com", // 目標服務(wù)器域名
  port: 443, // HTTPS 默認端口號為443  HTTP默認端口號為80
  path: "/posts/5", // 請求路徑，獲取 ID 為 5 的文章
  method: "GET", // 請求方法
};

//創(chuàng)建請求
const get_req = https.request(get_options, (res) => {
  let data = "";

  res.on("data", (chunk) => {
    data += chunk; // 將響應(yīng)數(shù)據(jù)片段拼接到變量中
  });

  res.on("end", () => {
    const jsonData = JSON.parse(data); // 解析 JSON 數(shù)據(jù)
    console.log(jsonData); // 輸出解析后的 JSON 對象
  });
});

get_req.on("error", (error) => {
  console.error(`Problem with request: ${error.message}`); // 處理請求錯誤
});

get_req.end(); // 發(fā)送請求

參數(shù)說明

hostname: 指定目標服務(wù)器的域名，這里是jsonplaceholder.typicode.com。
port: HTTPS 協(xié)議默認使用的端口是443。
path: 請求的具體路徑，/posts/5表示獲取ID為5的文章。
method: 請求方法，這里使用GET。
https.request: 創(chuàng)建一個HTTPS請求對象。
res.on('data', callback): 監(jiān)聽響應(yīng)數(shù)據(jù)流，每次接收到數(shù)據(jù)片段時觸發(fā)回調(diào)函數(shù)。
res.on('end', callback): 當所有數(shù)據(jù)接收完畢時觸發(fā)回調(diào)函數(shù)。
JSON.parse(data): 將接收到的字符串形式的JSON數(shù)據(jù)解析為JavaScript對象。
get_req.end(): 發(fā)送請求， Node.js會開始監(jiān)聽服務(wù)器的響應(yīng)，并依次觸發(fā)data、end等事件。

3. POST請求發(fā)送JSON數(shù)據(jù)

功能描述

構(gòu)造一個POST請求，向jsonplaceholder.typicode.com/posts發(fā)送JSON數(shù)據(jù)。展示了如何設(shè)置請求頭（如Content-Type和Content-Length），并將JSON數(shù)據(jù)作為請求體發(fā)送。

核心代碼分析

const post_options = {
  hostname: "jsonplaceholder.typicode.com",
  port: 443,
  path: "/posts",
  method: "POST",
  Headers: { // 設(shè)置請求頭
    "Content-Type": "application/json", // 指定請求體類型為 JSON
    "Content-Length": Buffer.byteLength(
      JSON.stringify({
        userId: 1,
        title: "hello world",
        body: "你好",
      })
    ),
  },
};

const post_req = https.request(post_options, (res) => {
  let data = "";

  res.on("data", (chunk) => {
    data += chunk;
  });

  res.on("end", () => {
    const jsonData = JSON.parse(data);
    console.log(jsonData);
  });
});

post_req.on("error", (error) => {
  console.error(`Problem with request: ${error.message}`);
});

post_req.end();

參數(shù)說明

Headers: 設(shè)置請求頭信息。
- Content-Type: 指定請求體的MIME類型為application/json。
- Content-Length: 指定請求體的字節(jié)長度，使用Buffer.byteLength計算。
JSON.stringify: 將JavaScript對象序列化為JSON字符串。
Buffer.byteLength: 計算字符串的字節(jié)長度。

4. 下載圖片并保存到本地

功能描述

通過HTTPS發(fā)起一個GET請求，從cdn2.thecatapi.com/images/2OKotXbFe.jpg下載一張貓的圖片，并將其保存到本地文件系統(tǒng)。

核心代碼分析

const img_options = {
  hostname: "cdn2.thecatapi.com",
  port: 443,
  path: "/images/2OKotXbFe.jpg",
  method: "GET",
};

const img_req = https
  .request(img_options, (res) => {
    if (res.statusCode !== 200) {
      console.error(`Failed to fetch image, status code: ${res.statusCode}`);
      res.resume(); // 消耗響應(yīng)數(shù)據(jù)以釋放內(nèi)存
      return;
    }

    const filePath = "./cat_image.jpg";
    const fileStream = fs.createWriteStream(filePath);

    res.pipe(fileStream);

    fileStream.on("finish", () => {
      fileStream.close(() => {
        console.log("Image saved successfully.");
      });
    });
  })
  .on("error", (err) => {
    console.error(`Error downloading image: ${err.message}`);
  });

img_req.end();