تحويل PascalCase إلى camelCase!

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

تحويل PascalCase إلى camelCase!

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

يصغّر الحرف الأول من أسماء PascalCase: CustomerName → customerName. المصدر الكلاسيكي هو خلفية .NET: فإعدادات ASP.NET وNewtonsoft القديمة تُسلسِل خصائص C# في JSON بصيغة PascalCase (OrderId، ShippedAt)، بينما يتوقع كود JavaScript وTypeScript وJava حقولًا بصيغة camelCase.

ويفيد بالقدر نفسه في اشتقاق أسماء الكائنات أو المتغيرات من أسماء الأصناف، مثل UserRepository → userRepository، عند كتابة كود حقن الاعتماديات (dependency injection) أو تهيئة الاختبارات.

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

  1. اختر PascalCase مصدرًا وcamelCase هدفًا.
  2. الصق استجابة JSON أو قائمة خصائص أو أسماء أصناف في نص السلسلة.
  3. انسخ النص المحوَّل من النتيجة.

مثال

المدخلات (PascalCase)
{
  "OrderId": 1001,
  "CustomerName": "Kim",
  "ShippedAt": null
}
المخرجات (camelCase)
{
  "orderId": 1001,
  "customerName": "Kim",
  "shippedAt": null
}

تُحوَّل مفاتيح PascalCase الثلاثة من استجابة على طريقة C#؛ ولا تُمس null والأرقام، فيبقى JSON صالحًا.

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

  • لا تتغير حالة الأحرف إلا في بداية الاسم: ShippedAt → shippedAt.
  • لا يتعرّف على الاسم إلا إذا تكوّن من كلمتين على الأقل وفيه أحرف صغيرة، لذا تُتخطى الكلمات المفردة مثل Order وName أو JSON المكتوبة بأحرف كبيرة بالكامل.
  • يصغّر الكلمة الأولى فقط ويُبقي البقية كما كُتبت تمامًا، بما فيها الأرقام والاختصارات الداخلية (OrderID → orderID).

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

استهلاك API من .NET بصيغة PascalCase في TypeScript

إذا تعذّر تحويل الـ API إلى JsonNamingPolicy.CamelCase، فالصق استجابة نموذجية لترى أسماء حقول camelCase التي سينتجها الربط في العميل، أو لتكتب الواجهة يدويًا.

تسمية الاعتماديات المحقونة

قائمة خدمات مثل PaymentService وUserRepository تتحول مباشرة إلى أسماء معاملات الـ constructor أو الحقول paymentService وuserRepository.

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

  • الاختصار في البداية يُصغَّر كاملًا: HTTPServer → httpServer، JSONPayload → jsonPayload، IOError → ioError.
  • أسماء PascalCase المكوّنة من كلمة واحدة (Id، Name، Order) تحتاج إلى حرفين كبيرين ليُتعرّف عليها، لذا تبقى بحرف كبير. صغّرها بنفسك.

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

لماذا لم يصبح Name هو name؟

يتطلب نمط PascalCase كلمتين على الأقل (حرفين كبيرين) حتى لا تتغير الكلمات العادية المكتوبة بحرف أول كبير داخل الجمل. المفاتيح المكوّنة من كلمة واحدة يجب تعديلها يدويًا.

هل سيُفسد أسماء الأصناف الموجودة في النص الملصوق نفسه؟

نعم، كل اسم PascalCase متعدد الكلمات يُحوَّل، بما فيها أسماء الأصناف والأنواع. الصق الحقول وحدها عند العمل على كود.