ESLint



eslint

الابتداء مع ESLint

ESLint هي أداة لتحديد الأنماط الموجودة في شفرة ECMAScript / JavaScript والإبلاغ عنها ، بهدف جعل الشفرة أكثر تناسقًا وتجنب الأخطاء. في العديد من الطرق ، يشبه JSLint و JSHint مع بعض الاستثناءات:

  • تستخدم ESLint أداة Espree لتعديل جافا سكريبت.
  • يستخدم ESLint AST لتقييم الأنماط في التعليمات البرمجية.
  • ESLint قابلة للتوصيل تمامًا ، كل قاعدة واحدة عبارة عن ملحق ويمكنك إضافة المزيد في وقت التشغيل.

الشروع في البرنامج التعليمي

لماذا ESLint @ 0: 00 ، تركيب واستخدام ESLint @ 2: 20. دورة كاملة ESLint في Pluralsight

التثبيت والاستخدام

المتطلبات الأساسية: Node.js (> = 4.x) ، npm الإصدار 2+.

هناك طريقتان لتثبيت ESLint: عالميًا ومحليًا.

التثبيت المحلي والاستخدام

إذا كنت ترغب في تضمين ESLint كجزء من نظام الإنشاء الخاص بالمشروع ، فإننا نوصي بتثبيته محليًا. يمكنك القيام بذلك باستخدام npm:

$ npm install eslint --save-dev

يجب عليك بعد ذلك إعداد ملف التكوين:

$ ./node_modules/.bin/eslint --init

بعد ذلك ، يمكنك تشغيل ESLint في الدليل الجذر لمشروعك كما يلي:

$ ./node_modules/.bin/eslint yourfile.js

يجب أيضًا تثبيت المكونات الإضافية أو التهيئات القابلة للمشاركة التي يتم استخدامها محليًا للعمل مع ESLint مثبت محليًا.

التثبيت العالمي والاستخدام

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

$ npm install -g eslint

يجب عليك بعد ذلك إعداد ملف التكوين:

$ eslint --init

بعد ذلك ، يمكنك تشغيل ESLint على أي ملف أو مجلد مثل هذا:

$ eslint yourfile.js

يجب أيضًا تثبيت أي مكونات إضافية أو تهيئات قابلة للمشاركة التي يتم استخدامها عالميًا للعمل مع ESLint مثبت عالميًا.

ملاحظة: eslint --init يهدف إلى إعداد وتهيئة ESLint على أساس كل مشروع ويقوم بتنفيذ تثبيت محلي لـ ESLint ومكوناته الإضافية في الدليل الذي يتم تشغيله فيه. إذا كنت تفضل استخدام تثبيت عالمي لـ ESLint ، فيجب أيضًا تثبيت أي مكونات إضافية مستخدمة في التهيئة على مستوى العالم.

ترتيب

ملاحظة: إذا كنت قادمًا من إصدار ما قبل 1.0.0 ، فيرجى الاطلاع على دليل الترحيل .

بعد تشغيل eslint --init ، سيكون لديك ملف .eslintrc في الدليل الخاص بك. في ذلك ، سترى بعض القواعد التي تمت تهيئتها على النحو التالي:

{
    "rules": {
        "semi": ["error", "always"],
        "quotes": ["error", "double"]
    }
}

الأسماء "semi" و "quotes" هي أسماء rules في ESLint. القيمة الأولى هي مستوى الخطأ في القاعدة ويمكن أن تكون واحدة من هذه القيم:

  • "off" أو 0 - أوقف تشغيل القاعدة
  • "warn" أو 1 - تشغيل القاعدة كتحذير (لا يؤثر على رمز الخروج)
  • "error" أو 2 - قم بتشغيل القاعدة كخطأ (سيكون رمز الإنهاء 1)

تسمح لك مستويات الخطأ الثلاثة بالتحكم الدقيق في كيفية تطبيق ESLint للقواعد (لمزيد من خيارات التكوين والتفاصيل ، راجع مستندات التكوين ).

.eslintrc ملف التكوين الخاص بك .eslintrc أيضًا السطر:

"extends": "eslint:recommended"

وبسبب هذا السطر ، سيتم تشغيل جميع القواعد التي تحمل علامة "" في rules . بدلاً من ذلك ، يمكنك استخدام التهيئات التي أنشأها الآخرون عن طريق البحث عن "eslint-config" على npmjs.com . لن تقوم ESLint بإدخال رمزك إلا إذا قمت بالتمديد من تكوين مشترك أو تشغيل القواعد بشكل واضح في التهيئة الخاصة بك.

الخطوات التالية