Trình định dạng JSON

Trình định dạng JSON

Dán JSON từ phản hồi API, tệp cấu hình, webhook hoặc mẫu log, rồi chọn Định dạng, Rút gọn hoặc Xác thực. Trình định dạng bung các object và array lồng nhau bằng 2 hoặc 4 dấu cách, trình rút gọn loại bỏ khoảng trắng không cần thiết, còn phần xác thực kiểm tra văn bản có phải JSON hợp lệ hay không trước khi bạn sao chép kết quả.

Cách định dạng JSON

  1. 1

    Dán JSON của bạn

    Thêm một giá trị JSON hoàn chỉnh: object, array, chuỗi, số, boolean hoặc `null`.

  2. 2

    Chọn thao tác

    Dùng Định dạng để có đầu ra dễ đọc, Rút gọn để có đầu ra compact, hoặc Xác thực để kiểm tra cú pháp.

  3. 3

    Chọn thụt lề

    Với đầu ra đã định dạng, chọn 2 dấu cách cho dự án web hoặc 4 dấu cách khi đó là quy ước của repository.

  4. 4

    Sao chép kết quả

    Xem thông báo của parser hoặc đầu ra đã định dạng, rồi sao chép kết quả về editor, API client hoặc tài liệu.

Trình định dạng JSON này làm gì

  • Định dạng JSON: biến đầu vào compact như {"a":1,"b":[1,2,3]} thành JSON có thụt lề, dễ đọc.
  • Rút gọn JSON: loại bỏ khoảng trắng chỉ phục vụ việc đọc, hữu ích cho ví dụ ngắn, nội dung nhúng và payload truyền tải.
  • Xác thực cú pháp: kiểm tra văn bản đã dán có thể parse thành JSON hay không. Đây là kiểm tra cú pháp, không phải xác thực JSON Schema.
  • Xử lý mọi giá trị gốc JSON: object và array là phổ biến, nhưng văn bản JSON cũng có thể là chuỗi, số, true, false hoặc null.
  • Giữ quy trình đơn giản: dán, chọn thao tác, xem đầu ra và sao chép kết quả.

Những gì công cụ cố ý không thay đổi

  • Không tự động sửa JSON sai. Thông báo của parser cho biết phần cần sửa.
  • Không chấp nhận wrapper JSONP như callback({...}).
  • Không chấp nhận comment hoặc dấu phẩy cuối kiểu JSONC nếu bạn chưa xóa chúng trước.
  • Không sắp xếp khóa object. Thứ tự hiện có được giữ lại trong phạm vi parser và serializer cho phép.
  • Không xác thực quy tắc nghiệp vụ, trường bắt buộc hoặc schema API. Hãy dùng trình xác thực JSON Schema cho bước đó.

Lựa chọn định dạng

Tình huống Thao tác tốt nhất Vì sao hữu ích
Đọc phản hồi API Định dạng với 2 dấu cách Object và array lồng nhau dễ quét hơn.
Khớp với phong cách repository Định dạng với 2 hoặc 4 dấu cách Thụt lề nhất quán giúp code review sạch hơn.
Nhúng payload vào request Rút gọn Loại bỏ khoảng trắng mà không đổi giá trị JSON.
Kiểm tra dữ liệu sao chép từ log Xác thực Xác nhận đoạn đã dán là JSON hoàn chỉnh trước khi dùng lại.
Chuẩn bị tài liệu API Định dạng Ví dụ dễ kiểm tra và sao chép hơn.

Lỗi cú pháp JSON mà công cụ phát hiện

Thông báo parser Nguyên nhân thường gặp Cách xử lý
Unexpected token ' at position X Dùng dấu nháy đơn quanh khóa hoặc chuỗi Dùng dấu nháy kép cho chuỗi JSON.
Unexpected end of JSON input Thiếu dấu ngoặc nhọn, ngoặc vuông hoặc dấu nháy đóng Kiểm tra phần cuối văn bản đã dán.
Unexpected token , at position X Dấu phẩy sau phần tử cuối cùng Xóa dấu phẩy cuối.
Unexpected token a at position X Khóa không có dấu nháy, NaN hoặc undefined Đặt khóa trong dấu nháy và chỉ dùng giá trị JSON hợp lệ.
Unexpected token / at position X Comment sao chép từ JSONC hoặc JavaScript Xóa comment ///* */ trước khi xác thực.

Mẹo thực tế

  • Hãy định dạng trước khi rà soát phản hồi, rồi chỉ rút gọn khi bạn thật sự cần payload compact.
  • Xác thực trước khi dán JSON vào tài liệu, ticket hoặc API client, đặc biệt khi nguồn là một dòng log chưa đầy đủ.
  • Giữ quy ước thụt lề của dự án. Đổi từ 2 sang 4 dấu cách trong tệp sẵn có có thể tạo diff khó đọc.
  • Tránh dán bí mật, thông tin đăng nhập production hoặc dữ liệu khách hàng vào bất kỳ công cụ web phổ thông nào. Với payload nhạy cảm, hãy dùng công cụ nội bộ hoặc offline đã được tổ chức phê duyệt.

Câu hỏi thường gặp

Không. Công cụ này chỉ kiểm tra cú pháp JSON. Nếu cần xác nhận trường bắt buộc, giá trị được phép hoặc cấu trúc object, hãy đưa kết quả qua trình xác thực JSON Schema sau khi nó parse sạch lỗi.

JSON nghiêm ngặt không cho phép comment hoặc dấu phẩy cuối. Hãy xóa comment kiểu JSONC và dấu phẩy cuối trước khi xác thực hoặc định dạng.

Dùng phong cách mà dự án của bạn đã áp dụng. Hai dấu cách phổ biến trong JavaScript và tệp cấu hình web; bốn dấu cách có thể dễ đọc hơn trong một số repository backend.

Tránh dán bí mật, access token, thông tin đăng nhập hoặc hồ sơ khách hàng vào trình định dạng web phổ thông. Với payload nhạy cảm, hãy dùng công cụ nội bộ hoặc offline đã được phê duyệt.

Công cụ liên quan