Trình định dạng JSON
Định dạng JSON hợp lệ với thụt lề rõ ràng, xem dữ liệu lồng nhau và chọn khoảng cách mà không đổi mô hình dữ liệu.
Đọc JSON dễ hơn
JSON nén thuận tiện cho việc truyền dữ liệu nhưng khó kiểm tra khi phát triển. Công cụ định dạng hiển thị object và array bằng dòng mới cùng thụt lề nhất quán, giúp bạn thấy cấp lồng nhau, so sánh trường và nhận ra cấu trúc bất ngờ.
Định dạng là bước trình bày. Nó làm tài liệu hợp lệ dễ đọc hơn mà không nên thay đổi giá trị hay quan hệ. Nếu nguồn sai, hãy sửa dấu ngoặc kép, dấu phẩy hoặc dấu ngoặc trước; đổi khoảng trắng không thể sửa cú pháp.
Định dạng JSON nghĩa là gì
JSON là định dạng văn bản gồm object, array, chuỗi, số, boolean và null. Formatter đọc cấu trúc đó rồi viết lại bằng dòng và khoảng trắng. Thụt lề chỉ điều khiển độ sâu hiển thị; công cụ không thêm trường, sắp xếp key hoặc áp dụng JSON Schema.
JSON chuẩn dùng dấu ngoặc kép cho tên thành viên và chuỗi. Comment, dấu phẩy cuối, NaN và Infinity có thể xuất hiện trong phần mở rộng của một số ngôn ngữ nhưng không thuộc cú pháp chuẩn. Vì vậy literal object của JavaScript có thể không phải JSON hợp lệ.
Cách dùng formatter
- Dán hoặc nhập tài liệu JSON vào ô nguồn.
- Chọn số lượng thụt lề, chẳng hạn hai hoặc bốn khoảng trắng.
- Chạy định dạng và đọc kết quả. Nếu có lỗi, sửa nguồn rồi thử lại.
- So sánh key, kiểu và giá trị trước khi sao chép kết quả.
Phương pháp định dạng
- Phân tích trước
Đầu vào phải được hiểu là một giá trị JSON trước khi sắp xếp. Nhờ vậy lỗi cú pháp được tách khỏi cách trình bày.
- Thụt lề dữ liệu lồng nhau
Object và array được chia thành nhiều dòng khi độ sâu giúp dễ đọc hơn. Khoảng cách đã chọn lặp lại ở từng cấp.
- Tạo văn bản dễ đọc
Kết quả là biểu diễn văn bản mới của giá trị đã phân tích. Khoảng trắng có thể đổi nhưng cấu trúc dự kiến vẫn giữ nguyên.
Kết quả dễ đọc không chứng minh rằng trường bắt buộc hay quy tắc nghiệp vụ đã được đáp ứng.
Đọc kết quả
Hãy kiểm tra kết quả dưới dạng văn bản và dữ liệu. Xác nhận key, thứ tự array, kiểu dữ liệu và nội dung chuỗi vẫn đúng. Dòng mới và khoảng trắng thêm vào là kết quả định dạng bình thường.
Lỗi cho biết nguồn không thể được phân tích theo cú pháp JSON được chấp nhận. Hãy kiểm tra dấu phẩy, dấu ngoặc kép, dấu ngoặc và escape gần vị trí lỗi.
Lỗi thường gặp
Literal object của JavaScript, YAML hoặc JSON có comment có thể thất bại. Hãy dùng JSON chuẩn với dấu ngoặc kép và không có dấu phẩy cuối.
Thụt lề không sắp xếp key và không kiểm tra trường bắt buộc. Hãy tách các việc đó khỏi định dạng.
Giới hạn
Giao diện ghi nhận văn bản nguồn và số lượng thụt lề. Điều đó không chứng minh hỗ trợ JSON Schema, JSON5, chuyển đổi định dạng hoặc tải tệp.
Tài liệu lớn, key trùng, độ chính xác số và quy tắc ứng dụng cần được kiểm tra riêng trong hệ thống sử dụng dữ liệu.
Examples
Định dạng object gọn
Làm sao đọc object chỉ có một dòng?
Gửi object với hai khoảng trắng.
Mỗi thuộc tính nằm trên một dòng, còn tên và giá trị không đổi.
Hiển thị array lồng nhau
Làm sao kiểm tra array gồm các object?
Chạy định dạng với hai khoảng trắng.
Dấu ngoặc và ranh giới object cho thấy cấu trúc của array.
Chọn bốn khoảng trắng
Khi nào thụt lề rộng hơn có ích?
Chọn bốn khoảng trắng và định dạng nguồn.
Mỗi cấp lồng nhau cách xa hơn, có thể dễ đọc trên màn hình lớn.
Tìm dấu ngoặc kép bị thiếu
Điều gì xảy ra khi tên không có dấu ngoặc kép?
Gửi nguồn và xem phản hồi.
Đây không phải JSON chuẩn vì tên thành viên phải là chuỗi có dấu ngoặc kép.
Giữ giá trị boolean
true có trở thành chuỗi không?
Định dạng object và so sánh kiểu dữ liệu.
true vẫn là boolean, còn yes vẫn là chuỗi vì có dấu ngoặc kép.
Giữ null
null được hiển thị như thế nào?
Định dạng object và đọc giá trị.
null vẫn là giá trị JSON rõ ràng và khác với thuộc tính bị thiếu hoặc chuỗi rỗng.
Frequently asked questions
Định dạng có xác thực JSON không?
Nguồn phải được phân tích nên lỗi cú pháp có thể ngăn kết quả. Công cụ không xác thực schema, trường bắt buộc hay quy tắc nghiệp vụ.
Giá trị của tôi có thay đổi không?
Thay đổi dự kiến là khoảng trắng và dòng. Hãy so sánh kết quả khi có số rất lớn hoặc key trùng.
Có thể dùng dấu nháy đơn không?
Không trong JSON chuẩn. Tên và chuỗi cần dấu ngoặc kép.
Vì sao dấu phẩy cuối gây lỗi?
Một số phần mở rộng chấp nhận nó, nhưng cú pháp chuẩn thì không. Hãy xóa trước khi định dạng.
Nên dùng hai hay bốn khoảng trắng?
Hãy theo phong cách của dự án hoặc bản review. Nó thay đổi khả năng đọc, không đổi mô hình dữ liệu.
Key có được sắp xếp không?
Đừng mặc định như vậy. Định dạng chỉ sắp xếp bố cục; sắp xếp key cần tùy chọn được ghi rõ.
Công cụ có sửa JSON sai không?
Không. Hãy sửa dấu ngoặc kép, dấu phẩy, dấu ngoặc và escape trong nguồn.
JSON đã định dạng có nhỏ hơn không?
Thường không, vì thêm khoảng trắng. JSON gọn phù hợp truyền dữ liệu, còn JSON đã định dạng phù hợp con người kiểm tra.