使用 JSON

如果您是開發人員，您很可能聽過 JSON（JavaScript 物件表示法）。它無所不在！從 API 到設定文件，JSON 是交換資料的首選格式。但是我們如何在 Node.js 中使用它呢？讓我們用簡單的術語來分解它，並用一些現實世界的例子來幫助您。

什麼是 JSON？

簡單來說，JSON是一種用於儲存和交換資料的格式。它易於閱讀和編寫，這使得它在 Web 開發中非常受歡迎。看起來像這樣：

{
  "name": "Alice",
  "age": 25,
  "city": "Wonderland"
}

它基本上是鍵值對的集合，就像 JavaScript 物件一樣。但請記住：JSON 只是文本，需要將其轉換為物件才能在程式碼中使用。

在 Node.js 中解析 JSON

讓我們先取得一個 JSON 字串並將其轉換為我們可以使用的東西——JavaScript 物件。我們使用 JSON.parse().

範例：解析 JSON

const jsonString = '{"name": "Alice", "age": 25, "city": "Wonderland"}';
const jsonObject = JSON.parse(jsonString);

console.log(jsonObject.name); // Output: Alice

這需要一個 JSON 字串，解析它，並將其轉換為 JavaScript 物件。現在您可以存取其屬性，例如姓名、年齡或城市。

將物件轉換為 JSON

如果您需要以 JSON 形式傳送資料怎麼辦？這就是 JSON.stringify() 的用武之地。它會取得 JavaScript 物件並將其轉換為 JSON 字串。

範例：將物件轉換為 JSON

const user = {
  name: "Alice",
  age: 25,
  city: "Wonderland"
};

const jsonString = JSON.stringify(user);
console.log(jsonString);
// Output: {"name":"Alice","age":25,"city":"Wonderland"}

當您建立 API 或將資料儲存為 JSON 時，這非常有用。

在 Node.js 中讀寫 JSON 文件

需要使用 JSON 檔案嗎？ Node.js 透過 fs（檔案系統）模組讓這一切變得簡單。您可以輕鬆地讀寫 JSON 檔案。

範例：讀取 JSON 檔案

const fs = require('fs');

fs.readFile('data.json', 'utf8', (err, data) => {
  if (err) {
    console.error(err);
    return;
  }
  const jsonData = JSON.parse(data);
  console.log(jsonData);
});

這裡，我們使用 fs.readFile() 讀取 JSON 文件，然後將文件內容解析為 JavaScript 物件。現在您可以對數據做任何您想做的事！

範例：寫入 JSON 檔案

const fs = require('fs');

const user = {
  name: "Alice",
  age: 25,
  city: "Wonderland"
};

fs.writeFile('output.json', JSON.stringify(user, null, 2), (err) => {
  if (err) {
    console.error(err);
    return;
  }
  console.log('Data saved to output.json');
});

在這種情況下，JSON.stringify() 將物件轉換為漂亮的格式化 JSON 字串，然後 fs.writeFile() 將其儲存到檔案中。簡單的！

使用 HTTP 請求傳送和接收 JSON

建置 API 時，JSON 是發送和接收資料的首選格式。在 Express.js 中，您可以輕鬆傳送和接收 JSON 資料。

範例：在回應中傳送 JSON

const express = require('express');
const app = express();

app.get('/user', (req, res) => {
  const user = { name: "Alice", age: 25, city: "Wonderland" };
  res.json(user);
});

app.listen(3000, () => console.log('Server running on port 3000'));

在這裡，我們發送一個 JSON 物件作為對 HTTP GET 請求的回應。就像呼叫 res.json() 一樣簡單！

範例：在請求中接收 JSON

app.use(express.json()); // Middleware to parse JSON body

app.post('/user', (req, res) => {
  const user = req.body;
  console.log(user); // Output: { name: "Alice", age: 25, city: "Wonderland" }
  res.send('User received!');
});

在這個例子中，我們使用express.json()中間件自動解析來自請求正文的傳入JSON數據，將其轉換為我們可以使用的JavaScript物件。

處理 JSON 錯誤

如果得到錯誤的 JSON 資料怎麼辦？不用擔心——Node.js 具有內建的錯誤處理功能。讓我們看看如何捕捉這些錯誤。

範例：處理解析錯誤

const faultyJson = '{"name": "Alice", "age": 25'; // Oops, missing closing bracket

try {
  const jsonObj = JSON.parse(faultyJson);
} catch (error) {
  console.error('Failed to parse JSON:', error.message);
}

如果 JSON 損壞，JSON.parse() 將拋出錯誤。在這種情況下，try-catch 區塊可以幫助我們優雅地處理它。

總結

如果您在 Node.js 中處理數據，則必須了解 JSON。無論您是解析、建立、讀取還是發送 JSON 數據，Node.js 中的內建方法都會讓一切變得簡單。使用 JSON.parse() 將字串轉換為對象，使用 JSON.stringify() 將字串轉換為對象，使用 Express.js 在 API 中實現平滑的 JSON 處理。

舒適地使用 JSON，您將擁有開發人員工具包中最有價值的工具之一！

參考：

1. Node.js 文件：使用 JSON
2. Express.js 指南：處理 JSON 請求
3. MDN 網路文件：JSON.parse()

感謝您的閱讀，祝您編碼愉快！ ？