محول CSV ↔ JSON — الأنواع والفواصل ومحليًا
حوّل CSV إلى JSON أو JSON إلى CSV في متصفحك. الخطوات: اختر الاتجاه، الصق أو ارفع، حدّد الفاصل والرأس ثم انسخ أو نزّل. يتعامل مع الحقول المقتبسة التي تحوي فواصل وفواصل منقوطة وعلامات جدولة؛ ومن JSON إلى CSV تُسطَّح الكائنات المتداخلة إلى أعمدة. مثال: حوّل جدول منتجات (sku، العنوان، السعر) إلى مصفوفة JSON — وتبقى البيانات محليًا.
كيف يعمل
اختر CSV → JSON أو JSON → CSV؛ يتم التحليل والإنشاء هنا عبر Papa Parse. في CSV تختار الفاصل (أو الكشف التلقائي)، وهل الصف الأول رؤوس، وهل تُستنتج الأرقام/القيم المنطقية. في JSON تُسطَّح الكائنات المتداخلة إلى أعمدة بمسار نقطي، والأعمدة هي اتحاد كل المفاتيح.
قواعد ينبغي توقّعها
ما الذي تتوقعه عند التحويل: كيف تُعالَج أنواع الخلايا، وأي الفواصل وقواعد الاقتباس تُطبَّق، وكيف يُطابَق JSON المتداخل مع الأعمدة.
- الأنواع: خلايا CSV نص افتراضيًا. فعّل «استنتاج الأنواع» للحصول على أرقام/قيم منطقية، لكن 007 يصبح 7 وقد تفقد سلاسل الأرقام الطويلة الدقة؛ اتركه متوقفًا لأكواد SKU والرموز البريدية وأرقام الهاتف.
- الفواصل: الفاصلة والفاصلة المنقوطة (شائعة في Excel الأوروبي) وعلامة الجدولة (TSV)؛ يخمّن الكشف التلقائي من النص. الحقول التي تحوي الفاصل أو الاقتباس أو أسطرًا جديدة تُحاط بعلامات اقتباس مزدوجة وفق RFC 4180.
- JSON → CSV: تُسطَّح الكائنات بمسارات نقطية (dim.w، dim.h)؛ وتُكتب المصفوفات كسلسلة JSON في خلية واحدة؛ والأعمدة اتحاد كل المفاتيح، والناقص يُترك فارغًا.
- الخصوصية: لا يُرفع نصك أو ملفاتك. جلب Papa Parse من CDN ينزّل شيفرة المكتبة فقط، لا بياناتك.
مثال
CSV `sku,title,price` مع الصف `A-001,"Chair, oak",129.9` يصبح JSON `{"sku":"A-001","title":"Chair, oak","price":"129.9"}` (بدون الأنواع يبقى price نصًا؛ فعّلها للحصول على الرقم 129.9). والعكس: `[{"sku":"A-001","dim":{"w":40,"h":90}}]` ينتج الرأس `sku,dim.w,dim.h` مع الصف `A-001,40,90`.
استخدامات مناسبة
- التجارة الإلكترونية: حوّل جدول منتجات مُصدَّر (sku، العنوان، السعر) إلى مصفوفة JSON لواجهة متجر أو سوق.
- المطورون: أعد تشكيل استجابة JSON إلى CSV للجداول أو المطابقة أو التسليم.
- البيانات/التشغيل: انقل CSV لتقارير أو أحداث (فاصلة أو فاصلة منقوطة أو TSV) إلى JSON لخط معالجة، مع تهريب الفواصل والأسطر الجديدة بأمان.
Frequently asked questions
هل تبقى الأرقام والأصفار البادئة والمعرّفات كما هي؟
افتراضيًا تبقى كل خلية نصًا، لذا يُحفظ 007 والمعرّفات الطويلة. عند تفعيل «استنتاج الأنواع» تتحول القيم الرقمية إلى أرقام: 007 يصبح 7 وقد تفقد السلاسل الطويلة الدقة. اتركه متوقفًا لأكواد SKU والرموز البريدية والهواتف.
هل يدعم الفاصلة المنقوطة أو الجدولة، لا الفاصلة فقط؟
نعم. اختر فاصلة أو فاصلة منقوطة أو جدولة، أو اترك الكشف التلقائي ويخمّن Papa Parse من النص. الفاصلة المنقوطة شائعة في تصديرات Excel الأوروبية؛ والجدولة تعني TSV.
كيف تُعالَج الحقول التي تحوي فواصل أو اقتباسات أو أسطرًا جديدة؟
تُحاط بعلامات اقتباس مزدوجة وتُضاعَف الاقتباسات الداخلية وفق RFC 4180. هكذا يبقى عنوان مثل Chair, oak في حقل واحد بدل أن ينقسم إلى عمودين.
كيف تصبح JSON المتداخلة أعمدة CSV؟
تُسطَّح الكائنات إلى أعمدة بمسار نقطي (dim.w، dim.h). وتُكتب المصفوفات كسلسلة JSON في خلية واحدة. والأعمدة اتحاد مفاتيح كل السجلات، والسجل الذي يفتقد مفتاحًا يُترك فارغًا.
هل تغادر بياناتي المتصفح؟
لا. يبقى التحليل في هذه اللسان، وتُقرأ الملفات المختارة محليًا. قد يقدّم CDN مكتبة Papa Parse؛ لكن ذلك الطلب ينزّل شيفرة فقط، وليس رفعًا لـ CSV أو JSON.