volta run

O comando volta run irá executar o comando que você fornecer, usando versões de ferramentas especificadas na linha de comando. Ele tem a seguinte sintaxe:

Executar comando com versões personalizadas de Node, npm e/ou Yarn

Uso:
    volta run [FLAGS] [OPTIONS] <command> [--] [args]...

Flags:
        --bundled-npm    Forçar npm a usar versão empacotada com Node
        --no-yarn        Desabilitar Yarn
        --verbose        Habilitar diagnósticos detalhados
        --quiet          Prevenir saída desnecessária
    -h, --help           Imprimir informações de ajuda

Opções:
        --node <version>         Definir versão personalizada do Node
        --npm <version>          Definir versão personalizada do npm
        --yarn <version>         Definir versão personalizada do Yarn
        --env <NAME=value>...    Definir variáveis de ambiente (pode ser usado múltiplas vezes)

Argumentos:
    <command>    Comando a ser executado
    <args>...    Argumentos passados para o comando

Como Funciona

Qualquer ferramenta sem versão diretamente especificada terá sua versão determinada através da detecção de contexto regular do Volta, usando versões fixadas no projeto ou versões padrão.

Nota Configurações de versão devem vir antes do comando que você deseja executar. Qualquer coisa após o comando será tratada como argumentos e não será lida pelo Volta.

Exemplos

Executar com Versão Específica do Node

# Executar npm test com Node 14
volta run --node 14 npm test

# Executar script com a versão mais recente do Node 16
volta run --node 16 node script.js

Executar com Versões Personalizadas de Gerenciadores de Pacotes

# Executar com versão específica do npm
volta run --npm 7.10.0 npm install

# Executar com versão específica do Yarn
volta run --yarn 1.22.10 yarn add express

Combinar Versões de Ferramentas

# Executar com versões específicas de Node e npm
volta run --node 14.17.0 --npm 6.14.13 npm install

# Executar com Node 16 e Yarn 1.22.10
volta run --node 16 --yarn 1.22.10 yarn build

Usar npm Empacotado ou Desabilitar Yarn

# Forçar uso da versão do npm empacotada com Node
volta run --bundled-npm npm install

# Desabilitar Yarn no ambiente
volta run --no-yarn some-command

Definir Variáveis de Ambiente

# Definir uma única variável de ambiente
volta run --env DEBUG=true npm test

# Definir múltiplas variáveis de ambiente
volta run --env NODE_ENV=production --env DEBUG=false node server.js

Casos de Uso

O comando volta run é útil para:

1. Testar com diferentes versões: Testar seu código contra diferentes versões do Node.js sem alterar configurações padrão ou de projeto
2. Tarefas únicas: Executar comandos com versões específicas de ferramentas para tarefas especializadas
3. Ambientes CI/CD: Usar em pipelines de integração contínua para testar contra múltiplas versões do Node.js
4. Instalação de dependências: Instalar dependências com versões específicas do npm ou Yarn
5. Mudanças temporárias de ambiente: Executar comandos com variáveis de ambiente modificadas sem afetar configurações globais

Padrões Comuns

Testar em Múltiplas Versões do Node

# Testar com Node 14
volta run --node 14 npm test

# Testar com Node 16
volta run --node 16 npm test

# Testar com Node 18
volta run --node 18 npm test

Executar Comandos NPX com Versões Específicas

# Executar create-react-app com versão específica do Node
volta run --node 16 npx create-react-app my-app

# Executar compilador TypeScript com versão específica do Node
volta run --node 14 npx tsc

Execução de Scripts

# Executar script de build com ambiente específico
volta run --env NODE_ENV=production node build.js