تحويل camelCase إلى snake_case!

نص السلسلة
النتيجة

تحويل camelCase إلى snake_case!

هل تسميات متغيرات الكود المنسوخة من مصادر أخرى غير متوافقة مع كودك؟ لا داعي للقلق! قم بتحويل المتغيرات إلى التنسيق المطلوب!

تعيد هذه الصفحة كتابة معرّفات camelCase مثل userId أو lastLoginAt بصيغة snake_case (user_id، last_login_at) داخل أي نص تلصقه: كائن JS، أو جسم JSON، أو واجهة TypeScript، أو قائمة أسماء عادية.

السبب المعتاد هو الحدود بين المنظومات المختلفة. فالواجهة الأمامية أو خدمة Java تسمّي الحقول بـ camelCase، بينما يتوقع كود Python أو أعمدة PostgreSQL/MySQL أو مخطط التحليلات على الجانب الآخر snake_case. بدلًا من إعادة كتابة كل مفتاح، الصق الكتلة وانسخ النسخة المحوَّلة.

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

  1. اترك القائمتين المنسدلتين على camelCase → snake_case (تُفتح هذه الصفحة وهذا الزوج محدد).
  2. استبدل المثال في خانة نص السلسلة بالكود أو قائمة الحقول؛ تتحدث خانة النتيجة أثناء الكتابة وتميّز كل معرّف أُعيدت تسميته.
  3. استخدم زر النسخ في خانة النتيجة، أو حدد الكل وانسخه، ثم الصقه مجددًا في محررك.

مثال

المدخلات (camelCase)
const payload = {
  userId: 42,
  displayName: "Mina",
  isActive: true,
  lastLoginAt: "2024-05-01T09:30:00Z",
};
المخرجات (snake_case)
const payload = {
  user_id: 42,
  display_name: "Mina",
  is_active: true,
  last_login_at: "2024-05-01T09:30:00Z",
};

لا تُعامل كـ camelCase إلا الكلمات التي تحوي حرفًا كبيرًا بعد بداية صغيرة، لذا تُترك الكلمة المفردة payload كما هي، ولا يُمس نص التاريخ لأنه لا يحوي كلمة camelCase.

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

  • كل حرف كبير في كلمة camelCase يبدأ مقطعًا جديدًا: lastLoginAt → last_login_at.
  • تبقى الأرقام ملتصقة بالكلمة التي تسبقها: base64Data → base64_data، address2Line → address2_line.
  • يعمل على أي نص لا على اسم واحد فقط: الكائنات الحرفية وSQL وYAML والقوائم التي فيها اسم في كل سطر تُفحص كلها في مكانها.
  • يبقى باقي النص (علامات الترقيم والمسافات البادئة والقيم) تمامًا كما ألصقته.

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

إرسال payload من JS إلى API بلغة Python

عادةً ما تعرّف نقطة نهاية FastAPI أو Django REST الحقلين user_id وcreated_at. تحويل كائن الطلب المبني في المتصفح يبيّن بالضبط المفاتيح التي يحتاجها نموذج الخلفية.

كتابة migration لحقول قادمة من الواجهة الأمامية

عندما يضيف نموذج الحقلين marketingOptIn وreferralCode، تكون أعمدة قاعدة البيانات في العادة marketing_opt_in وreferral_code. الصق قائمة الحقول واستخدم النتيجة في جملة ALTER TABLE.

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

  • الأحرف الكبيرة المتتالية تُعامل كاختصار واحد: userID يصبح user_id، وhomeURL يصبح home_url، وparseHTTPServer يصبح parse_http_server.
  • النص داخل السلاسل الحرفية والتعليقات يُحوَّل أيضًا، وكذلك استدعاءات المكتبات مثل getElementById. الصق فقط الجزء الذي تريد إعادة تسميته فعلًا.

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

هل سيصبح userID هو user_id؟

نعم. سلسلة الأحرف الكبيرة تُقرأ ككلمة واحدة وتُصغَّر، فيصبح userID → user_id. الحالة الوحيدة التي لا يستطيع تقسيمها هي اختصاران مكتوبان معًا، مثل loadXMLHTTPData، الذي يصبح load_xmlhttp_data.

هل يمكنني تحويل مفاتيح JSON دون القيم؟

لا تتغير القيم إلا إذا بدت هي نفسها ككلمات camelCase. الأرقام والتواريخ والجمل العادية تبقى كما هي؛ لكن قيمة نصية مثل "darkMode" ستُحوَّل، لذا راجع القيم الشبيهة بالـ enum.