npm — менеджер пакетов Node.js: установка и основные команды

npm (аббр. node package manager) - это стандартный менеджер пакетов Node. У каждого пакета npm в реестре существует сайт, на котором хранится Readme-файл, информация об авторе и статистика о загрузках. Программой npm занимает­ся npm, Inc. — компания, обеспечивающая работу сервиса npm и предоставляющая услуги коммерческим организациям.

Установить можно из репозитория ОС или с сайта https://www.npmjs.com

# curl http://npmjs.org/install.sh | sh
$ which npm
/usr/local/bin/npm

Пример. Установим модуль express, второй вариант установка модуля express конкретной версии.

# cd /opt/nodejs/
# npm install express
# npm install express@1.0.0

В дальнейшем модуль можно загружать по абсолютному пути require('/opt/nodejs/node_modules/express/express.js'

Модули можно устанавливать глобально, для этого используется ключ -g.

# npm install always -g

Пример. Поиск модулей например, Jade движок шаблонов:

# npm search jade
...
jade                 Jade template engine                                          =tjholowaychuk
jade-browser         express/connect middleware that serves jade compiled templates to the browser =nw =storify
jade-client-connect  Jade Client Connect - A compiler to help use templates on a web client =sioked
...                                                                           =rauchg

Все скрипты описываются в разделе `"scripts"` файла `package.json`. В этом разделе задаются команды, которые позволяют автоматизировать выполнение различных задач — сборку, тестирование, запуск локального сервера и другие.

Для запуска пользовательских скриптов используется команда:

npm run

Например, если в `package.json` есть скрипт `"dev": "node app.js"`, то запустить его можно так:

npm run dev

Чтобы увидеть список всех доступных скриптов в вашем проекте, достаточно выполнить в терминале команду:

npm run

Это удобный способ быстро узнать, какие команды можно использовать.

package.json - это ключевой файл во многих проектах JavaScript, особенно тех, которые используют Node.js. Когда речь идет о package.json в контексте исключительно проектов Node.js, его роль становится еще более специализированной. В контексте Node.js, package.json не просто файл конфигурации; он является фундаментальным инструментом, обеспечивающим эффективное и организованное управление проектом.

1. Управление зависимостями Node.js: Файл package.json перечисляет все зависимости проекта Node.js. Эти зависимости автоматически устанавливаются с помощью Node.js пакетного менеджера npm (Node Package Manager) при выполнении команды npm install. Раздел dependencies содержит пакеты, необходимые для выполнения приложения, в то время как devDependencies включает пакеты, необходимые только для разработки, например, инструменты для тестирования или линтинга.

{
  "devDependencies": {
    "canvas-chart": "~1.3.0"
  }
}

1. Скрипты для автоматизации задач: В package.json можно определить скрипты для упрощения выполнения рутинных задач в процессе разработки. Например, скрипты для запуска сервера, автоматической компиляции исходного кода, запуска тестов и так далее. Это позволяет разработчикам использовать простые команды, такие как npm start или npm test, для выполнения сложных последовательностей действий.
2. Метаданные проекта: package.json включает в себя информацию о проекте, такую как его имя, версия, автор(ы), описание и лицензия. Эти данные важны не только для идентификации проекта, но и при публикации пакета на npm.
3. Конфигурация проекта и пакетов: Файл может содержать настройки, специфичные для проекта или отдельных пакетов. Это позволяет настраивать поведение различных инструментов и библиотек в рамках проекта.
4. Совместимость и версионирование: package.json управляет версиями зависимостей, что критично для обеспечения совместимости между разными разработчиками и в различных средах (разработка, тестирование, продакшн). Файл может содержать точные версии, диапазоны версий или использовать другие механизмы для определения того, какие версии зависимостей должны использоваться.

Файл package.json – это конфигурационный файл проекта, где содержатся основные сведения, такие как название проекта, версия, автор, а также список зависимостей. Создание его возможно с помощью команды:

npm init

После выполнения которой вы отвечаете на вопрос о конфигурации проекта.

Файл package-lock.json используется для фиксации всех версий установленных пакетов. Это гарантирует, что все разработчики, использующие проект, получат одинаковые версии пакетов, что способствует стабильности и единообразию среди участников команды. То есть обычно файл используется для установки фиксированных версий, прописанных именно в package-lock.json. Для такой установки используют команду:

npm ci

Если у проекта есть файл package.json, то установить все зависимости этого проекта можно следующей командой:

npm install

Эта команда загрузит все, что нужно проекту, и поместит эти материалы в папку node_modules, создав ее в том случае, если она не существует в директории проекта.