03 / HƯỚNG DẪN
Định dạng và kiểm tra JSON trước khi đánh giá
Quy trình của người review với payload API và tệp cấu hình: pretty-print trước, kiểm tra cấu trúc dạng cây, và so sánh hai tài liệu một cách xác định — không gửi dữ liệu đi đâu.
Thử kiểm tra độ chính xác và thứ tự
Dùng dữ liệu nhập tổng hợp này để kiểm tra kết quả thực tế trước khi dùng dữ liệu riêng tư.
Dán ví dụ vào JSON Tree Viewer, rồi mở Minified. Đầu ra phải khớp chính xác văn bản này.
{"id":9007199254740993,"2":"b","1":"a"}
Số nguyên kết thúc bằng 993 và khóa 2 đứng trước khóa 1. Với {"name":}, lỗi ở dòng 1, cột 9. Giới hạn: 256 KiB, độ sâu 40, 10.000 nút; khóa trùng và khóa dành riêng bị từ chối.
JSON Tree ViewerVì sao định dạng đứng đầu
JSON minified được xây cho máy: một dòng, không thụt đầu dòng, khóa theo thứ tự bất kỳ serializer tạo ra. Bắt mắt bạn đánh giá bức tường đó là cách để một quyền bị gỡ, một cờ bị lật, hay một endpoint bất ngờ lọt qua.
Trình pretty-print cũng là kiểm tra hợp lệ rẻ nhất bạn có. Tài liệu không parse được thì cũng chẳng bao giờ vận hành đúng trong production, và biết điều đó trong tab đánh giá tốt hơn nhiều so với biết từ log triển khai.
- Chỉ khả năng đọcĐịnh dạng lại giữ nguyên giá trị JSON sau khi phân tích, nhưng có thể chuẩn hóa ký tự thoát và cách viết số. Hãy so sánh ý nghĩa thay vì từng byte; giữ bản gốc nếu tệp đã ký hoặc phụ thuộc vào biểu diễn chính xác.
- Độ sâu là tín hiệuThụt đầu dòng nhất quán phơi độ sâu lồng nhau trong nháy mắt, và độ sâu là nơi lỗi cấu hình ẩn náu — một tùy chọn đặt sâu hơn một cấp đơn giản là bị bỏ qua.
- Phát hành đúng hình dạngĐánh giá bản sao đã định dạng, nhưng phát hành đúng hình dạng hệ thống mong đợi; pretty-print dành cho con người, không phải cho đường truyền.
Kiểm tra cây, không chỉ văn bản
Chế độ xem cây trả lời những câu hỏi người review thực sự hỏi — có những khóa nào, mỗi giá trị kiểu gì, cấu trúc sâu đến đâu — mà không cần quét ngoặc. Văn bản thô không trả lời nhanh được câu nào.
JSON Tree Viewer kiểm tra văn bản dán vào ngay lập tức và văn bản gõ sau một khoảng dừng ngắn khi bật Auto-check. Bạn cũng có thể dùng Format & validate. Lỗi cú pháp kèm vị trí và gợi ý khôi phục; dữ liệu nhập hợp lệ mở ra cây cùng chế độ xem đã định dạng hoặc minified.
Bản tóm tắt báo số nút và độ sâu. Các khóa prototype dành riêng bị từ chối, nhưng kiểm tra này không chứng nhận bảo mật ứng dụng.
Cây cũng làm phẳng cuộc trao đổi trong một lần review: “phần tử thứ ba của items có price null” là bình luận ai cũng kiểm chứng trong vài giây, còn một offset byte vào dòng minified thì không.
Mở JSON Tree ViewerDiff hai tài liệu một cách xác định
So sánh hai tài liệu JSON bằng mắt thất bại ngay khi thứ tự khóa thay đổi. Diff cấu trúc parse cả hai phía và báo cáo thứ thực sự thay đổi — giá trị thêm, bớt và sửa — bất kể thứ tự hay khoảng trắng.
Text & JSON Diff có hai chế độ: Văn bản và JSON. Trong chế độ Văn bản, chọn độ chi tiết tự động, theo dòng, từ hoặc ký tự. Chế độ JSON phân tích hai tài liệu rồi so sánh giá trị, nên đổi thứ tự khóa hay khoảng trắng vẫn được coi là giống nhau.
Với dữ liệu không phải JSON, chế độ Văn bản có tùy chọn bỏ qua khoảng trắng và chuẩn hóa dấu xuống dòng; phần tóm tắt đếm mục thêm, xóa và sửa. Hãy chuyển sang Văn bản khi một bên không phải JSON hợp lệ.
Tính xác định quan trọng hơn cả sự tiện lợi. Khi hai người review chạy cùng một phép so sánh, họ phải nhận cùng một câu trả lời — nếu không review trở thành cuộc thương lượng về công cụ thay vì quyết định về thay đổi.
Mở Text & JSON DiffBiết giới hạn của các runtime cục bộ
Đây là các runtime cục bộ với trần rõ ràng, được định cỡ cho payload review chứ không phải xử lý dữ liệu khối lượng lớn. Biết trần cho bạn biết khi nào nên dùng công cụ desktop.
Các trần tồn tại vì parse và diff chạy trong cùng tab bạn đang đọc; giới hạn trung thực tốt hơn trang bị đóng băng, và không gian làm việc báo giới hạn bị vượt dưới dạng lỗi rõ ràng thay vì cắt cụt âm thầm.
- Trần trình xemJSON Tree Viewer chấp nhận tối đa 256 KiB dữ liệu nhập, bốn mươi cấp lồng nhau và mười nghìn nút — thừa sức cho một phản hồi API hay tệp cấu hình.
- Trần diffChế độ Văn bản nhận tối đa 256 nghìn ký tự mỗi bên; chế độ JSON còn áp dụng giới hạn phân tích 256 KiB UTF-8 mỗi bên. Cả hai giới hạn số bản ghi khác biệt ở 10.000.
- Ngoài trình duyệtXuất lớn hơn — dump cơ sở dữ liệu, kho log, fixture sinh tự động — thuộc về trình soạn thảo desktop hoặc công cụ dòng lệnh, không phải tab trình duyệt.
Checklist đánh giá năm phút
Quy trình ngắn bắt được hầu hết vấn đề payload trước khi chúng tới production.
Chạy checklist trên dữ liệu mẫu của bên sản xuất cũng như payload trực tiếp; fixture không khớp thực tế vô hiệu hóa đợt review chắc chắn như một con bug.
- ParseĐịnh dạng và parse trước: xác nhận tài liệu hợp lệ và liếc số nút cùng độ sâu so với kỳ vọng.
- Kiểm traKiểm tra cây: kiểm tra kiểu ở các lá — một định danh số tới dưới dạng chuỗi là lỗi tích hợp kinh điển.
- DiffDiff với phiên bản tốt đã biết gần nhất ở chế độ JSON, và đọc mọi thay đổi được báo trước khi phê duyệt.
Giữ payload trên thiết bị của bạn
Payload review thường chứa hồ sơ khách hàng, token hoặc URL nội bộ. Trình xem cục bộ giữ tài liệu đó trong tab: văn bản được parse bởi mã chạy trên thiết bị của bạn và không hề được truyền đi trong quá trình xử lý.
Ranh giới đó là thứ khiến các công cụ này dùng được với payload staging thật trong một đợt review. Nó không xóa nghĩa vụ của chính bạn: bản xuất đã tải xuống, nội dung bộ nhớ tạm và ảnh chụp cây vẫn là của bạn để xử lý cẩn thận khi chúng rời không gian làm việc.
Nếu phải chia sẻ một đoạn payload trong chính đợt review, hãy dán đoạn trích nhỏ nhất thể hiện vấn đề và che định danh trước — cùng kỷ luật mà các kênh hỗ trợ yêu cầu.
Đặc tả runtime hiện tại
Bản sửa đổi mô tả hợp đồng: 2026-09-26.1
Bàn giao trên cùng trang chấp nhận tối đa 256 KiB văn bản UTF-8 trong 10 phút. Đây là giới hạn chuyển giao; mỗi công cụ nhận có giới hạn phân tích và hiển thị riêng.
JSON Tree Viewer và Structured Data Converter gửi đầu ra đến một đích duy nhất trên cùng trang. Tree chỉ chấp nhận JSON; Converter và Text & JSON Diff có thể nhận JSON, YAML hoặc CSV. Mở đích không tự động chạy chuyển đổi.
Văn bản được chuyển giao chỉ nằm trong bộ nhớ của trang. Nó không đi vào URL, nơi lưu trữ hay phân tích. Đóng đích, thay thế nguồn, rời khỏi hoặc tải lại trang, hoặc hết hạn sẽ loại bỏ nó. Khi hết hạn, tiêu điểm chỉ quay về tiêu đề nguồn nếu trước đó nằm trong đích.
Vì sao kiểm tra cục bộ là tuyên bố đáng tin.
Tìm hiểu cách runtime trình duyệt giữ dữ liệu trên thiết bị, và cách xác minh đường dữ liệu của bất kỳ công cụ nào bạn dùng để review.