How I compare two JSON responses without being distracted by formatting
· 2 min read
A JSON diff should compare meaning, not indentation. Two JSON documents can look different as text but still contain the same data.
The JSON Diff tool is useful because it lets me check the result in a small, controlled place before I use it in a bigger workflow.
The simple idea
A JSON diff should compare meaning, not indentation. Two JSON documents can look different as text but still contain the same data.
The goal is not to click buttons quickly. The goal is to understand the input, produce the expected output, and notice anything that could be misleading.
Step 1: Paste the old JSON on one side and the new JSON on the other
Paste the old JSON on one side and the new JSON on the other.
Start with a small example if possible. Small examples make mistakes easier to see.
Step 2: Validate both documents before comparing
Validate both documents before comparing.
Step 3: Ignore whitespace and key-order noise when the tool parses both sides
Ignore whitespace and key-order noise when the tool parses both sides.
Step 4: Look for added fields first
Look for added fields first.
Step 5: Look for removed fields next
Look for removed fields next.
Step 6: Review changed values carefully, especially IDs, status, prices, and permissions
Review changed values carefully, especially IDs, status, prices, and permissions.
Step 7: Use the diff as evidence, not as an automatic decision about which side is correct
Use the diff as evidence, not as an automatic decision about which side is correct.
My checklist
Before I trust the result, I check:
- Paste the old JSON on one side and the new JSON on the other.
- Validate both documents before comparing.
- Ignore whitespace and key-order noise when the tool parses both sides.
- Look for added fields first.
- Look for removed fields next.
- Review changed values carefully, especially IDs, status, prices, and permissions.
- Use the diff as evidence, not as an automatic decision about which side is correct.
The tool handles the mechanical part. I still review the result before I publish it, send it, or use it in production.
Comments
Comments are welcome — please read the comment policy first. Powered by giscus and GitHub Discussions.