Cach kiem tra JSON truc tuyen: huong dan cho lap trinh vien voi vi du thuc te

JSON (JavaScript Object Notation) la dinh dang trao doi du lieu duoc su dung rong rai nhat trong phat trien web hien dai. Hau nhu tat ca cac REST API deu tra ve du lieu dang JSON, cac file cau hinh nhu package.json hay tsconfig.json su dung dinh dang nay, va cac co so du lieu nhu MongoDB luu tru tai lieu dang JSON.

Van de la chi mot ky tu sai vi tri (mot dau phay thua, mot dau nhay thieu, mot ngoac khong dong) se lam cho toan bo JSON khong hop le va gay loi trong ung dung cua ban. JSON khong hop le trong phan hoi API co the pha vo frontend. Mot tsconfig.json co loi cu phap se ngan TypeScript bien dich.

Kiem tra JSON truoc khi su dung giup tiet kiem hang gio debug. Voi cong cu kiem tra JSON NexTools, ban co the dan bat ky JSON nao, xem loi voi so dong chinh xac va tu dong nhan duoc dinh dang dep.

JSON co cac quy tac cu phap nghiem ngat. Vi pham bat ky quy tac nao deu tao ra JSON khong hop le:

• Cac khoa phai nam trong dau nhay kep: {"ten": "Ana"} hop le. {ten: "Ana"} KHONG hop le.
• Chuoi su dung dau nhay kep, khong bao gio dung nhay don: "gia tri" hop le. 'gia tri' KHONG hop le.
• Khong duoc co dau phay cuoi: {"a": 1, "b": 2} hop le. {"a": 1, "b": 2,} KHONG hop le.
• Khong co chu thich: Ban khong the su dung // hay /* */ trong JSON.
• So khong co dau nhay: {"tuoi": 25} hop le. {"tuoi": "25"} chay duoc nhung gia tri la chuoi, khong phai so.

Cac kieu du lieu duoc phep trong JSON:

Kieu	Vi du	Ghi chu
String	"xin chao"	Luon dung dau nhay kep
Number	42, 3.14, -7	So nguyen hoac thap phan, khong dau nhay
Boolean	true, false	Chu thuong, khong dau nhay
Null	null	Chu thuong, khong dau nhay
Array	[1, 2, 3]	Cac gia tri cach nhau bang dau phay
Object	{"khoa": "gia_tri"}	Cap khoa-gia tri

Day la nhung loi ban gap thuong xuyen nhat khi lam viec voi JSON:

1. Dau phay sau phan tu cuoi:
   {"items": [1, 2, 3,]} — Dau phay sau so 3 la khong hop le.
2. Dau nhay don thay vi nhay kep:
   {'ten': 'Minh'} — Phai la {"ten": "Minh"}.
3. Khoa khong co dau nhay:
   {tuoi: 30} — Phai la {"tuoi": 30}.
4. Ky tu dieu khien khong duoc escape:
   Tab va xuong dong trong chuoi phai viet la \t va \n.
5. Dau nhay khong duoc escape trong chuoi:
   Can escape dau nhay ben trong chuoi.
6. Chu thich:
   JSON khong ho tro bat ky loai chu thich nao.
7. NaN, Infinity hoac undefined:
   Cac gia tri JavaScript nay KHONG hop le trong JSON. Su dung null thay the.
8. Gia tri thap luc phan:
   {"mau": 0xFF0000} khong hop le. Su dung {"mau": "#FF0000"}.
9. Kieu hon hop trong mang co kieu:
   [1, "hai", true] la JSON hop le, nhung nhieu API mong doi mang dong nhat.
10. BOM (Byte Order Mark):
    Mot so trinh soan thao them cac byte vo hinh vao dau file lam cho JSON khong hop le. Luon luu dang UTF-8 khong co BOM.

Tat ca cac loi nay duoc tu dong phat hien boi cong cu kiem tra JSON, hien thi dong va vi tri chinh xac cua moi loi.

JSON co the duoc trinh bay theo hai cach: dinh dang dep (pretty-print) de nguoi doc, va nen de truyen du lieu hieu qua.

JSON dinh dang dep:

{
  "nguoi_dung": {
    "ten": "Lan",
    "tuoi": 28,
    "hoat_dong": true
  }
}

JSON nen (cung du lieu, it byte hon):

{"nguoi_dung":{"ten":"Lan","tuoi":28,"hoat_dong":true}}

Phien ban nen chiem it khong gian hon (ly tuong cho API va luu tru), trong khi phien ban dinh dang de doc va debug hon nhieu.

Trong JavaScript:

JSON.stringify(data, null, 2)  // dinh dang voi 2 khoang trang
JSON.stringify(data)           // nen

De nen cac file JSON lon, su dung cong cu nen ma xu ly JSON, CSS va JavaScript.

Truoc JSON, XML la dinh dang trao doi du lieu chu dao. Ca hai van duoc su dung, nhung cho muc dich khac nhau:

Dac diem	JSON	XML
Doc duoc	Ngan gon hon	Dai dong hon
Kich thuoc	Nho hon 30-50%	Lon hon
Kieu du lieu	String, Number, Boolean, Null, Array, Object	Tat ca la van ban
Chu thich	Khong ho tro	Ho tro
Schema	JSON Schema	XSD, DTD
Su dung chinh	REST API, cau hinh	SOAP, tai lieu, RSS
Phan tich	JSON.parse() goc	Can trinh phan tich XML

Nam 2026, JSON thong tri trong phat trien web, API va ung dung di dong. XML van ton tai trong cac he thong doanh nghiep cu, nguon cap RSS/Atom va dinh dang tai lieu nhu DOCX.

Ngoai viec kiem tra, cac cong cu bo sung nay giup cong viec de dang hon:

• Cong cu kiem tra JSON: Kiem tra cu phap, hien thi loi voi so dong va tu dong dinh dang.
• Cong cu nen ma: Nen JSON bang cach xoa khoang trang va xuong dong.
• Bo ma hoa Base64: Ma hoa JSON thanh Base64 de truyen trong URL hoac HTTP header.
• Cong cu so sanh van ban: So sanh hai phien ban JSON de tim su khac biet.

Trong trinh duyet:

• JSON.parse(jsonString) — Chuyen chuoi JSON thanh doi tuong JavaScript. Nem loi neu JSON khong hop le.
• JSON.stringify(obj, null, 2) — Chuyen doi tuong thanh JSON dinh dang.

Kiem tra cu phap chi xac nhan JSON co dung dinh dang. Nhung trong ung dung thuc te, ban cung can xac minh du lieu co dung cau truc.

Do la vai tro cua JSON Schema — mot tieu chuan de mo ta cau truc cua tai lieu JSON:

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "required": ["ten", "tuoi", "email"],
  "properties": {
    "ten": { "type": "string", "minLength": 1 },
    "tuoi": { "type": "integer", "minimum": 0, "maximum": 150 },
    "email": { "type": "string", "format": "email" }
  }
}

Voi schema nay, ban co the tu dong kiem tra rang moi JSON nguoi dung co ten (chuoi khong rong), tuoi (so nguyen tu 0 den 150) va email (dinh dang hop le). Cac thu vien nhu Ajv (JavaScript), jsonschema (Python) va Newtonsoft (.NET) trien khai kiem tra JSON Schema.

Cac phuong phap nay giup ban tranh cac van de thuong gap trong du an thuc te:

• Luon kiem tra JSON tu nguon ben ngoai: Moi JSON nhan tu API, file nguoi dung tai len hoac webhook phai di qua JSON.parse() trong try-catch truoc khi xu ly.
• Su dung camelCase cho khoa: Day la quy uoc chuan trong JavaScript/TypeScript. userName thay vi user_name.
• Tranh long nhau qua 3-4 cap: JSON long nhau sau kho doc, duyet va bao tri.
• Khong luu du lieu nhay cam trong JSON khong ma hoa: Token, mat khau va khoa rieng khong bao gio xuat hien trong JSON dang ro trong log hoac phan hoi API.
• Su dung null thay vi bo qua truong tuy chon: {"tenDem": null} tot hon viec bo qua truong.
• Xu ly loi phan tich mot cach nha nhan: Khong hien thi loi tho cua JSON.parse cho nguoi dung cuoi. Ghi log noi bo va hien thi thong bao than thien.