Руководство для начинающих по npm — менеджер пакетов Node

 const mkdirp = require("mkdirp"); mkdirp("foo", function(err) { if (err) console.error(err); else console.log("Directory created!"); }); 

И запустить его из терминала:

 $ node mkdir.js Directory created! 

Переустановка зависимостей проекта

Давайте сначала установим еще один пакет:

 $ npm install request + request@2.88.0 added 48 packages from 59 contributors and audited 65 packages in 2.73s found 0 vulnerabilities 

Проверьте package.json .

 "dependencies": { "mkdirp": "^0.5.1", "request": "^2.88.0", "underscore": "^1.9.1" }, 

Обратите внимание, что список зависимостей обновляется автоматически. В предыдущих версиях npm вам приходилось выполнять npm install request --save чтобы сохранить зависимость в package.json . Если вы хотите установить пакет без сохранения его в package.json , просто используйте аргумент --no-save .

Предположим, вы клонировали исходный код своего проекта на другой компьютер, и мы хотим установить зависимости. Давайте сначала node_modules папку node_modules затем выполним npm install

 $ rm -R node-modules $ npm list project@1.0.0 /home/sitepoint/project ├── UNMET DEPENDENCY mkdirp@^0.5.1 ├── UNMET DEPENDENCY request@^2.88.0 └── UNMET DEPENDENCY underscore@^1.9.1 npm ERR! missing: mkdirp@^0.5.1, required by project@1.0.0 npm ERR! missing: request@^2.88.0, required by project@1.0.0 npm ERR! missing: underscore@^1.9.1, required by project@1.0.0 $ npm install added 51 packages from 60 contributors and audited 66 packages in 2.419s found 0 vulnerabilities 

Если вы посмотрите на папку node_modules , то увидите, что она снова воссоздается. Таким образом, вы можете легко делиться своим кодом с другими, не раздувая свои проекты и исходные хранилища зависимостями.

Управление кешем

Когда npm устанавливает пакет, он сохраняет копию, поэтому в следующий раз, когда вы захотите установить этот пакет, он не должен попадать в сеть. Копии кэшируются в каталоге .npm вашего домашнего каталога.

 $ ls ~/.npm anonymous-cli-metrics.json _cacache index-v5 _locks _logs node-sass 

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

 $ npm cache clean --force 

Вы также можете удалить все папки node_module из вашей рабочей области, если в вашей системе есть несколько проектов узлов, которые вы хотите очистить.

 find . -name "node_modules" -type d -exec rm -rf '{}' + 

аудит

В npm была представлена ​​новая функция, которая позволяет разработчикам сканировать зависимости на наличие известных уязвимостей безопасности. Давайте попробуем эту функцию, установив старую версию express .

 $ npm install express@4.8.0 express@4.8.0 added 36 packages from 24 contributors and audited 123 packages in 15.97s found 21 vulnerabilities (8 low, 9 moderate, 4 high) run `npm audit fix` to fix them, or `npm audit` for details 

Как только мы закончим установку, мы получим быстрый отчет о том, что было обнаружено несколько уязвимостей. Вы можете запустить команду npm audit для просмотра более подробной информации.

 $ npm run audit === npm audit security report === # Run npm install express@4.16.4 to resolve 21 vulnerabilities ┌───────────────┬──────────────────────────────────────────────────────────────┐ │ High │ Regular Expression Denial of Service │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ Package │ negotiator │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ Dependency of │ express │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ Path │ express > accepts > negotiator │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ More info │ https://nodesecurity.io/advisories/106 │ └───────────────┴──────────────────────────────────────────────────────────────┘ ┌───────────────┬──────────────────────────────────────────────────────────────┐ │ Moderate │ Timing Attack │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ Package │ cookie-signature │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ Dependency of │ express │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ Path │ express > cookie-signature │ ├───────────────┼──────────────────────────────────────────────────────────────┤ │ More info │ https://nodesecurity.io/advisories/134 │ └───────────────┴──────────────────────────────────────────────────────────────┘ 

Вы получите подробный список пакетов с уязвимостями. Если вы посмотрите на поле «Путь», оно показывает путь зависимости. Например, «Путь express > accepts > negotiator означает, что «Экспресс» зависит от пакета « Accepts . Пакет Accepts зависит от negotiator который содержит уязвимость.

Есть два способа решения всех этих проблем. Мы можем либо выполнить команду npm install express@4.16.4 как предложено, либо запустить npm audit fix . Давайте сделаем последнее:

 $ npm audit fix + express@4.16.4 added 15 packages from 11 contributors, removed 8 packages and updated 28 packages in 5.302s fixed 21 of 21 vulnerabilities in 123 scanned packages 

Как видно из приведенного выше отчета, все уязвимости устранены. npm audit fix команды npm audit fix просто обновило затронутые пакеты до последних версий. Тем не менее, обратите внимание, что не все уязвимости могут быть исправлены автоматически. Это может произойти, если вы используете пакет, который претерпел серьезные изменения, которые могут нарушить ваш текущий проект в случае его обновления. В таких ситуациях вам придется пересмотреть свой код и выполнить обновление вручную.

Вы также можете запустить npm audit fix --force если вы не против обновить пакеты с помощью критических изменений. После выполнения команды запустите npm audit чтобы убедиться, что все уязвимости устранены.

Псевдонимы

Как вы могли заметить, существует несколько способов запуска команд npm. Вот краткий список некоторых часто используемых псевдонимов npm:

• npm i <package> — установить локальный пакет
• npm i -g </package><package> — установить глобальный пакет
• npm un </package><package> — удалить локальный пакет
• npm up — пакеты обновлений npm
• npm t — запустить тесты
• npm ls — список установленных модулей
• npm ll или npm la — выводить дополнительную информацию о пакете при перечислении модулей

Вы также можете установить несколько пакетов одновременно, как это:

 $ npm i express momemt lodash mongoose body-parser webpack 

Если вы хотите изучить все распространенные команды npm, просто выполните npm help для получения полного списка. Вы также можете узнать больше в нашей статье 10 советов и хитростей, которые сделают вас ниндзя npm .

Менеджеры версий

Существует несколько доступных инструментов, которые позволяют вам управлять несколькими версиями Node.js на одном компьютере. Одним из таких инструментов является п . Другим таким инструментом является nvm (Node Version Manager). Если вы работаете в Windows, вы можете проверить nvm для Windows Если это то, что вас интересует, почему бы не проверить наш учебник: Установите несколько версий Node.js, используя nvm .

Вывод

В этом уроке я рассмотрел основы работы с npm. Я продемонстрировал, как установить Node.js со страницы загрузки проекта, как изменить расположение глобальных пакетов (чтобы мы могли избежать использования sudo ) и как устанавливать пакеты в локальном и глобальном режиме. Я также рассмотрел удаление, обновление и установку определенной версии пакета, а также управление зависимостями проекта. Если вы хотите узнать больше о новых функциях в последних выпусках, вы можете посетить страницу релизов npm Github .

С версией 5 npm делает огромные шаги в мире фронт-энда. Согласно своему операционному директору , его пользовательская база меняется, и большинство тех, кто его использует, вообще не используют его для написания Node. Скорее он становится инструментом, который люди используют для объединения JavaScript на внешнем интерфейсе (серьезно, вы можете использовать его для установки практически всего), и становится неотъемлемой частью написания современного JavaScript. Вы используете npm в своих проектах? Если нет, то сейчас самое время начать.

Эта статья была рецензирована Грэмом Коксом . Спасибо всем рецензентам SitePoint за то, что сделали контент SitePoint как можно лучше!