Как настроить ESLint с учётом TypeScript-типизации?

Настройка ESLint для TypeScript

ESLint — это инструмент для статического анализа кода, который помогает находить ошибки и поддерживать единый стиль. Для работы с TypeScript требуется специальный парсер, который понимает синтаксис TypeScript, и плагин с правилами, учитывающими типизацию.

Установка зависимостей

Установите необходимые пакеты через npm или yarn:

npm install --save-dev eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin

Конфигурация .eslintrc

Создайте файл .eslintrc.json (или .js/.yaml) и настройте его:

{
  "parser": "@typescript-eslint/parser",
  "plugins": ["@typescript-eslint"],
  "extends": [
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended"
  ],
  "rules": {
    "@typescript-eslint/no-unused-vars": "error",
    "@typescript-eslint/explicit-function-return-type": "warn"
  }
}

Парсер @typescript-eslint/parser преобразует TypeScript-код в AST, понятный ESLint. Плагин @typescript-eslint/eslint-plugin добавляет правила, специфичные для TypeScript, например, проверку типов возвращаемых значений.

Интеграция с проектом

Добавьте скрипты в package.json:

"scripts": {
  "lint": "eslint src/**/*.ts",
  "lint:fix": "eslint src/**/*.ts --fix"
}

Запустите линтинг командой npm run lint. Для автоматического исправления ошибок используйте npm run lint:fix.

Вывод

Настройка ESLint с TypeScript помогает автоматически выявлять потенциальные ошибки, связанные с типами, и поддерживать единый стиль кода. Это особенно полезно в больших проектах с командной разработкой, где важна согласованность и качество кода.