volta run

Команда volta run запустит предоставленную вами команду, используя версии инструментов, указанные в командной строке. Имеет следующий синтаксис:

Запустить команду с пользовательскими версиями Node, npm и/или Yarn

Использование:
    volta run [FLAGS] [OPTIONS] <command> [--] [args]...

ФЛАГИ:
        --bundled-npm    Принудительно использовать npm версию, поставляемую с Node
        --no-yarn        Отключить Yarn
        --verbose        Включить подробную диагностику
        --quiet          Предотвратить ненужный вывод
    -h, --help           Напечатать справочную информацию

ОПЦИИ:
        --node <version>         Установить пользовательскую версию Node
        --npm <version>          Установить пользовательскую версию npm
        --yarn <version>         Установить пользовательскую версию Yarn
        --env <NAME=value>...    Установить переменные окружения (может использоваться несколько раз)

АРГУМЕНТЫ:
    <command>    Команда для запуска
    <args>...    Аргументы для передачи команде

Как это работает

Любой инструмент, для которого версия не указана напрямую, будет определён через обычное обнаружение контекста Volta, используя закреплённые версии в проекте или версии по умолчанию.

Примечание Настройки версий должны быть перед командой, которую вы хотите запустить. Всё после команды будет рассматриваться как аргументы и не будет прочитано Volta.

Примеры

Запуск с конкретной версией Node

# Запустить npm test с Node 14
volta run --node 14 npm test

# Запустить скрипт с последним Node 16
volta run --node 16 node script.js

Запуск с пользовательскими версиями пакетных менеджеров

# Запустить с конкретной версией npm
volta run --npm 7.10.0 npm install

# Запустить с конкретной версией Yarn
volta run --yarn 1.22.10 yarn add express

Комбинирование версий инструментов

# Запустить с конкретными версиями Node и npm
volta run --node 14.17.0 --npm 6.14.13 npm install

# Запустить с Node 16 и Yarn 1.22.10
volta run --node 16 --yarn 1.22.10 yarn build

Использование поставляемого npm или отключение Yarn

# Принудительно использовать версию npm, поставляемую с Node
volta run --bundled-npm npm install

# Отключить Yarn в окружении
volta run --no-yarn some-command

Установка переменных окружения

# Установить одну переменную окружения
volta run --env DEBUG=true npm test

# Установить несколько переменных окружения
volta run --env NODE_ENV=production --env DEBUG=false node server.js

Случаи использования

Команда volta run полезна для:

1. Тестирования с разными версиями: Тестируйте ваш код против разных версий Node.js без изменения настроек по умолчанию или проекта
2. Одноразовые задачи: Запуск команд с конкретными версиями инструментов для специальных задач
3. CI/CD окружения: Использование в конвейерах непрерывной интеграции для тестирования против нескольких версий Node.js
4. Установка зависимостей: Установка зависимостей с конкретными версиями npm или Yarn
5. Временные изменения окружения: Запуск команд с модифицированными переменными окружения без влияния на глобальные настройки

Общие шаблоны

Тестирование против нескольких версий Node

# Тестирование с Node 14
volta run --node 14 npm test

# Тестирование с Node 16
volta run --node 16 npm test

# Тестирование с Node 18
volta run --node 18 npm test

Запуск команд NPX с конкретными версиями

# Запустить create-react-app с конкретной версией Node
volta run --node 16 npx create-react-app my-app

# Выполнить компилятор TypeScript с конкретной версией Node
volta run --node 14 npx tsc

Выполнение скриптов

# Запустить скрипт сборки с конкретным окружением
volta run --env NODE_ENV=production node build.js