Шпаргалка по npm

Node.js

Команды помогают узнать версию Node.js,

node -h — показывает список всех доступных команд Node.js. Вывод примерно такой:

    Usage: node [options] [ script.js ] [arguments]
    node inspect [options] [ script.js | host:port ] [arguments]

    Options:
    -                                          script read from stdin (default if no file name is provided,
                                                interactive mode if a tty)
    --                                         indicate the end of node options
    --abort-on-uncaught-exception              aborting instead of exiting causes a core file to be
                                                generated for analysis
    ...

node -v, node --version — показывает установленную версию Node.js. Вывод примерно такой:

v18.17.1

NPM

npm -h — показывает список всех доступных команд пакетного менеджера. Вывод примерно такой:

        npm <command>

        Usage:
        
        npm install        install all the dependencies in your project
        npm install <foo>  add the <foo> dependency to your project
        npm test           run this project's tests
        ...
        
        All commands:
        
            access, adduser, audit, bugs, cache, ci, completion,
            ...

npm -v, npm --version — показывает установленную версию npm.

10.9.0

Команда npm update npm -g позволяет обновить версию npm. Вывод примерно такой:

npm list --depth=0 показывает список установленных пакетов. Вывод примерно такой:

    project@ Path/to/project
    ├── @popperjs/core@2.11.8
    ├── axios@1.7.4
    ...
    ├── sass@1.77.6
    └── vite@5.4.1    

Список установленных пакетов может быть довольно длинным, особенно, если вы давно пишете код.

Команда npm outdated --depth=0 покажет список установленных пакетов, которые требуют обновления. Вывод примерно такой:

    Package  Current  Wanted  Latest  Location            Depended by
    axios      1.7.4   1.7.7   1.7.7  node_modules/axios  project
    sass      1.77.6  1.77.6  1.80.2  node_modules/sass   project
    vite       5.4.1   5.4.9   5.4.9  node_modules/vite   project

Если все пакеты обновлены, список будет пустым.

Команда npm install package — позволяет установить любой пакет по его имени. Если при этом к команде добавить префикс -g пакет будет установлен глобально на весь компьютер.

Команда npm i package является укороченной альтернативой предыдущей команды.

Если вы хотите установить конкретную версию пакета, воспользуйтесь префиксом @ с номером версии. Например, npm install package@1.0.1.

Команда npm uninstall package — удаляет установленный пакет по имени.

Команда npm list package — покажет версию установленного пакета, а команда npm view package version — последнюю версию пакета, которая существует.

Для работы с пакетным менеджером также пригодится файл package.json, который должен лежать в директории, с которой происходит работа в консоли. Он содержит различные мета-данные, например, имя проекта, версия, описания и автор. Также он содержит список зависимостей, которые будут установлены, если вызвать из этой папки команду npm install.

Кроме этого он ещё имеет скрипты, которые вызывают другие команды консоли. Например, для этого файла вызов команды npm start вызовет запуск задачи Grunt с именем dev. А команда npm run build вызовет скрипт build, который запустит задачу в Grunt с именем build.

Ключи

Если установить пакет с ключем --save (короткая версия -s), то он автоматически запишется в package.json в раздел dependencies.

npm install axios --save

В файле package.json

    ...
    "dependencies": {
        ...
        "axios": "^1.7.7",
        ...
    }
    ...

Такая же команда с ключем --save-dev (-D) запишет пакет в раздел devDependencies.

Команда с ключем --save-exact (-E) зафиксирует версию пакета. В package.json версия такого пакета будет указана без символа ^. Такой пакет не будет обновляться командой npm update. А в выводе команды npm outdated версии Current и Wanted будут идентичны.