10 اصطلاحات تسمية JavaScript أساسية يجب على كل مطور معرفتها

10 اصطلاحات تسمية JavaScript أساسية يجب على كل مطور معرفتها
القراء مثلك يساعدون في دعم MUO. عند إجراء عملية شراء باستخدام الروابط الموجودة على موقعنا ، فقد نربح عمولة تابعة. اقرأ أكثر.

من الضروري الحفاظ على البساطة وسهولة القراءة وسهولة الصيانة في التعليمات البرمجية الخاصة بك من أجل إدارة مشاريع JavaScript المعقدة. الالتزام المستمر باتفاقيات التسمية هو المفتاح لتحقيق هذا الهدف.





تعد المتغيرات والمنطقية والوظائف والثوابت والفئات والمكونات والطرق والوظائف الخاصة والمتغيرات العامة والملفات من بين عناصر JavaScript التي تتطلب اصطلاحات تسمية متسقة. يمكنك تحسين تنظيم الكود وفهمه من خلال تطبيق اصطلاحات التسمية الموحدة عبر كل هذه المكونات ، مما يوفر الوقت والجهد على المدى الطويل.





اجعل فيديو اليوم قم بالتمرير للمتابعة مع المحتوى

1. تسمية المتغيرات

في JavaScript ، يتم تخزين البيانات في متغيرات. من الضروري اختيار أسماء وصفية للمتغيرات التي تعكس وظيفتها بدقة. يمكنك ، على سبيل المثال ، بديلا اسم المستخدم أو السعر الكلي لاسم المتغير بدلاً من x .





طريقة جيدة لتسمية المتغيرات هي كما يلي:

 let totalPrice = 100; 
let userName = "John";

يمكن تحسين قراءة التعليمات البرمجية باستخدام أسماء المتغيرات الوصفية



2. تسمية منطقية

المتغيرات التي يمكن أن تحتوي على قيمتين فقط ، أي إما حقيقي أو خطأ شنيع ، والمعروفة باسم Boolean. من الضروري اختيار الأسماء المناسبة للمتغيرات المنطقية التي تعبر عن الغرض منها.

للتوضيح ، بدلاً من اختيار اسم متغير مثل صحيح ، يجب أن تفضل الذهاب مع صالح أو hasValue .





ضع في اعتبارك هذا المثال:

 let isValid = true; 
let hasValue = false;

في هذا المثال ، توضح أسماء المتغيرات المنطقية الوصفية ما تمثله.





3. وظائف التسمية

تشير الوظيفة في JavaScript إلى وحدة تعليمات برمجية قائمة بذاتها تهدف إلى أداء مهمة معينة. إنها كتلة من الكود يمكن استدعاؤها أو استدعاؤها بواسطة أجزاء أخرى من الكود وتعمل ككيان مستقل.

لتسمية الوظائف بشكل فعال ، استخدم الأسماء الوصفية التي تنقل الغرض منها. على سبيل المثال ، بدلاً من خلق وظيفة فو ، اختر المزيد من الأسماء التوضيحية مثل ValidateUserInput أو حساب السعر الإجمالي .

على سبيل المثال:

 function calculateTotalPrice(price, quantity) { 
return price * quantity;
}
function validateUserInput(input) {
return input !== undefined && input !== null;
}

4. تسمية الثوابت

الثوابت هي متغيرات لا يمكن إعادة تعيينها. عند تسمية الثوابت ، من المهم استخدام كل الأحرف الكبيرة والشرطات السفلية لفصل الكلمات.

على سبيل المثال:

 const MAX_PRICE = 1000; 
const MIN_PRICE = 0;

في هذا المثال ، تم استخدام جميع الأحرف الكبيرة والشرطات السفلية لفصل الكلمات في الأسماء الثابتة.

5. فئات التسمية

في JavaScript ، يمكن إنشاء الكائنات باستخدام مخططات تسمى الفئات . لتحقيق ممارسات تسمية نقية ، من الأهمية بمكان تنفيذ PascalCase ، وهو اصطلاح تسمية يفرض كتابة الحرف الأول من كل كلمة بأحرف كبيرة.

خذ على سبيل المثال:

 class ShoppingCart { 
constructor(make, model) {
   this.make = make;
   this.model = model;
 }
}

في هذا المثال ، الفصل عربة التسوق تم تسميته باستخدام PascalCase ، مما يعني أن الحرف الأول من كل كلمة في اسم الفئة تمت كتابته بأحرف كبيرة ، ولا توجد مسافات أو شرطات سفلية بين الكلمات.

6. تسمية المكونات

المكونات هي اللبنات الأساسية في تطوير البرمجيات الحديثة ، لا سيما في أطر مثل React ، والتي تؤكد على الكود القابل لإعادة الاستخدام.

ترقية windows xp إلى windows 7

من خلال تقسيم واجهة مستخدم معقدة أو تطبيق إلى أجزاء أصغر يمكن إدارتها ، يمكنك إنشاء مكونات يمكن إعادة استخدامها عبر مشاريع مختلفة ، مما يقلل من وقت التطوير ويزيد من كفاءة الكود.

مرة أخرى ، نوصي بشدة باستخدام اصطلاح تسمية PascalCase لتسمية المكونات. هذا يعني كتابة الحرف الأول من كل كلمة في اسم المكون بحرف كبير.

تساعدك هذه الاتفاقية في تمييز المكونات عن مقاطع التعليمات البرمجية الأخرى ، وتبسيط التعريف والمعالجة.

 function Button(props) { 
  return <button>{props.label}</button>;
}

في هذا المثال ، تم استخدام اصطلاح تسمية PascalCase لتسمية المكون زر .

7. طرق التسمية

عند تسمية الطرق ، من الضروري استخدام الأسماء الوصفية التي تنقل بنجاح ما تنجزه الطريقة لأن الأساليب هي وظائف تتعلق بالكائن.

على سبيل المثال:

 class Car { 
constructor(make, model) {
   this.make = make;
   this.model = model;
 }
 startEngine() {
   // code to start engine
   }
 stopEngine() {
   // code to stop engine
   }
 }
}

الأسماء الوصفية ( بدء تشغيل المحرك و أوقف المحرك ) للطرق الواردة في هذا المثال ، مما يضمن سهولة فهم الغرض المقصود منها.

8. تسمية الوظائف الخاصة

الوظائف التي تم تعريفها على أنها خاصة تقتصر على الوصول إليها فقط داخل الكائن حيث تم تعريفها. من الضروري إضافة شرطة سفلية (_) للإشارة إلى أن الوظائف خاصة.

هذا مثال:

 class Car { 
constructor(make, model) {
   this.make = make;
   this.model = model;
 }
 _startEngine() {
   // code to start engine
 }
 _stopEngine() {
   // code to stop engine
 }
}

باستخدام شرطة سفلية بادئة في هذا المثال ، يُشار إلى أن الوظائف خاصة.

9. تسمية المتغيرات العالمية

يمكن الوصول إلى المتغيرات التي تم تصنيفها على أنها عالمية من أي جزء من قاعدة التعليمات البرمجية. أثناء تسمية مثل هذه المتغيرات العالمية ، من الضروري استخدام أسماء واضحة ووصفية تنقل الغرض المقصود منها بشكل فعال.

على سبيل المثال:

 const MAX_PRICE = 1000; 
const MIN_PRICE = 0;
function checkPrice(price) {
if (price > MAX_PRICE) {
   // code to handle high prices
 } else if (price < MIN_PRICE) {
   // code to handle low prices
 }
}

10. تسمية الملفات

يعتبر تنظيم الملفات الفعال جانبًا حاسمًا في إدارة مشروع JavaScript بنجاح. لضمان اصطلاحات تسمية مبسطة ومتسقة ، من الضروري فصل الكلمات في أسماء الملفات باستخدام الأحرف الصغيرة والواصلات.

تُفضل الأحرف الصغيرة لأن JavaScript هي لغة حساسة لحالة الأحرف ، مما يعني أن اللغة تتعامل مع الأحرف الصغيرة والكبيرة بشكل مختلف. يضمن استخدام الأحرف الصغيرة لأسماء الملفات الاتساق وتجنب الالتباس عند الرجوع إلى الملفات في التعليمات البرمجية.

تُستخدم الواصلات لفصل الكلمات في أسماء الملفات لأن المسافات غير مسموح بها في أسماء الملفات. يمكن أيضًا استخدام بدائل أخرى مثل الشرطات السفلية أو حالة الجمل ، ولكن تُفضل الواصلات عمومًا لسهولة قراءتها.

يؤدي استخدام الواصلات أيضًا إلى تسهيل الوصول إلى أسماء الملفات للمستخدمين الذين يستخدمون برامج قراءة الشاشة أو التقنيات المساعدة الأخرى.

 my-app/ 
├── src/
  ├── components/
    ├── button.js
      ├── input-field.js
├── utils/
     ├── string-utils.js
     ├── date-utils.js
├── app.js
├── index.js

في هذا المثال ، يتم استخدام الأحرف الصغيرة والواصلات لفصل الكلمات في أسماء الملفات.

أهمية اتباع اصطلاحات التسمية في JavaScript

يعد اتباع اصطلاحات التسمية الجيدة جانبًا أساسيًا لكتابة تعليمات برمجية نظيفة وقابلة للصيانة في JavaScript. باتباع هذه الاصطلاحات ، يمكنك جعل الكود الخاص بك أكثر قابلية للقراءة والصيانة ، خاصة في بعض أطر عمل JavaScript حيث يُطلب منك التعامل مع التعليمات البرمجية الضخمة ، والتي يمكن أن توفر لك الوقت والجهد على المدى الطويل.