تحويل camelCase إلى SCREAMING_SNAKE_CASE!

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

تحويل camelCase إلى SCREAMING_SNAKE_CASE!

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

يحوّل أسماء camelCase مثل apiBaseUrl وmaxRetryCount إلى SCREAMING_SNAKE_CASE (API_BASE_URL، MAX_RETRY_COUNT)، وهو النمط المستخدم لمتغيرات البيئة والثوابت.

يفيد عندما يجب عرض كائن إعدادات مكتوب بـ JavaScript أو TypeScript أو Java على شكل مدخلات .env أو متغيرات بيئة في Docker/Kubernetes أو ثوابت static final. الصق الكائن أو قائمة المفاتيح لتحصل على الأسماء بأحرف كبيرة مع الشرطات السفلية في مواضعها الصحيحة.

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

  1. تحقق من أن القائمة المنسدلة الأولى تعرض camelCase والثانية SCREAMING_SNAKE_CASE.
  2. الصق كائن الإعدادات أو حقول الصنف أو قائمة المفاتيح في نص السلسلة.
  3. انسخ نص النتيجة؛ الأجزاء المميّزة هي الأسماء التي تغيّرت.

مثال

المدخلات (camelCase)
export const appConfig = {
  apiBaseUrl: "https://api.example.com",
  requestTimeoutMs: 5000,
  maxRetryCount: 3,
};
المخرجات (SCREAMING_SNAKE_CASE)
export const APP_CONFIG = {
  API_BASE_URL: "https://api.example.com",
  REQUEST_TIMEOUT_MS: 5000,
  MAX_RETRY_COUNT: 3,
};

يُحوَّل اسم المتغير appConfig ومفاتيحه جميعًا لأنها كلها camelCase. أما الرابط بين علامتي الاقتباس فلا يحوي كلمة camelCase، فيبقى سليمًا.

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

  • يضع شرطة سفلية بين الكلمات ويكبّر كل الأحرف: requestTimeoutMs → REQUEST_TIMEOUT_MS. سلسلة الأحرف الكبيرة المتتالية تُعدّ كلمة واحدة.
  • تبقى الأرقام في مكانها: oauth2ClientId → OAUTH2_CLIENT_ID.
  • يحوّل كل كلمات camelCase في الكتلة الملصوقة دفعة واحدة، مع إبقاء القيم وعلامات الترقيم دون تغيير.

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

توليد مفاتيح .env من مخطط الإعدادات

إذا كان تطبيقك يقرأ الإعدادات في كائن مثل { apiBaseUrl, sentryDsn }، فحوّل قائمة المفاتيح لتحصل على الأسماء المقابلة API_BASE_URL وSENTRY_DSN لملف .env أو ملف قيم Helm أو قائمة أسرار CI.

ترقية المتغيرات إلى ثوابت

القيم السحرية التي بدأت كمتغيرات محلية (defaultPageSize، maxUploadBytes) يمكن إعادة تسميتها بنمط الثوابت دفعة واحدة قبل نقلها إلى ملف ثوابت.

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

  • تبقى الاختصارات المكتوبة بأحرف كبيرة مجتمعة، فيعطي jwtTTL الناتج JWT_TTL ويعطي smtpHOSTName الناتج SMTP_HOST_NAME. فقط الاختصاران المتلاصقان يُدمجان في مقطع واحد.
  • استدعاءات الدوال مثل toString أو addEventListener في الكود الملصوق تُحوَّل أيضًا، لذا الصق التعريفات أو قوائم المفاتيح بدلًا من ملفات كاملة.

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

هل يضيف أيضًا export const أو علامات =؟

لا. الأسماء وحدها تتغير؛ ويبقى التركيب المحيط كما ألصقته. عدّل كلمات التعريف المفتاحية بنفسك إن كنت تحوّل مفاتيح كائن إلى ثوابت مستقلة.

لماذا لا يُعاد MAX_RETRY_COUNT إلى صيغته إذا ألصقته هنا؟

هذه الصفحة تبحث عن كلمات camelCase فقط. الاسم المكتوب بأحرف كبيرة أصلًا لا يبدأ بحرف صغير، فلا يُطابَق. استخدم صفحة SCREAMING_SNAKE_CASE → camelCase للاتجاه المعاكس.