Developer Tools

Thành Thạo Định Dạng và Kiểm Tra JSON

Tại sao JSON được định dạng hoàn hảo lại quan trọng đến từng dấu phẩy, và cách phát hiện các lỗi cấu trúc phổ biến.

5 phút đọc

Code editor showing JSON

Javascript Object Notation (JSON) là vị vua không thể tranh cãi của các API hiện đại và truyền tải dữ liệu. Tuy nhiên, vì nó cực kỳ nghiêm ngặt, chỉ một dấu phẩy đặt sai chỗ cũng có thể làm sập toàn bộ một endpoint đang chạy trên môi trường production.

Trong hướng dẫn này, chúng ta sẽ tìm hiểu các quy tắc vàng trong việc định dạng JSON.

Các Quy Tắc Cú Pháp của JSON

Khác với các object Javascript thông thường, JSON nổi tiếng là không khoan nhượng. Nếu bạn vi phạm những quy tắc này, trình phân tích cú pháp sẽ ném ra lỗi SyntaxError.

  1. Các key PHẢI được bao trong dấu ngoặc kép: 'name': 'John' là không hợp lệ. Phải viết là "name": "John".
  2. Không có dấu phẩy thừa: Bạn không thể để lại dấu phẩy sau phần tử cuối cùng trong một mảng hoặc object.
  3. Không có hàm hay undefined: JSON chỉ có thể lưu trữ chuỗi, số, boolean, mảng, object và null.

JSON Hợp Lệ và Không Hợp Lệ

Hãy xem trình phân tích cú pháp JSON nghiêm ngặt yêu cầu chúng ta những gì.

{
  "user": {
    "id": 1042,
    "isActive": true,
    "roles": ["admin", "editor"],
    "preferences": null
  }
}

Nếu chúng ta cố viết object đó theo kiểu thoải mái như trong các script JS:

// Đây là JSON KHÔNG HỢP LỆ (nhưng là Javascript hợp lệ)
{
  user: {
    id: 1042,
    isActive: true, // dấu phẩy thừa
  }
}

Tại Sao Việc Kiểm Tra Lại Quan Trọng

Khi kết nối các microservice, việc truyền JSON không hợp lệ đồng nghĩa với việc máy chủ nhận sẽ trả về lỗi 500 nghiêm trọng vì JSON.parse() thất bại hoàn toàn. Hãy luôn lint và định dạng JSON của bạn trước khi đưa vào ứng dụng.

Sử dụng công cụ định dạng tự động để kiểm tra rằng các payload API của bạn an toàn và đúng cấu trúc!

Sẵn sàng kiểm tra dữ liệu của bạn? Hãy truy cập ngay JSON Formatter & Validator của chúng tôi để làm đẹp các chuỗi thô của bạn ngay lập tức!