{"canonical_url":"https://engineer.company/uk/glossary/eslint/","content_markdown":"# ESLint\n\n## Що це таке\n\nESLint — це відкритий інструмент статичного аналізу, який читає вихідний код\nJavaScript-проєкту, звіряє його з набором налаштованих правил і повідомляє про\nкожне місце, де код порушує якесь із них, а прості випадки на прохання виправляє\nсам. У командному рядку це команда `eslint`, яку встановлюють із npm як\nзалежність для розробки того проєкту, що його перевіряють. Ніколас Закас\n(Nicholas C. Zakas) почав проєкт у червні 2013 року, і сам проєкт досі називає\nсебе конфігурованим JavaScript-лінтером.\n\nПрограми, яку перевіряє, ESLint ніколи не запускає. Парсер перетворює кожен файл\nна абстрактне синтаксичне дерево у форматі ESTree, а кожне правило — це\nневеликий модуль, який просить викликати його на певних видах вузлів: на кожній\nфункції, кожному порівнянні, кожному `await`. Правило розглядає те, що йому\nпередали, і якщо щось не так, повідомляє текст і місце. Деякі правила мають ще й\nвиправлення, тобто правку, яку проєкт приймає лише тоді, коли вона усуває\nпроблему, не змінюючи того, що робить програма, і `eslint --fix` записує такі\nправки просто у файли. Інші правила натомість пропонують підказки. Вони можуть\nзмінити поведінку, тож їх застосовує людина, по одній, у редакторі.\n\nМайже все довкола цього ядра можна замінити. Плагіни — це npm-пакети, що додають\nправила, спільні конфігурації, процесори або підтримку інших мов. Інший парсер\nдає ESLint змогу читати синтаксис, якого стандартний не розуміє, наприклад\nTypeScript. Процесори видобувають JavaScript з інших файлів, скажімо з блоків\nкоду в документі Markdown, а форматери визначають, у якому вигляді буде\nнадруковано звіт. Власну філософію проєкт описує так: кожне правило стоїть\nокремо, його можна вимкнути, і кожному можна окремо задати, чи воно лише\nпопереджає, чи завершує перевірку помилкою.\n\nУсе це задають в одному JavaScript-файлі в корені проєкту, зазвичай\n`eslint.config.js` або його варіантах `.mjs` і `.cjs`, який експортує масив\nоб'єктів. Кожен об'єкт називає файли, до яких застосовується, а також правила,\nглобальні змінні й параметри парсера для них, і пізніші об'єкти перекривають\nпопередні. Такий устрій, який називають flat config, став типовим у версії\nv9.0.0, що вийшла 5 квітня 2024 року. Версія v10.0.0 від 6 лютого 2026 року\nостаточно прибрала старий формат `.eslintrc` і файл `.eslintignore`.\n\n## Чому це важливо\n\nЛінтер виправдовує себе в одну мить: коли зупиняє зміну, перш ніж її зіллють.\nESLint ухвалює це рішення через код виходу, а код виходу залежить від\nсерйозності правил. Кожне правило має значення `\"off\"`, `\"warn\"` або `\"error\"`.\nПомилка змушує команду `eslint` завершитися з кодом 1. Попередження друкується,\nале команда все одно завершується з кодом 0, хіба що `--max-warnings` задає\nмежу, а ця межа типово вимкнена. Код 2 означає зламану конфігурацію або\nвнутрішній збій.\n\nТож справжнє рішення, яке розробники ухвалюють щодо ESLint, — що має означати\nпопередження. Попередження, яке ніколи не зупиняє збірку, — це порада, а поради\nв терміналі прогортають, щойно їх набирається сорок рядків. Ті, хто хоче, щоб\nлінтер тримав межу, або ставлять кожному важливому для них правилу `\"error\"`,\nабо запускають перевірку з `--max-warnings 0`. Так чи так вивід на здоровій\nгілці порожній, і один новий рядок стає новиною, яку хтось таки прочитає.\n\nВиграш — у тому, що JavaScript пропускає. Мова без заперечень завантажить файл,\nякий звертається до змінної, якої ніхто не оголосив, двічі задає той самий ключ\nв об'єктному літералі, порівнює значення з `NaN` через `===` або має після\n`return` код, що ніколи не виконається. Ці проблеми можуть не завадити завантаженню й залишитися непоміченими\nабо спричинити неправильну поведінку під час виконання коду, зокрема й у\nробочому середовищі. Правила з рекомендованого набору ESLint ловлять усі чотири ще до\nрев'ю, тож рецензент може читати зміну заради її задуму.\n\nУ цього є ціна. Конфігурація обростає уподобаннями, і правило, що спрацьовує на\nправильному коді, привчає людей не читати вивід, а це гірше, ніж не мати правила\nвзагалі. До того ж лінтер вартий рівно стільки, скільки вартий момент, коли його\nзапускають: якщо він працює лише в редакторі й лише на частині машин, то\nперевіряє частину коду частину часу.\n\n## Як це виглядає на практиці\n\nESLint був одним із шести лінтерів, на яких трималася\n[планка нуля попереджень для шести мов](/uk/portfolio/set-a-zero-warnings-bar-across-six-languages/):\nтам він перевіряв TypeScript поряд із golangci-lint для Go, SQLFluff для SQL,\nRuff для Python, ShellCheck для shell-скриптів і markdownlint для Markdown.\nПланку втримало саме питання серйозності, вирішене раз і для всіх: кожна\nдіагностика лінтера — помилка, рівня «warn», де можна сховатися, немає, а\ninline-придушення заборонені. Хуки pre-commit і pre-push запускають лінтери й тести; невдачі в охопленому\nнаборі правил і тестів блокують відповідний коміт або push.\n\nТой самий репозиторій згодом потребував правил, яких не постачає жоден\nопублікований пакет, — правил про те, як має працювати саме ця кодова база.\n[П'ятнадцять власних правил ESLint утримують патерни проєкту в TypeScript](/uk/portfolio/built-a-268-check-guard-engine-for-the-repo/)\nпоряд із 274 скриптами перевірок, 268 із яких зареєстровано в commit-хуках. Один\nіз валідаторів стежить, щоб ніхто тихцем не додав inline-придушення. Самі\nguard-перевірки мають 146 власних тестів, бо зламана перевірка пропускає все, і\nніхто про це не дізнається, а сторінка прямо називає ціну: комітити повільно.\n\nЦей сайт тримає власні скрипти збірки на тій самій планці, лише в меншому\nмасштабі. Його `eslint.config.mjs` починається з `js.configs.recommended` і\nдодає тільки ті правила, які код уже проходив на момент вимірювання. Коментарі\nфіксують повторне вимірювання 15 жовтня 2026 року по всіх 199 незастарілих\nправилах, після якого ввімкнули ще 21 правило, і всі вони стосуються\nкоректності, а не смаку. Кожне правило — помилка.\n`reportUnusedDisableDirectives`, що типово є попередженням, теж піднято до\nпомилки, тож коментар-вимикач, який уже нічого не придушує, завершує запуск\nпомилкою. Скрипти оголошують глобальні змінні Node і браузера разом, бо тіла\nфункцій, які вони передають у `page.evaluate`, виконуються в браузері, за кілька\nрядків від коду, що працює в Node.\n\n## Де виникають проблеми\n\nЗдебільшого клопіт з ESLint — це лінтер, який робить саме те, що каже\nконфігурація, а це не завжди те, що вона каже на думку розробників.\n\n**Збірка зелена, а термінал повний попереджень.** Попередження лишають код\nвиходу 0, тож CI проходить, а список щотижня росте на кілька рядків, і зрештою в\nньому непрочитаною лежить справжня вада. Вирішіть, які правила важливі, поставте\nїм `\"error\"`, решту вимкніть і додайте `--max-warnings 0` до перевірки, щоб\nпопередження більше не накопичувалися.\n\n**Коментар-вимикач переживає свою причину.** Колись рядок приглушили з поважної\nпричини; код під ним змінився, коментар лишився, і тепер він ховає наступну\nпроблему в цьому рядку або взагалі нічого. Задайте\n`linterOptions.reportUnusedDisableDirectives` значення `\"error\"`, щоб директиви,\nякі нічого не придушують, завершували запуск помилкою, і вимагайте пояснення\nпісля `--` для тих, що лишаються, щоб рецензент міг їх оцінити:\n\n```js\n// eslint-disable-next-line no-console -- друк і є виводом цього CLI\nconsole.log(report);\n```\n\n**Оновлення змінює, які файли перевіряються.** Після переходу на v10 шляхи, які\nраніше пропускав `.eslintignore`, раптом потрапляють у звіт, або одна тека\nпочинає жити за іншими правилами. Версія 10 ігнорує і `.eslintrc.*`, і\n`.eslintignore`, а `eslint.config.*` шукає, починаючи з теки кожного файлу, що\nперевіряється, тож забута конфігурація в підтеці тепер керує цією підтекою.\nПеренесіть ігнорування в глобальний об'єкт `ignores`, перетворіть старий файл\nкомандою `npx @eslint/migrate-config .eslintrc.json` і перегляньте те, що вона\nзапише, а тоді знайдіть кожен `eslint.config.*` у дереві й видаліть ті, які\nніхто не збирався лишати.\n\n**Код для браузера позначено як неоголошений.** Скрипт Node, що передає функції\nв браузер, отримує помилки `no-undef` на `document` і `window`, і хтось вимикає\n`no-undef`, а разом із ним ховаються й справжні одруківки. Оголосіть кожне\nсередовище, у якому код справді виконується, через `languageOptions.globals` для\nтих файлів, що там працюють.\n\n**Власне правило пропускає все.** Правило, чий обробник указує на тип вузла,\nякий ніколи не трапляється, або чия умова перевернута, просто завжди мовчить, а\nмовчання виглядає точнісінько як дотримання правил. Тестуйте кожне власне\nправило за допомогою `RuleTester` з ESLint на коді, який має пройти, і на коді,\nякий має впасти, щоб правило, яке перестало спрацьовувати, провалило власний\nтест раніше, ніж підведе кодову базу.\n\n## Що почитати далі\n\n- [Core Concepts](https://eslint.org/docs/latest/use/core-concepts/) — правила,\n  виправлення, плагіни, парсери й процесори в тому вигляді, як їх визначає сам\n  проєкт.\n- [Configuration Files](https://eslint.org/docs/latest/use/configure/configuration-files)\n  — масив flat config, шаблони файлів, глобальні ігнорування і те, як об'єкти\n  зливаються.\n- [Configure Rules](https://eslint.org/docs/latest/use/configure/rules) — рівні\n  серйозності, параметри правил і коментарі, що вимикають правило для одного\n  рядка.\n- [Command Line Interface Reference](https://eslint.org/docs/latest/use/command-line-interface)\n  — кожен прапорець, зокрема `--max-warnings`, і значення кожного коду виходу.\n- [ESLint v10.0.0 released](https://eslint.org/blog/2026/02/eslint-v10.0.0-released/)\n  — нотатки до випуску про вилучення eslintrc і новий спосіб шукати\n  конфігурацію.\n- [Custom Rules](https://eslint.org/docs/latest/extend/custom-rules) — як\n  написати правило для синтаксичного дерева і довести його роботу за допомогою\n  `RuleTester`.\n\n\u003chttps://engineer.company/uk/glossary/eslint/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як ESLint читає JavaScript у вигляді синтаксичного дерева, чому рівень серйозності правила вирішує долю збірки і де конфігурація тихо пропускає код.","formats":{"gemtext":"https://engineer.company/uk/glossary/eslint/index.gmi","gopher":"https://engineer.company/uk/glossary/eslint/gophermap","html":"https://engineer.company/uk/glossary/eslint/","json":"https://engineer.company/uk/glossary/eslint/index.json","markdown":"https://engineer.company/uk/glossary/eslint/index.md","pdf":"https://engineer.company/uk/glossary/eslint/index.pdf"},"kind":"page","language":"uk","title":"Що таке ESLint?","url":"https://engineer.company/uk/glossary/eslint/","version":1}