Định dạng & Thu gọn JSON

JSON là gì?

JSON (JavaScript Object Notation) là một định dạng trao đổi dữ liệu dạng văn bản nhẹ, dễ đọc và dễ viết cho con người, đồng thời dễ phân tích và tạo bởi máy tính. Được định nghĩa trong tiêu chuẩn ECMA-404 và RFC 8259, JSON đã trở thành định dạng dữ liệu phổ biến nhất trên web, thay thế XML trong hầu hết các API hiện đại.

JSON chỉ hỗ trợ 6 kiểu dữ liệu: object, array, string, number, boolean (true/false), và null. Không có kiểu date, comment, hay undefined. Sự đơn giản này chính là sức mạnh: bất kỳ ngôn ngữ lập trình nào cũng có thể parse và serialize JSON một cách dễ dàng.

Tại sao cần định dạng JSON?

JSON từ API thường được gửi dưới dạng thu gọn (minified) — tất cả nằm trên một dòng duy nhất không có khoảng trắng. Với các response lớn chứa hàng nghìn trường, việc đọc trực tiếp gần như không thể. Công cụ định dạng JSON thêm xuống dòng và thụt lề, biến chuỗi ký tự khó đọc thành cấu trúc phân cấp rõ ràng.

• Debug API: Nhanh chóng tìm trường dữ liệu trong response phức tạp
• Review cấu hình: Đọc file package.json, tsconfig.json, hoặc CI/CD config dễ dàng hơn
• So sánh dữ liệu: JSON được định dạng giúp diff/compare chính xác hơn
• Tài liệu hóa: JSON đẹp phù hợp cho tài liệu API, hướng dẫn kỹ thuật

Định dạng vs Thu gọn: Khi nào dùng cái nào?

Định dạng (Pretty Print) dùng cho con người đọc: debug, code review, documentation. Thu gọn (Minify) dùng cho máy: truyền tải qua mạng, lưu trữ trong database, API response. Thu gọn loại bỏ tất cả khoảng trắng thừa, giảm kích thước dữ liệu đáng kể — đặc biệt quan trọng với payload lớn.

Lỗi JSON thường gặp và cách sửa

• Trailing comma: JSON không cho phép dấu phẩy sau phần tử cuối cùng. {"a": 1,} là không hợp lệ. JavaScript/TypeScript cho phép, nhưng JSON thì không.
• Single quotes: JSON bắt buộc dùng dấu ngoặc kép "". Dấu ngoặc đơn '' là không hợp lệ.
• Comment: JSON không hỗ trợ comment. Dùng jsonc (JSON with Comments) nếu cần, nhưng phải strip trước khi parse.
• Unquoted keys: Tất cả key trong JSON phải nằm trong dấu ngoặc kép. {name: "Alice"} là không hợp lệ.
• Undefined/NaN/Infinity: Các giá trị này không tồn tại trong JSON. Dùng null thay cho undefined.

JSON.parse() và JSON.stringify() trong JavaScript

JSON.parse(str) chuyển chuỗi JSON thành object JavaScript. JSON.stringify(obj, replacer, space) chuyển object thành chuỗi JSON. Tham số space kiểm soát thụt lề: truyền 2 cho 2 spaces, 4 cho 4 spaces, hoặc "\t" cho tab.

Tham số replacer cho phép lọc hoặc biến đổi giá trị khi stringify. Truyền mảng tên key để chỉ giữ lại những key đó, hoặc truyền function để custom logic.

JSON trong hệ sinh thái phát triển web

REST API: Hầu hết REST API trả về JSON với header Content-Type: application/json. GraphQL cũng sử dụng JSON cho cả request và response.

Configuration: package.json (npm/yarn), tsconfig.json (TypeScript), .eslintrc.json (ESLint), composer.json (PHP), appsettings.json (.NET) — tất cả đều là JSON.

Database: MongoDB lưu dữ liệu dạng BSON (Binary JSON). PostgreSQL có kiểu jsonb cho truy vấn JSON hiệu quả. DynamoDB, Firestore cũng dựa trên cấu trúc JSON.