نقوم بتنفيذ مشروع Angular على ESLint ، مع Prettier و Husky و lint-staged

أجمل و ESLint

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

eslint example.ts --fix

output:
error    This line has a length of 97. Maximum allowed is 80

إعداد ESLint

التركيب

• eslint - اللنت نفسه ،
• @ angular-eslint / builder  - Angular CLI Builder لتشغيل ESLint لتطبيقات Angular باستخدام الأمر ng lint القياسي ،
• @ angular-eslint / eslint-plugin  - مكون إضافي يحتوي على قواعد للزاوية الزاويّة ،
• @ angular-eslint / template-parser  هو محلل معالزاوي/ المترجم يجعل من الممكن كتابة قواعد لربط القوالب الزاويّة ،
• @ angular-eslint / eslint-plugin-template  - مكون إضافي ، عند استخدامه مع @ angular-eslint / template-parser ، يُطلق قواعد لربط القوالب Angular ،
• @ Typcript-eslint / parser - مكون إضافي لتحليل رمز TypeScript ،
• @ typescript-eslint / eslint-plugin - مكون إضافي يقوم بتشغيل قواعد TypeScript للـ linting.

ng add @angular-eslint/schematics

التكوين التكوين

module.exports = {
  extends: ['plugin:@angular-eslint/recommended'],
  rules: {
    '@angular-eslint/directive-selector': [
      'error',
      { type: 'attribute', prefix: 'app', style: 'camelCase' },
    ],
    '@angular-eslint/component-selector': [
      'error',
      { type: 'element', prefix: 'app', style: 'kebab-case' },
    ],
  },
  overrides: [
    //   ,       *.component.ts
    {
      files: ['*.component.ts'],
      parser: '@typescript-eslint/parser',
      parserOptions: {
        ecmaVersion: 2020,
        sourceType: 'module',
      },
      plugins: ['@angular-eslint/template'],
      processor: '@angular-eslint/template/extract-inline-html',
    },
  ],
};

يمكن وصف Configs بتنسيقات مختلفة: JavaScript أو JSON أو YAML. يمكنك ترك التعليقات في جافا سكريبت.

تحديث أمر Ng lint

"lint": {
  "builder": "@angular-eslint/builder:lint",
  "options": {
    "eslintConfig": ".eslintrc.js",
    "tsConfig": [
      "tsconfig.app.json",
      "tsconfig.spec.json",
      "e2e/tsconfig.json"
    ],
    "exclude": [
      "**/node_modules/**"
    ]
  }
},

تثبيت مكونات إضافية

npm install eslint-plugin-jasmine --save-dev

overrides: [
  ...,
  {
    files: ['src/**/*.spec.ts', 'src/**/*.d.ts'],
    parserOptions: {
      project: './src/tsconfig.spec.json',
    },
    //   
    extends: ['plugin:jasmine/recommended'],
    //    
    plugins: ['jasmine'],
    env: { jasmine: true },
    //   'no-unused-vars'
    rules: {
      '@typescript-eslint/no-unused-vars': 'off',
    },
  }
],

إضافة أدلة دليل النمط

• AirBnB : أكثر الفواصل والفواصل الفاصلة المنقوطة الإلزامية الثلاثة شيوعًا والأكثر صرامة.
• جوجل : على غرار AirBnB من حيث التنسيق ، ولكن أقل صرامة ، تعليقات JSDoc الإلزامية.
• StandartJS : يحظر استخدام الفواصل اللاحقة والفواصل المنقوطة.

اختر تنفيذ دليل نمط TypeScript لأن قواعد JavaScript قد لا تعمل بشكل صحيح على TypeScript.

npm install eslint-plugin-import eslint-config-airbnb-typescript --save-dev

module.exports = {
  ...,
  overrides: [
    ...,
    {
      files: ['*.ts'],
      extends: [
        'airbnb-typescript/base',
      ],
      parser: '@typescript-eslint/parser',
      parserOptions: {
        ecmaVersion: 2020,
        sourceType: 'module',
      },
    },
  ]
}

قواعد التخصيص

module.exports = {
  ...,
  overrides: [
    ...,
    {
      files: ['*.ts'],
      extends: [
        'airbnb-typescript/base',
      ],
      parser: '@typescript-eslint/parser',
      parserOptions: {
        ecmaVersion: 2020,
        sourceType: 'module',
      },
      //  
      rules: {
        'import/no-unresolved': 'off',
        'import/prefer-default-export': 'off',
        'class-methods-use-this': 'off',
        'lines-between-class-members': 'off',
        '@typescript-eslint/unbound-method': [
          'error',
          {
            ignoreStatic: true,
          },
        ],
      },
    },
  ]
}

تكوين أجمل

npm i prettier eslint-config-prettier eslint-plugin-prettier --save-dev

module.exports = {
  ...,
  overrides: [
    ...,
    {
      files: ['*.ts'],
      extends: [
        //   AirBnB
	'airbnb-typescript/base',
	//   Prettier
	'prettier/@typescript-eslint',
	'plugin:prettier/recommended',
      ],
      ...,
    },
  ]
}

• يتضمن eslint-plugin-prettier ،
• طباعة أخطاء قاعدة أجمل / أجمل إلى وحدة التحكم على أنها "خطأ" ،
• يضيف قواعد تنسيق Prettier eslint-config-prettier.

التكوين لجمال:

module.exports = {
  trailingComma: "all",
  tabWidth: 2,
  semi: true,
  singleQuote: true,
  bracketSpacing: true,
  printWidth: 100
};

prettier "--write ."

تكوين رمز VS

  "eslint.validate": [ "javascript", "typescript", "html"],

  "eslint.options": {
    "extensions": [".js", ".ts", "html"]
  },

  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true,
  },

إنشاء خطافات بوابة

npm i husky lint-staged --save-dev

"scripts": {
  ...
},
"husky": {
  "hooks": {
    "pre-commit": "lint-staged --relative"
  }
},
"lint-staged": {
  "*.{js,ts}": [
     "eslint --fix"
  ]
},

الموجودات

المراجع

• المستودع الأحادي
• TypeScript ESLint Monorepository