Làm đẹp và Định dạng JSON (JSON Formatter & Prettify)

Công cụ làm đẹp và định dạng JSON là gì?

Định dạng JSON là trình bày lại văn bản dữ liệu để dễ đọc hoặc gọn hơn. Bản làm đẹp dùng xuống dòng và thụt lề để thể hiện cấu trúc; bản thu gọn giảm những khoảng trắng phục vụ trình bày. Cả hai vẫn là văn bản JSON, không phải một loại dữ liệu mới.

Công cụ Làm đẹp và Định dạng JSON thực hiện ba việc chính: nhận văn bản bạn nhập, phân tích cú pháp và tạo lại kết quả theo chế độ làm đẹp hoặc thu gọn. Khi xử lý thành công, bạn nhận được văn bản đầu ra cùng trạng thái JSON hợp lệ. Nếu đầu vào sai cú pháp, công cụ để trống kết quả và hiển thị thông báo lỗi.

Nhu cầu sử dụng không chỉ dành cho lập trình viên. Người đọc phản hồi API, rà soát tài liệu cấu hình, chuẩn bị dữ liệu minh họa hoặc trao đổi thông tin giữa các nhóm đều có thể cần một bản JSON dễ nhìn hơn. Việc tách rõ từng cấp dữ liệu giúp người đọc nhận ra danh sách và nhóm thuộc tính thay vì phải dò một dòng dài.

Tuy nhiên, đây không phải công cụ tự sửa JSON hỏng, chuyển JSON sang định dạng khác hay chứng nhận dữ liệu đúng nghiệp vụ. Một văn bản được phân tích thành công vẫn có thể thiếu trường cần thiết hoặc chứa giá trị không phù hợp. Ngoài ra, quá trình tạo lại JSON không bảo đảm giữ nguyên mọi chi tiết của văn bản ban đầu.

Các thuật ngữ cần hiểu khi định dạng JSON

JSON

JSON là định dạng văn bản dùng để biểu diễn dữ liệu bằng object, array, chuỗi, số, boolean và null. Nó thường xuất hiện trong trao đổi dữ liệu và tài liệu cấu hình. Với công cụ này, văn bản phải tuân thủ cú pháp JSON mới có thể được định dạng. Điểm dễ nhầm là JSON không đồng nghĩa với mọi đoạn khai báo dữ liệu trong JavaScript: tên thuộc tính không có ngoặc kép, chuỗi dùng nháy đơn hoặc comment có thể khiến đầu vào bị từ chối.

Object và array

Object là tập hợp các cặp tên thuộc tính và giá trị, được viết trong ngoặc nhọn. Array là danh sách giá trị có thứ tự, được viết trong ngoặc vuông. Ví dụ, một object mô tả mặt hàng có thể chứa array liệt kê các nhãn của mặt hàng đó. Làm đẹp giúp nhận ra các cấp lồng nhau này, nhưng không chủ động tái cấu trúc dữ liệu. Không nên nhầm tên thuộc tính của object với vị trí phần tử trong array.

Prettify và thụt lề

Prettify có nghĩa là trình bày dữ liệu cho dễ đọc, thường bằng xuống dòng và thụt lề. Thụt lề là phần khoảng trắng ở đầu dòng, giúp thể hiện một giá trị nằm bên trong cấu trúc nào. Công cụ sử dụng cố định 4 dấu cách cho mỗi cấp. Những dấu cách trình bày này không phải trường dữ liệu mới. Cũng cần phân biệt làm đẹp với sửa lỗi: dữ liệu phải phân tích được trước khi công cụ tạo bản dễ đọc.

Minify

Minify là thu gọn văn bản bằng cách không thêm những khoảng trắng và xuống dòng dùng cho định dạng. Trong công cụ này, đầu ra thu gọn vẫn là JSON, không phải tệp nén nhị phân như gzip. Dấu cách nằm trong giá trị chuỗi là nội dung nên không bị xóa theo cách xóa khoảng trắng trình bày. Vì vậy, thu gọn không có nghĩa loại bỏ mọi dấu cách, bỏ giá trị null hoặc bảo đảm kích thước nhỏ nhất theo mọi phương pháp nén.

Kiểm tra cú pháp và kiểm tra schema

Kiểm tra cú pháp xác định văn bản có thể được đọc theo quy tắc JSON hay không. Kiểm tra schema là đối chiếu dữ liệu với các yêu cầu như trường bắt buộc, kiểu giá trị và ràng buộc cho phép. Công cụ chỉ xác nhận bước phân tích cú pháp, không thực hiện kiểm tra schema. Chẳng hạn, một tuổi được viết dưới dạng chuỗi vẫn có thể là JSON hợp lệ, dù API yêu cầu số. Schema ở đây là kiến thức nền để phân biệt, không phải tính năng được cung cấp.

Đầu vào hợp lệ và cách hiểu kết quả JSON

Những dữ liệu có thể nhập

Đầu vào là văn bản, không có đơn vị đo. Bạn có thể nhập một object, một array hoặc giá trị cấp cao nhất đơn giản như "xin chào", 12, true và null. Không bắt buộc mọi tài liệu phải bắt đầu bằng ngoặc nhọn hay ngoặc vuông.

Văn bản phải chứa một giá trị JSON hoàn chỉnh. Tên thuộc tính và chuỗi cần dùng ngoặc kép; comment, dấu phẩy cuối và chuỗi dùng nháy đơn không được chấp nhận. Hai tài liệu độc lập nối tiếp nhau, chẳng hạn {"a":1}{"b":2}, cũng không phải một giá trị JSON hoàn chỉnh.

Ba trạng thái kết quả cần phân biệt

Thông điệp lỗi do môi trường JavaScript của trình duyệt cung cấp nên cách diễn đạt có thể khác nhau. Trạng thái hợp lệ không xác nhận các trường và giá trị đã đáp ứng yêu cầu của hệ thống sẽ sử dụng dữ liệu.

Sao chép và sử dụng văn bản đầu ra

Ô kết quả chỉ đọc, giúp tách bản được tạo ra khỏi nội dung bạn đang chỉnh. Chức năng sao chép chỉ thực hiện khi có kết quả và không đang hiển thị lỗi. Việc ghi vào clipboard phụ thuộc khả năng, quyền và ngữ cảnh hoạt động của trình duyệt, nên không thể hứa luôn thành công. Phần mã được cung cấp không có chức năng tải tệp kết quả hoặc xuất sang định dạng khác.

Công cụ kiểm tra và định dạng JSON như thế nào?

Từ văn bản đầu vào đến dữ liệu JSON

Trình tự xử lý bắt đầu bằng việc bỏ khoảng trắng ở hai đầu văn bản. Nếu phần còn lại rỗng, công cụ đưa kết quả về trống và chuyển sang chờ nhập liệu. Nếu có nội dung, bộ phân tích JSON tích hợp của JavaScript đọc văn bản thành dữ liệu; chỉ sau bước này công cụ mới tạo lại văn bản đầu ra.

Quá trình được thực hiện lại khi đầu vào thay đổi hoặc khi đổi chế độ. Với địa chỉ trang được cung cấp, chế độ ban đầu là làm đẹp. Trong lúc bạn nhập một cấu trúc chưa hoàn chỉnh, trạng thái lỗi có thể xuất hiện vì nội dung tại thời điểm đó chưa phải JSON đầy đủ.

Quy tắc làm đẹp với 4 dấu cách

Chế độ làm đẹp tạo JSON với mức thụt lề cố định 4 dấu cách. Các object và array có thể được chia thành nhiều dòng; phần nằm sâu thêm một cấp được thụt vào thêm. Cách trình bày này giúp nhìn mối quan hệ bao chứa giữa các nhóm dữ liệu. Giá trị đơn giản ở cấp cao nhất không nhất thiết trở thành văn bản nhiều dòng.

Không có lựa chọn đổi độ thụt lề trong phần giao diện và logic được cung cấp. Làm đẹp cũng không tự bổ sung dấu ngoặc, đổi nháy đơn thành ngoặc kép hay bỏ dấu phẩy thừa để cứu một đầu vào sai.

Quy tắc thu gọn mà không xóa nội dung chuỗi

Chế độ thu gọn tạo lại JSON mà không thêm khoảng trắng định dạng. Dấu cách thuộc nội dung chuỗi và giá trị null vẫn được giữ. Vì vậy, cơ chế không phải tìm mọi ký tự trắng rồi xóa: làm như thế có thể thay đổi nội dung dữ liệu.

Cả hai chế độ đều cần phân tích đầu vào thành công trước. Chúng hoạt động bằng cách đọc dữ liệu rồi tạo lại văn bản, không chỉ chỉnh cách xuống dòng trên bản gốc. Sự khác biệt này quan trọng khi dữ liệu có cách viết số đặc biệt hoặc tên thuộc tính trùng, như các lưu ý ở phần giới hạn.

Ví dụ làm đẹp, thu gọn và nhận biết JSON sai

Làm đẹp một object có danh sách bên trong

Giả sử bạn có dữ liệu minh họa về một mục hàng. Số lượng 2 chỉ là giá trị giả định, không gắn đơn vị đo trong ví dụ; tên và nhãn cũng là dữ liệu tự tạo, không phải thông tin người dùng thật. Đầu vào là:

{"ten":"Mẫu A","so_luong":2,"nhan":["mới","thử"]}

Theo logic được cung cấp, chế độ làm đẹp tạo kết quả:

{
    "ten": "Mẫu A",
    "so_luong": 2,
    "nhan": [
        "mới",
        "thử"
    ]
}

Các thuộc tính cấp đầu thụt 4 dấu cách, còn phần tử trong danh sách thụt 8 dấu cách. Cách nhìn này làm rõ rằng hai nhãn thuộc cùng một array bên trong object. Bạn có thể dùng bản nhiều dòng để đọc cấu trúc hoặc đưa vào tài liệu mẫu, nhưng vẫn cần kiểm tra riêng ý nghĩa của từng trường.

Thu gọn nhưng giữ dấu cách trong chuỗi và null

Ví dụ tiếp theo có hai dấu cách liên tiếp giữa A và B. Chúng thuộc nội dung ghi chú, không phải khoảng trắng dùng để căn lề. Đầu vào minh họa là:

{ "ghi_chu": "A  B", "du_phong": null }

Kết quả thu gọn được suy ra từ cơ chế tạo lại JSON:

{"ghi_chu":"A  B","du_phong":null}

Khoảng trắng bên ngoài các giá trị không còn trong bản thu gọn, nhưng hai dấu cách trong chuỗi vẫn tồn tại. Giá trị null cũng không bị loại bỏ. Điều này cho thấy bạn nên chọn thu gọn khi muốn giảm ký tự trình bày, chứ không dùng nó để làm sạch nội dung chuỗi hoặc loại các trường chưa có giá trị.

Đầu vào có dấu phẩy cuối bị báo lỗi

Với danh sách giả định [1,2,], các số không có đơn vị đo và chỉ phục vụ minh họa. Dấu phẩy sau phần tử cuối không hợp lệ trong JSON, nên bước phân tích thất bại trước khi tạo bản làm đẹp hay thu gọn.

Kết quả là ô đầu ra trống, trạng thái báo lỗi cú pháp và khung lỗi hiển thị thông điệp của trình duyệt. Không thể xác định nguyên văn thông báo cho mọi môi trường. Bạn cần kiểm tra dấu phẩy cuối và cung cấp lại JSON đúng chuẩn. Những ví dụ trên được suy ra từ logic mã được cung cấp, không phải báo cáo đã chạy thử công cụ.

Khi nào nên dùng công cụ định dạng JSON?

Đọc dữ liệu API và cấu hình

Bản làm đẹp hữu ích khi phản hồi API hoặc dữ liệu sao chép từ log nằm trên một dòng dài. Bạn dễ nhận ra nhóm thuộc tính, danh sách và các cấu trúc lồng nhau hơn. Với tài liệu cấu hình, cách trình bày rõ cũng hỗ trợ rà soát từng phần. Tuy nhiên, một log có thêm thời gian, tiền tố hoặc thông điệp khác cần được tách phần JSON trước; công cụ không tự trích xuất JSON từ mọi văn bản hỗn hợp.

Chuẩn bị mẫu dữ liệu để trao đổi

Khi gửi mẫu dữ liệu cho đồng nghiệp hoặc đưa vào tài liệu, bản làm đẹp giúp người nhận đọc cấu trúc thuận tiện hơn. Hãy thay thông tin nhạy cảm bằng giá trị mẫu trước khi chia sẻ. Nếu mục tiêu là có văn bản ít ký tự định dạng hơn để dán vào một vị trí phù hợp, bản thu gọn có thể hữu ích. Mức giảm phụ thuộc bản gốc, không có tỷ lệ giảm dung lượng cố định.

Phân biệt định dạng với đối chiếu phiên bản

Định dạng hỗ trợ đọc một tài liệu, còn đối chiếu hai phiên bản nhằm nhận biết phần thay đổi. Công cụ hiện tại không thực hiện so sánh hai JSON. Nếu đó là nhu cầu của bạn, có thể cân nhắc trang so sánh hai tài liệu JSON như một hướng chọn công cụ khác. Chưa có mã của trang đó để xác nhận tính năng cụ thể hoặc sự tích hợp giữa hai công cụ.

Làm đẹp, thu gọn và chuyển đổi định dạng khác nhau ra sao?

Ba nhu cầu này dễ bị gọi chung là “xử lý JSON”, nhưng có mục tiêu khác nhau. Bạn nên chọn theo dạng kết quả cần dùng, không chỉ theo việc muốn văn bản ngắn hoặc dễ nhìn hơn.

Làm đẹp và thu gọn là hai chế độ được xác nhận trong công cụ này. Chúng đều tạo đầu ra JSON, nhưng không bảo đảm giữ nguyên mọi chi tiết văn bản gốc. Chuyển sang YAML, CSV hoặc XML là nhiệm vụ khác và không được thực hiện ở đây.

Nếu đầu ra cần là YAML, trang chuyển đổi JSON sang YAML là một hướng lựa chọn riêng; cơ chế và khả năng cụ thể của trang đó chưa được xác minh từ dữ liệu hiện có. Ngoài ra, thu gọn không phải gzip hay tạo tệp nén: kết quả vẫn là văn bản JSON, không phải kích thước nhỏ nhất trong mọi trường hợp.

Giới hạn và lưu ý trước khi dùng kết quả JSON

Không bảo toàn mọi chi tiết của bản gốc

Việc đọc rồi tạo lại dữ liệu có thể đổi cách viết số. Với ví dụ giả định không có đơn vị {"he_so":1.00,"moc":1e2}, đầu ra thu gọn là {"he_so":1,"moc":100}. Giá trị trong ví dụ không đổi, nhưng biểu diễn ban đầu không được giữ. Số nguyên rất lớn còn có nguy cơ mất độ chính xác do cách JavaScript biểu diễn số.

Tên thuộc tính trùng cũng cần chú ý: {"muc":1,"muc":2} trở thành {"muc":2} ở chế độ thu gọn, dù trạng thái vẫn hợp lệ. Thứ tự tên thuộc tính dạng chỉ mục số có thể thay đổi theo quy tắc JavaScript. Vì thế, không nên coi công cụ là bộ bảo toàn nguyên văn hoặc cơ chế chuẩn hóa JSON dành cho ký số.

Dung lượng lớn, clipboard và dữ liệu nhạy cảm

Chưa có ngưỡng dung lượng hay kết quả kiểm thử hiệu năng được xác minh. Xử lý đồng bộ khi nội dung thay đổi có thể làm giao diện chậm với dữ liệu lớn. Việc không thấy giới hạn ký tự trong mã không chứng minh có thể xử lý dữ liệu lớn bất kỳ; sao chép tự động cũng phụ thuộc môi trường trình duyệt.

Mã xác nhận thao tác phân tích và tạo lại JSON diễn ra trong trình duyệt. Tuy nhiên, chưa có toàn bộ mã trang và tài nguyên khác để kết luận về việc gửi, thu thập hoặc lưu dữ liệu. Với dữ liệu nhạy cảm, nên dùng bản đã thay thế thông tin riêng thay vì dựa vào một lời bảo đảm riêng tư chưa được xác minh.

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

Có thể đổi thụt lề từ 4 dấu cách sang 2 dấu cách hoặc tab không?

Không có lựa chọn đó trong giao diện và logic được cung cấp. Chế độ làm đẹp luôn dùng 4 dấu cách cho mỗi cấp lồng nhau. Nếu tài liệu hoặc nhóm làm việc yêu cầu 2 dấu cách hay tab, bạn cần một công cụ có tùy chọn phù hợp hoặc định dạng lại trong môi trường khác. Đây là khác biệt về trình bày, không nhất thiết là khác biệt nội dung dữ liệu; tuy nhiên, vẫn cần chú ý nếu hệ thống của bạn đối chiếu văn bản nguyên bản.

JSON có comment hoặc dấu phẩy cuối vì sao không được chấp nhận?

Vì công cụ sử dụng bộ phân tích JSON chuẩn của JavaScript, không phải bộ đọc cú pháp mở rộng có comment hoặc dấu phẩy cuối. Một đoạn cấu hình được môi trường khác chấp nhận chưa chắc là JSON chuẩn. Bạn cần cung cấp bản không chứa comment và không có dấu phẩy sau phần tử cuối để công cụ đọc được. Việc báo lỗi không có nghĩa công cụ sẽ tự loại những thành phần đó; đầu vào vẫn phải được kiểm tra và chỉnh lại trước khi định dạng.

Thông báo JSON hợp lệ có nghĩa là dữ liệu đã đúng yêu cầu của API chưa?

Chưa. Thông báo đó chỉ cho biết văn bản đã được phân tích và tạo kết quả thành công. API có thể yêu cầu trường bắt buộc, kiểu dữ liệu cụ thể, giá trị trong phạm vi cho phép hoặc quan hệ giữa nhiều trường. Chẳng hạn, một trường số lượng chứa chuỗi vẫn có thể đúng cú pháp JSON nhưng không đáp ứng hợp đồng API. Bạn cần đối chiếu tài liệu hoặc cơ chế kiểm tra của API; công cụ không có logic xác nhận những yêu cầu nghiệp vụ ấy.

Chế độ thu gọn có xóa dấu cách trong chuỗi hoặc giá trị null không?

Không. Dấu cách thuộc nội dung chuỗi được giữ về mặt dữ liệu, và null vẫn là một giá trị JSON trong đầu ra. Thu gọn chỉ không thêm khoảng trắng phục vụ trình bày giữa các thành phần. Vì vậy, một ghi chú có nhiều dấu cách không tự trở thành ghi chú chỉ có một dấu cách, và trường mang null không tự biến mất. Nếu bạn muốn chỉnh nội dung hoặc loại trường, đó là thao tác biến đổi dữ liệu khác, không phải chức năng của chế độ thu gọn này.

Có nên định dạng mã định danh được viết bằng số nguyên rất lớn không?

Cần thận trọng vì một số số nguyên lớn không thể được JavaScript biểu diễn chính xác. Sau bước phân tích, giá trị đã có thể khác trước khi được tạo lại thành JSON, nên nhãn hợp lệ không bảo đảm mã định danh còn nguyên. Nếu hợp đồng dữ liệu cho phép biểu diễn mã bằng chuỗi, cách đó tránh việc phân tích nó như một số. Tuy nhiên, không nên tự đổi kiểu dữ liệu nếu hệ thống yêu cầu số; hãy xác định yêu cầu và khả năng bảo toàn trước khi dùng kết quả.

Vì sao có kết quả nhưng không sao chép tự động được?

Có kết quả không đồng nghĩa trình duyệt cho phép ghi vào clipboard. Chức năng này còn phụ thuộc hỗ trợ API, quyền truy cập và ngữ cảnh hoạt động của trang. Khi thao tác thất bại, công cụ hiển thị thông báo không thể sao chép tự động, nhưng điều đó không xác định chắc chắn nguyên nhân riêng lẻ. Bạn có thể thử chọn văn bản trong ô kết quả rồi sao chép thủ công nếu thiết bị cho phép; ô chỉ đọc ngăn chỉnh sửa, không phải một bảo đảm về khả năng clipboard.

Có thể khẳng định dữ liệu nhạy cảm không bị gửi hoặc lưu khi dùng công cụ không?

Không thể khẳng định như vậy chỉ từ phần mã được cung cấp. Phạm vi xác nhận được là thao tác phân tích và định dạng JSON diễn ra trong trình duyệt; chưa đủ dữ liệu để đánh giá mọi thành phần khác của trang có thu thập, gửi hoặc lưu thông tin hay không. Nếu dữ liệu chứa thông tin cá nhân, thông tin đăng nhập hoặc nội dung nội bộ, hãy dùng mẫu đã ẩn thông tin nhạy cảm hoặc môi trường được tổ chức phê duyệt thay vì mặc định rằng toàn trang không lưu dữ liệu.