使用 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()

感谢您的阅读，祝您编码愉快！ ？