نحوه استفاده از لینتر بستن

توجه: بسته شدن لینتر منسوخ شده است و دیگر به ندرت در Google استفاده می شود. برای اطلاعات بیشتر به این صفحه مراجعه کنید

این سند نحوه نصب و استفاده از Close Linter را شرح می دهد.

لینتر بسته را نصب کنید

برای دانلود و نصب Closure Linter از ابزار Python pip استفاده کنید.

لینوکس

برای نصب Closure Linter در لینوکس، دستورات زیر را اجرا کنید:

$ 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

پنجره ها

برای نصب Closure Linter در ویندوز:

1. پایتون را برای ویندوز دانلود و نصب کنید.
2. دستور زیر را اجرا کنید:

> pip install https://github.com/google/closure-linter/zipball/master

توجه: پشتیبانی ویندوز برای 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 موجود به درستی استفاده می‌شوند.

پرچم سختگیرانه

اگر می‌خواهید Closure Linter در مورد قوانین سبک مانند فاصله، انواع JsDoc و تگ‌های نویسنده سخت‌گیرانه‌تر باشد، از پرچم خط فرمان --strict استفاده کنید. اگر در حال مشارکت کد در کتابخانه بسته شدن هستید، باید از --strict استفاده کنید.

رفع مشکلات سبک

در هر یک از دستورات بالا، می توانید fixjsstyle را جایگزین fixjsstyle gjslint تا به طور خودکار بسیاری از خطاهایی را که gjslint بررسی می کند، برطرف کنید.

مثلا:

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

قبل از استفاده از fixjsstyle باید از فایل‌های خود نسخه پشتیبان تهیه کنید یا آنها را در یک سیستم کنترل منبع ذخیره کنید، در صورتی که اسکریپت تغییراتی را ایجاد کند که شما نمی‌خواهید.