حوّل CSV إلى JSON!

أدخل CSV لتحويله إلى مصفوفة JSON مفاتيحها من الصف الأول! يدعم Excel, Google Sheets.
CSV
النتيجة
 

حوّل CSV إلى JSON!

أعطه نص CSV فيبني مصفوفة JSON فيها كائن لكل صف، مستخدمًا السطر الأول مفاتيحَ. نسخ نطاق خلايا من Excel أو Google Sheets يُنتج نصًا مفصولًا بعلامات جدولة؛ وبما أن الفاصل يُكتشف تلقائيًا، يمكنك لصقه مباشرة دون حفظ ملف أولًا.

الاستخدام المعتاد هو نقل قائمة منتجات أو جدول ترجمات موجود في جدول بيانات إلى بيانات seed أو استجابات وهمية (mock) أو بيانات ثابتة للاختبارات (fixtures).

طريقة الاستخدام

  1. انسخ النطاق من جدولك مع صف العناوين، والصقه في خانة CSV. إفلات ملف .csv على خانة الإدخال يحمّل محتواه أيضًا.
  2. اترك تحويل الأرقام والقيم المنطقية مفعّلًا لتحويل قيم مثل 35 وtrue إلى أرقام وقيم منطقية في JSON؛ وعطّله لإبقاء كل القيم سلاسل نصية.
  3. انسخ JSON الناتج. تُحفظ حالة مربع الاختيار في الرابط (?types=0)، فتبقى محفوظة في المفضلة.

مثال

المدخلات (TSV (Excel / Google Sheets))
sku	name	price	zip	active
A-01	USB-C cable	9.9	04524	true
A-02	Charger 65W	35	01000	false
المخرجات (JSON)
[
  {
    "sku": "A-01",
    "name": "USB-C cable",
    "price": 9.9,
    "zip": "04524",
    "active": true
  },
  {
    "sku": "A-02",
    "name": "Charger 65W",
    "price": 35,
    "zip": "01000",
    "active": false
  }
]

هذا نص مفصول بعلامات جدولة منسوخ من جدول بيانات. أصبح price رقمًا وactive قيمة منطقية، بينما يحتفظ 04524 بالصفر في بدايته كسلسلة نصية فيبقى الرمز البريدي سليمًا.

الميزات المدعومة

  • اكتشاف الفاصل: أيٌّ من الفاصلة أو علامة الجدولة أو الفاصلة المنقوطة يظهر أكثر خارج علامات الاقتباس في السطر الأول.
  • اقتباس وفق RFC 4180: الفواصل وفواصل الأسطر داخل القيم المقتبسة مثل "Busan, Korea"، وعلامات الاقتباس المهرَّبة بالشكل ""، تُقرأ بشكل صحيح.
  • تحديد أنواع متحفّظ: الأرقام ذات الأصفار في البداية (007) والصيغة الأسية (1e3) والأعداد الصحيحة التي تتجاوز النطاق الآمن في JavaScript تبقى سلاسل نصية.
  • لا تصبح قيمًا منطقية وnull إلا true وfalse وnull بأحرف صغيرة.
  • العناوين الفارغة تصبح column2 وهكذا، والمكررة تصبح name_2، والصفوف الأعرض من صف العناوين تحصل على مفاتيح columnN إضافية.
  • تعمل نهايات الأسطر بنوعيها CRLF وLF، وتُتخطى الأسطر الفارغة.

حالات الاستخدام

تحويل جدول بيانات المخطِّط إلى بيانات seed

التصنيفات أو خطط الأسعار أو مدخلات الأسئلة الشائعة التي تُدار في جدول بيانات يمكن أن تصبح مصفوفة JSON لسكربت seed أو لملف fixtures/*.json.

استجابات وهمية لعمل الواجهة الأمامية

قبل أن تتوفر الخلفية، دوّن بضعة صفوف نموذجية في جدول بيانات وحوّلها إلى جسم استجابة لـ MSW أو json-server.

نقل نتائج الاستعلامات إلى الكود

انسخ شبكة النتائج من DBeaver أو DataGrip بصيغة CSV، وحوّلها، والصق المصفوفة في اختبار كقيمة متوقعة.

ملاحظات وقيود

  • الناتج دائمًا مصفوفة مسطحة من الكائنات؛ والعنوان مثل user.name لا يتحول إلى كائن متداخل.
  • لا تُحوَّل TRUE وYes والخلايا الفارغة؛ فالخلية الفارغة تصبح سلسلة فارغة "".
  • لا يمكنك اختيار الفاصل يدويًا. إذا خلط السطر الأول الفواصل وعلامات الجدولة خارج علامات الاقتباس، يفوز الأكثر تكرارًا، فتحقق من المفاتيح الناتجة.
  • يُعامل السطر الأول دائمًا كصف عناوين. لملف CSV بلا عناوين، أضف سطرًا بالأسماء قبل اللصق.

الأسئلة الشائعة

لماذا خرج المعرّف الرقمي عندي كسلسلة نصية؟

القيم مثل 0012، أو الأعداد الصحيحة الأكبر من 9007199254740991، ستتغير إن حُلّلت كأرقام، لذا تُبقى عمدًا سلاسل نصية. إن كنت تحتاج فعلًا إلى رقم، فحوّله في كودك حيث تتحكم في الدقة.

هل يعمل CSV المفصول بفواصل منقوطة؟

نعم. الصيغة a;b;c التي يكتبها Excel في الإعدادات الإقليمية الأوروبية تُكتشف من السطر الأول. وتبقى عندها الفواصل العشرية مثل 1,5 سلاسل نصية لا أرقامًا.

وماذا عن الخلايا التي تحوي فواصل أسطر؟

إذا كانت القيمة محاطة بعلامتي اقتباس مزدوجتين، يُحفظ فاصل السطر بداخلها على شكل \n. يضيف Excel علامات الاقتباس هذه تلقائيًا عند نسخ خلية عُدّلت بـ Alt+Enter، فيعمل اللصق كما هو.