كيفية استخدام إغلاق Linter

ملاحظة: تم إيقاف Closure Linter نهائيًا، ولم يعُد يُستخدم إلا نادرًا في Google. يُرجى الاطّلاع على هذه الصفحة للحصول على مزيد من المعلومات.

يوضّح هذا المستند كيفية تثبيت Closure Linter واستخدامه.

تثبيت Closure Linter

استخدِم أداة Python pip لتنزيل Closure Linter وتثبيتها.

Linux

لتثبيت Closure Linter على نظام التشغيل Linux، نفِّذ الأوامر التالية:

$ sudo apt-get install python-pip
$ sudo pip install https://github.com/google/closure-linter/zipball/master

Mac OS X

لتثبيت Closure Linter على نظام التشغيل Mac OS X، نفِّذ الأمر التالي:

$ sudo easy_install pip
$ sudo pip install https://github.com/google/closure-linter/zipball/master

Windows

لتثبيت Closure Linter على نظام التشغيل Windows، اتّبِع الخطوات التالية:

  1. نزِّل Python لنظام التشغيل Windows وثبِّته.
  2. نفِّذ الأمر التالي:
> pip install https://github.com/google/closure-linter/zipball/master

ملاحظة: يتوفّر دعم Windows لأداة Closure Linter بشكل تجريبي.

العثور على مشاكل في الأسلوب

لتشغيل Closure Linter على ملف واحد، جرِّب ما يلي:

$ gjslint path/to/my/file.js

يجب أن تظهر لك نتائج على النحو التالي:

Line 46, E:0110: Line too long (87 characters).
Line 54, E:0214: Missing description in @return tag
Line 66, E:0012: Illegal semicolon after function declaration
Line 150, E:0120: Binary operator should go on previous line "+"
Line 175, E:0011: Missing semicolon after function assigned to a variable
Line 210, E:0121: Illegal comma at end of array literal
Line 220, E:0002: Missing space before ":"

يمكنك أيضًا التحقّق بشكل متكرّر من دليل كامل، كما يلي:

$ gjslint -r path/to/my/directory

تتحقّق أداة Closure Linter تلقائيًا من توفّر تعليقات JsDoc التوضيحية الصحيحة. إذا كنت لا تريد التحقّق من عدم توفّر تعليقات توضيحية JsDoc في مشروعك، يمكنك إيقاف هذا التحقّق باتّباع الخطوات التالية:

$ gjslint --nojsdoc -r path/to/my/directory

على الرغم من أنّ هذا الخيار يوقف عمليات التحقّق من تعليقات JsDoc الناقصة، إلا أنّ أداة التدقيق اللغوي تواصل التحقّق من أنّ تعليقات JsDoc الحالية مستخدَمة بشكل صحيح.

العلامة ‎--strict

إذا أردت أن تكون أداة Closure Linter أكثر صرامة بشأن قواعد الأنماط، مثل المسافات وأنواع JsDoc وعلامات المؤلف، استخدِم علامة سطر الأوامر --strict. يجب استخدام --strict إذا كنت ستساهم برمز في مكتبة Closure.

حلّ مشاكل الأسلوب

في أيّ من الأوامر أعلاه، يمكنك استبدال fixjsstyle بـ gjslint لإصلاح العديد من الأخطاء تلقائيًا التي يتحقّق منها gjslint.

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

$ fixjsstyle path/to/file1.js path/to/file2.js

يجب الاحتفاظ بنسخة احتياطية من ملفاتك أو تخزينها في نظام للتحكّم في المصدر قبل استخدام fixjsstyle، وذلك في حال أجرى النص البرمجي تغييرات لا تريدها.