Giới thiệu & Mục đích sử dụng
JSON (JavaScript Object Notation) là định dạng trao đổi dữ liệu phổ biến nhất trong phát triển REST API, GraphQL, tệp cấu hình (package.json, tsconfig.json) và dữ liệu Schema có cấu trúc. Khi gỡ lỗi phản hồi API trả về hàng nghìn ký tự dồn trên một dòng duy nhất hoặc đọc chuỗi JSON bị escape lồng nhiều lớp dấu gạch chéo ngược \" trong file log máy chủ, mắt thường gần như không thể phát hiện ra vị trí thiếu một dấu ngoặc nhọn hay dư một dấu phẩy ở cuối mảng.
Công cụ Format & Kiểm Tra JSON trên N1A vận hành hoàn toàn cục bộ trên trình duyệt giúp bạn không bao giờ lo rò rỉ payload API hay khóa bí mật ra máy chủ bên ngoài, đồng thời cung cấp bộ tiện ích toàn diện từ định vị chính xác dòng/cột lỗi cú pháp, tự động unescape chuỗi JSON từ log, sắp xếp thứ tự khóa đệ quy để diff code cho đến cây đóng/mở trực quan và bảng đường dẫn JSONPath.
Cách dùng từng bước
-
Dán chuỗi JSON thô, phản hồi API hoặc chuỗi JSON từ file logHỗ trợ cả JSON nén 1 dòng, JSON sai cú pháp lẫn chuỗi JSON bị bọc trong ngoặc kép thoát ký tự.
-
Chọn kiểu thụt lề (2 spaces, 4 spaces, Tab) và tùy chọn sắp xếp khóaBật Sắp xếp tên khóa A→Z nếu bạn muốn chuẩn bị 2 payload JSON để đưa sang công cụ So sánh văn bản (Diff).
-
Kiểm tra báo lỗi tức thì theo số dòng & số cộtNếu JSON hỏng cú pháp, khung bên phải khoanh vùng đúng đoạn mã xung quanh dòng bị lỗi kèm dấu mũi tên >>> để bạn sửa ngay.
-
Chuyển đổi giữa tab Mã JSON chuẩn, Cây đóng/mở và Bảng JSONPathDùng chế độ Cây để thu gọn nhanh nhánh lớn, hoặc copy đường dẫn $.user.name từ bảng JSONPath.
Công thức & Phương pháp tính
Khác với đối tượng JavaScript thông thường vốn khá dễ tính, đặc tả chính thức IETF RFC 8259 (The JSON Data Interchange Format) quy định rất nghiêm ngặt về mặt cú pháp để mọi ngôn ngữ (Go, Python, Rust, Java, JavaScript) đều giải mã thống nhất:
| Lỗi JSON hay gặp nhất | Nguyên nhân phổ biến | Cách sửa đúng chuẩn RFC 8259 |
|---|---|---|
| Dấu phẩy thừa cuối dòng (Trailing comma) | Thói quen viết JS/Python hoặc copy từ .ts sang .json | Xóa dấu phẩy , đứng ngay trước } hoặc ] cuối cùng |
Dùng dấu nháy đơn 'key' hoặc quên nháy kép tên khóa | In trực tiếp object Python str(dict) hoặc object JS thuần | Bọc cả tên khóa và giá trị chuỗi bằng nháy kép "..." |
| Ký tự điều khiển xuống dòng thô trong chuỗi | Nhấn Enter trực tiếp bên trong giá trị "..." | Thay bằng chuỗi thoát \n hợp lệ |
Nhúng chú thích // comment trong JSON | Dùng nhầm cú pháp JSONC (của VS Code) làm file cấu hình API | Loại bỏ hoàn toàn comment vì chuẩn RFC 8259 không có comment |
Cơ chế Unescape chuỗi từ Log: Rất nhiều hệ thống log lưu payload HTTP dưới dạng chuỗi đã serialize hai lần (double-encoded), khiến mọi dấu nháy kép bên trong biến thành \". Khi bật tùy chọn Unescape, công cụ thực hiện giải nén an toàn lớp vỏ chuỗi ngoài để trả về cấu trúc JSON thật sự dễ đọc.
Ví dụ minh họa
Ví dụ 1 — Sửa lỗi trailing comma trên dòng số 4: Với đoạn JSON chứa { "name": "N1A", "items": [1, 2, 3,] }, bộ phân tích chỉ rõ vị trí lỗi ngay tại dấu ngoặc vuông đóng sau dấu phẩy ở phần tử số 3 và hiển thị ngữ cảnh ±2 dòng liền kề để sửa dứt điểm trong vài giây.
Ví dụ 2 — So sánh hai phản hồi API khác thứ tự khóa: Server Go hoặc Python đôi khi xuất các khóa JSON theo thứ tự ngẫu nhiên giữa hai lần chạy. Khi bật tính năng Sắp xếp khóa (A → Z) đệ quy trước khi sao chép, cả hai file JSON đều được chuẩn hóa cấu trúc từ gốc tới lá, giúp quá trình đối chiếu diff cực kỳ sạch sẽ.
Lưu ý quan trọng
Lưu ý xử lý dữ liệu JSON lớn và số nguyên 64-bit: Do trình phân tích mặc định JSON.parse() của JavaScript dùng kiểu số thực dấu phẩy động IEEE 754 (chỉ chính xác tuyệt đối đến số nguyên 2⁵³ − 1 = 9.007.199.254.740.991), những ID ngân hàng hoặc Snowflake ID 19 chữ số nên được backend gửi dưới dạng chuỗi ("id": "1763136000123456789") thay vì kiểu số trần để tránh làm tròn mất chữ số cuối.
Câu hỏi thường gặp
Payload JSON nội bộ công ty dán vào đây có bị gửi về máy chủ nào không?
Tuyệt đối không. Toàn bộ quá trình phân tích cú pháp, định dạng, vẽ cây và tạo bảng JSONPath đều chạy 100% bằng JavaScript trên trình duyệt cá nhân của bạn.
Tại sao file JSON chạy tốt trong JavaScript nhưng lại báo lỗi ở dấu phẩy cuối mảng?
JavaScript và TypeScript cho phép dấu phẩy dư ở phần tử cuối (trailing comma), nhưng tiêu chuẩn JSON quốc tế RFC 8259 nghiêm cấm điều đó. Bất kỳ trình phân tích chuẩn nào trong Go, Java, Python hay MySQL đều từ chối JSON có trailing comma.
Tính năng Unescape chuỗi JSON lồng dùng trong trường hợp nào?
Rất hữu ích khi bạn copy một giá trị chuỗi log dạng "{\"status\":200,\"msg\":\"OK\"}" từ Kibana, Datadog hay Docker logs — công cụ tự bóc lớp chuỗi thoát đó thành JSON nhiều dòng đọc được ngay.
JSON có hỗ trợ ghi chú // hoặc /* ... */ không?
Chuẩn JSON RFC 8259 chính thức không hỗ trợ bất kỳ cú pháp chú thích nào. Một số công cụ lập trình như VS Code hoặc TypeScript dùng biến thể riêng gọi là JSONC (JSON with Comments), không tương thích với hàm đọc JSON tiêu chuẩn của API.
Khi nào nên dùng Copy Minify thay vì Copy JSON đẹp?
Nên dùng Copy Minify khi lưu JSON vào biến môi trường (.env), nhúng vào trường văn bản cơ sở dữ liệu hoặc truyền qua tham số dòng lệnh để loại bỏ toàn bộ khoảng trắng và xuống dòng thừa, giảm dung lượng truyền tải.
Đường dẫn JSONPath như $.user.name dùng để làm gì?
JSONPath là cú pháp truy vấn chuẩn (tương tự XPath cho XML) giúp bạn trỏ nhanh đến đúng nút dữ liệu lồng sâu bên trong JSON khi viết test tự động (Postman/k6), cấu hình jq hoặc hàm JSON_EXTRACT trong MySQL/PostgreSQL.
Căn cứ pháp lý & Nguồn tham khảo
- IETF RFC 8259 — The JavaScript Object Notation (JSON) Data Interchange Format (Đặc tả chính thức về cú pháp JSON, bảng mã UTF-8 và các giới hạn số học.)
- IETF RFC 9535 — JSONPath: Query Expressions for JSON (Tiêu chuẩn biểu thức truy vấn đường dẫn dạng $ .key[index].)