Apakah JSON?

Bekerja dengan JSON

Jika anda seorang pembangun, kemungkinan besar anda pernah mendengar tentang JSON (JavaScript Object Notation). Ia ada di mana-mana! Daripada API kepada fail konfigurasi, JSON ialah format yang sesuai untuk bertukar-tukar data. Tetapi bagaimana kita bekerja dengannya dalam Node.js? Mari kita pecahkannya secara ringkas, dengan beberapa contoh dunia sebenar untuk membantu anda sepanjang perjalanan.

---

Apakah JSON?

Dalam perkataan mudah, JSON ialah format untuk menyimpan dan menukar data. Ia mudah dibaca dan ditulis, yang menjadikannya sangat popular untuk pembangunan web. Ia kelihatan seperti ini:

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

Ia pada asasnya ialah koleksi pasangan nilai kunci, seperti objek JavaScript. Tetapi ingat: JSON hanyalah teks—ia perlu diubah menjadi objek untuk berguna dalam kod anda.

---

Menghuraikan JSON dalam Node.js

Mari kita mulakan dengan mengambil rentetan JSON dan menukarkannya kepada sesuatu yang boleh kita gunakan—objek JavaScript. Kami melakukan ini menggunakan JSON.parse().

Contoh: Menghuraikan JSON

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

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

Ini mengambil rentetan JSON, menghuraikannya dan mengubahnya menjadi objek JavaScript. Anda kini boleh mengakses sifatnya seperti nama, umur atau bandar.

---

Menukar Objek kepada JSON

Bagaimana jika anda perlu menghantar data anda sebagai JSON? Di situlah JSON.stringify() masuk. Ia mengambil objek JavaScript anda dan mengubahnya menjadi rentetan JSON.

Contoh: Menukar Objek kepada JSON

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

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

Ini sangat berguna apabila anda membina API atau menyimpan data sebagai JSON.

---

Membaca dan Menulis Fail JSON dalam Node.js

Perlu bekerja dengan fail JSON? Node.js memudahkannya dengan modul fs (Sistem Fail). Anda boleh membaca dan menulis fail JSON tanpa banyak kerumitan.

Contoh: Membaca Fail 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);
});

Di sini, kami menggunakan fs.readFile() untuk membaca fail JSON, kemudian menghuraikan kandungan fail ke dalam objek JavaScript. Kini anda boleh melakukan apa sahaja yang anda mahu dengan data!

Contoh: Menulis ke Fail 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');
});

Dalam kes ini, JSON.stringify() menukarkan objek menjadi rentetan JSON berformat yang bagus dan fs.writeFile() menyimpannya ke fail. Mudah!

---

Menghantar dan Menerima JSON dengan Permintaan HTTP

Apabila membina API, JSON ialah format pilihan untuk menghantar dan menerima data. Dalam Express.js, anda boleh menghantar dan menerima data JSON dengan mudah.

Contoh: Menghantar JSON dalam Respons

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'));

Di sini, kami menghantar objek JSON sebagai respons kepada permintaan HTTP GET. Ia semudah memanggil res.json()!

Contoh: Menerima JSON dalam Permintaan

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!');
});

Dalam contoh ini, kami menggunakan perisian pertengahan express.json() untuk menghuraikan data JSON yang masuk secara automatik daripada badan permintaan, mengubahnya menjadi objek JavaScript yang boleh kami gunakan.

---

Mengendalikan Ralat JSON

Bagaimana jika anda mendapat data JSON yang buruk? Jangan risau—Node.js mempunyai pengendalian ralat terbina dalam. Mari lihat cara menangkap ralat tersebut.

Contoh: Mengendalikan Ralat Penghuraian

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);
}

Jika JSON rosak, JSON.parse() akan membuang ralat. Dalam kes ini, blok cuba-tangkap membantu kami mengendalikannya dengan anggun.

---

Membungkus

JSON mesti diketahui jika anda menggunakan data dalam Node.js. Sama ada anda menghuraikan, mencipta, membaca atau menghantar data JSON, kaedah terbina dalam dalam Node.js menjadikannya mudah. Gunakan JSON.parse() untuk menukar rentetan menjadi objek, JSON.stringify() untuk pergi ke arah lain dan Express.js untuk pengendalian JSON yang lancar dalam API anda.

Selesa bekerja dengan JSON, dan anda akan mempunyai salah satu alatan yang paling berharga dalam kit alat pembangun anda!

---

Rujukan:

1. Dokumentasi Node.js: Bekerja dengan JSON
2. Panduan Express.js: Mengendalikan Permintaan JSON
3. Dokumen Web MDN: JSON.parse()

---

Terima kasih kerana membaca, dan selamat mengekod! ?

Atas ialah kandungan terperinci Apakah JSON?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!