What JSON input does the JSON Table Viewer accept?

The tool accepts a JSON array of objects. Each element in the array becomes a table row, and the keys of the objects become column headers. Nested objects are automatically flattened using dot notation — for example, { "address": { "city": "London" } } produces a column named "address.city". Arrays inside objects are displayed as their JSON string representation.

How are columns determined when objects have different keys?

Columns are the union of all keys found across every object in the array. If a row is missing a key that other rows have, the corresponding cell is left empty. This means you can safely mix records with slightly different shapes and still get a complete, readable table.

How does the sort feature work?

Click any column header to sort the table by that column in ascending order. Click the same header again to switch to descending order. Sorting is purely client-side and never modifies your original JSON. A chevron icon next to the active column header shows the current sort direction.

How do I copy the table as CSV?

Click the "Copy as CSV" button below the table. It serialises the current sorted view — including the header row — to CSV format and copies it to your clipboard. You can then paste it directly into Excel, Google Sheets, or any text editor.

عارض جدول JSON

5 صفوف

8 أعمدة

إدخال JSON

[
  {
    "id": 1,
    "name": "Alice Johnson",
    "email": "alice@example.com",
    "role": "admin",
    "address": {
      "city": "New York",
      "country": "US"
    },
    "age": 32,
    "active": true
  },
  {
    "id": 2,
    "name": "Bob Smith",
    "email": "bob@example.com",
    "role": "editor",
    "address": {
      "city": "London",
      "country": "GB"
    },
    "age": 28,
    "active": true
  },
  {
    "id": 3,
    "name": "Carol White",
    "email": "carol@example.com",
    "role": "viewer",
    "address": {
      "city": "Paris",
      "country": "FR"
    },
    "age": 35,
    "active": false
  },
  {
    "id": 4,
    "name": "David Lee",
    "email": "david@example.com",
    "role": "editor",
    "address": {
      "city": "Tokyo",
      "country": "JP"
    },
    "age": 41,
    "active": true
  },
  {
    "id": 5,
    "name": "Eva Martinez",
    "email": "eva@example.com",
    "role": "admin",
    "address": {
      "city": "Berlin",
      "country": "DE"
    },
    "age": 29,
    "active": false
  }
]

جدول (5 صفوف, 8 أعمدة)

id	name	email	role	address.city	address.country	age	active
1	Alice Johnson	alice@example.com	admin	New York	US	32	true
2	Bob Smith	bob@example.com	editor	London	GB	28	true
3	Carol White	carol@example.com	viewer	Paris	FR	35	false
4	David Lee	david@example.com	editor	Tokyo	JP	41	true
5	Eva Martinez	eva@example.com	admin	Berlin	DE	29	false

التفاصيل التقنية

كيف يعمل محوّل JSON إلى جدول

ما الذي تفعله الأداة

يعرض محوّل JSON إلى جدول مصفوفة JSON من الكائنات على هيئة جدول HTML قابل للفرز والتصفية. يستخرج تلقائيًا عناوين الأعمدة من مفاتيح الكائنات، ويُسطّح الكائنات المتداخلة إلى أعمدة بصيغة النقطة، ويقدّم البيانات في عرض مألوف شبيه بجداول البيانات. يسهّل ذلك التصفّح البصري والفرز والبحث في بيانات JSON المهيكلة دون استيرادها إلى قاعدة بيانات أو تطبيق جداول بيانات.

حالات استخدام شائعة للمطورين

يستخدم المطوّرون هذه الأداة لتصوّر مصفوفات استجابات واجهات برمجة التطبيقات بسرعة، أو لفحص نتائج استعلامات قواعد البيانات المصدّرة كـ JSON، أو لمراجعة بيانات الإعدادات. وهي مفيدة خصوصًا لمسح المصفوفات الكبيرة التي تعيدها نقاط نهاية REST، ومقارنة السجلات جنبًا إلى جنب، ورصد القيم المفقودة أو الشاذة في مجموعات البيانات. ويستخدمها مهندسو ضمان الجودة للتحقق من أن صادرات البيانات المجمّعة تحتوي على الحقول والقيم المتوقعة دون كتابة سكربتات.

تنسيقات البيانات أو أنواعها أو متغيراتها

تتوقع الأداة مصفوفة JSON من الكائنات حيث يمثّل كل كائن صفًا. تُعالَج الكائنات ذات المفاتيح غير المتجانسة بإنشاء أعمدة لكل المفاتيح الفريدة عبر جميع الصفوف، مع خلايا فارغة عندما يكون المفتاح غير موجود. تُسطّح الكائنات المتداخلة باستخدام صيغة النقطة (مثلًا: address.city يصبح عنوان عمود). تُعرض المصفوفات داخل القيم كسلاسل مفصولة بفواصل. المصفوفات البدائية التي لا تحتوي على عناصر كائنات غير مدعومة كمدخل للجدول.

المزالق الشائعة والحالات الطرفية

تنتج الكائنات المتداخلة بعمق شديد عناوين أعمدة طويلة وصعبة القراءة عند تسطيحها. وقد تؤدي المصفوفات التي تحتوي على أنواع مختلطة (بعض العناصر كائنات وأخرى بدائية) إلى تخطيطات أعمدة غير متوقعة. يمكن لمجموعات البيانات الكبيرة التي تضم آلاف الصفوف أن تبطئ عرض المتصفح — في مثل هذه الحالات، فكّر في تقسيم البيانات إلى صفحات قبل اللصق. الكائنات ذات المفاتيح التي تختلف فقط في حالة الأحرف (مثلًا: 'Name' مقابل 'name') ستنشئ أعمدة منفصلة قد تربك المستخدمين.

متى تستخدم هذه الأداة بدلًا من الكود

استخدم هذه الأداة في المتصفح للفحص البصري السريع لمصفوفات JSON أثناء التطوير وتصحيح الأخطاء. ولعرض الجداول برمجيًا داخل التطبيقات، استخدم مكتبات مثل ag-Grid أو TanStack Table أو عرض pandas DataFrame. ولاستكشاف البيانات على نطاق واسع، تتعامل أدوات مثل DuckDB أو jq مع أدوات تنسيق الأعمدة مع ملايين السجلات التي سيكون التعامل معها غير عملي داخل تبويب متصفح.