Коли ви починаєте працювати з Node.js, ви неминуче стикаєтеся з інструментом під назвою npm. Це не просто утиліта командного рядка, а ціла екосистема, яка забезпечує мільйони розробників по всьому світу готовими бібліотеками, фреймворками та утилітами.
npm (Node Package Manager) складається з двох основних частин: онлайн-реєстру (публічної бази даних пакетів відкритого коду) та клієнтської командної утиліти, яка дозволяє легко встановлювати, оновлювати та видаляти ці пакети у ваших проєктах.
Основні компоненти та принципи роботи npm
Під час ініціалізації будь-якого нового проєкту за допомогою npm створюється кілька ключових структурних елементів:
- Файл
package.json: «Паспорт» вашого проєкту. Він містить метадані (назву, версію, автора), а також списки залежностей (dependencies) – бібліотек, необхідних для роботи програми, та devDependencies (інструменти для збирання й тестування). - Папка
node_modules: Фізичне сховище, куди npm завантажує всі встановлені пакети та їхні власні залежності (транзитивні залежності). Через це папка може розростатися до гігантських розмірів (зазвичай її “ігнорують” при обміні з git-репозиторіями). - Файл
package-lock.json: Фіксує точні версії всіх встановлених пакетів та їхнє дерево, гарантуючи, що на будь-якому іншому комп’ютері (чи сервері) зберуться абсолютно ідентичні залежності.
Основні команди npm: шпаргалка для розробника
Для повсякденної роботи з пакетами вам знадобиться базовий набір команд у терміналі:
| Команда | Призначення | Приклад використання |
|---|---|---|
npm init |
Створює новий файл package.json у корені проєкту. |
npm init -y (створення з дефолтними налаштуваннями) |
npm install (або i) |
Встановлює всі залежності, описані в package.json. |
npm install express (встановлення конкретного пакета) |
npm run |
Запускає кастомні скрипти, прописані в секції scripts файлу package.json. |
npm run dev або npm run build |
npm update |
Оновлює пакети до актуальних версій згідно з правилами семантичного версіонування. | npm update |
npm audit |
Сканує проєкт на наявність відомих вразливостей у сторонніх пакетах. | npm audit fix (автоматичне виправлення проблем) |
Практичний приклад: налаштування скриптів у package.json
Одна з найпотужніших можливостей npm – автоматизація рутинних завдань за допомогою скриптів. Ось приклад того, як виглядає налаштування запуску проєкту у файлі package.json:
{
"name": "my-node-app",
"version": "1.0.0",
"description": "Мій тестовий проєкт на Node.js",
"main": "index.js",
"scripts": {
"start": "node index.js",
"dev": "nodemon index.js",
"test": "echo \"Помилка: тести не налаштовані\" && exit 1"
},
"dependencies": {
"express": "^4.19.2"
}
}
Тепер замість того, щоб щоразу писати довгу команду node index.js або запускати наглядача nodemon, достатньо ввести в терміналі коротку команду npm run dev.
Технічна порада розробника: Ніколи не додавайте папку
node_modulesдо системи контролю версій Git (додайте її до файлу.gitignore). Обсяг цієї папки може становити сотні мегабайт, а код у ній є похідним. Для розгортання проєкту на сервері чи комп’ютері колеги достатньо мати лише файлиpackage.jsonтаpackage-lock.json, після чого виконати командуnpm install, яка автоматично відродить усе дерево залежностей.