A JSON diff shows the structural differences between two JSON documents. It highlights which keys were added, removed, or modified — including nested objects and arrays. JSON diffing is commonly used in code reviews, API response comparison, configuration auditing, and debugging data pipelines.

How does the JSON Diff Viewer handle arrays?

The viewer uses the jsondiffpatch algorithm which computes the Longest Common Subsequence (LCS) for arrays. This means it can detect moved, added, and removed array items rather than naively treating every index change as a modification. The result is a more meaningful diff that reflects actual data changes.

Is my JSON data sent to a server?

No. All diffing is performed entirely in your browser using client-side JavaScript. Your JSON data never leaves your machine, making this tool safe for sensitive configuration files and private API payloads.

What do the summary badges (added / removed / changed) mean?

Added counts fields or array items that exist only in the right JSON. Removed counts fields or array items that exist only in the left JSON. Changed counts fields whose values differ between the two documents. These counts help you quickly assess the scope of changes before reading the detailed diff.

نمایشگر مقایسه JSON

یکسان

JSON سمت چپ

JSON سمت راست

خروجی تفاوت‌ها

هیچ تفاوتی وجود ندارد — دو سند JSON یکسان هستند.

جزئیات فنی

ابزار مقایسهٔ JSON چگونه کار می‌کند

این ابزار چه کاری انجام می‌دهد

ابزار JSON Diff یک مقایسهٔ ساختاریِ عمیق بین دو سند JSON انجام می‌دهد و کلیدهای اضافه‌شده، حذف‌شده و تغییرکرده را در هر سطح تو‌در‌تو شناسایی می‌کند. نتایج با هایلایت رنگی نمایش داده می‌شوند تا دقیقاً مشخص شود چه چیزی تغییر کرده است، از جمله تفاوت‌های اشیای تو‌در‌تو و آرایه‌ها. این کار یک diff معنایی ارائه می‌دهد که ساختار JSON را می‌فهمد، نه اینکه صرفاً خطوط متن خام را مقایسه کند.

موارد استفادهٔ رایج برای توسعه‌دهندگان

توسعه‌دهندگان از JSON diff برای مقایسهٔ پاسخ‌های API قبل و بعد از تغییرات کد، اطمینان از اینکه به‌روزرسانی‌های فایل پیکربندی فقط شامل تغییرات موردنظر است، و دیباگ کردن تفاوت‌های تنظیمات مخصوص هر محیط (staging در برابر production) استفاده می‌کنند. این ابزار برای بازبینی خروجی‌های Terraform plan، مقایسهٔ نسخه‌های شِمای OpenAPI، و اعتبارسنجی اینکه اسکریپت‌های مهاجرت پایگاه داده تغییرات شِمای مورد انتظار را در خروجی‌های JSON ایجاد می‌کنند ضروری است.

قالب‌ها، نوع‌ها یا گونه‌های داده

این ابزار مقایسهٔ ساختاری انجام می‌دهد که در آن ترتیب کلیدهای شیء بر برابری اثر نمی‌گذارد (چون اشیای JSON طبق مشخصات بدون ترتیب هستند)، اما ترتیب عناصر آرایه مهم است. تغییر نوع (رشتهٔ '1' در برابر عدد 1) به‌عنوان تغییر گزارش می‌شود. مقدارهای null از کلیدهای غایب متمایز می‌شوند. تفاوت‌های بسیار تو‌در‌تو همراه با مسیر کامل JSON گزارش می‌شوند تا بتوانید تغییرات را در اسناد پیچیده بدون باز کردن دستیِ همهٔ سطوح پیدا کنید.

دام‌های رایج و حالت‌های لبه‌ای

مقایسهٔ آرایه‌ها می‌تواند پرنویز باشد وقتی عناصر در میانه درج یا حذف می‌شوند، چون باعث می‌شود همهٔ اندیس‌های بعدی به‌عنوان تغییرکرده نمایش داده شوند. اعداد ممیز شناور ممکن است به‌دلیل دقت سریال‌سازی (1.0 در برابر 1.00000000001) متفاوت باشند بدون اینکه تغییر معناداری را نشان دهند. اسناد JSON بسیار بزرگ با هزاران کلید در یک سطح می‌توانند خروجی diff بسیار حجیمی تولید کنند — بهتر است زیربخش‌ها را جداگانه مقایسه کنید. کامنت‌ها JSON معتبر نیستند، بنابراین فایل‌های پیکربندیِ دارای کامنت باید قبل از مقایسه پاک‌سازی شوند.

چه زمانی از این ابزار استفاده کنیم در برابر کُد

از این ابزار مرورگری برای مقایسهٔ سریع و بصریِ دو payload JSON هنگام دیباگ یا بازبینی کد استفاده کنید. برای تست رگرسیون خودکار، پایپ‌لاین‌های CI، یا تولید diff به‌صورت برنامه‌نویسی، از کتابخانه‌هایی مانند json-diff (npm)، deepdiff (Python)، یا مقایسه‌های مبتنی بر jq استفاده کنید که می‌توانند در مجموعه تست‌ها ادغام شوند و خروجی patch ماشین‌خوان تولید کنند (فرمت RFC 6902 JSON Patch).