volta run

El comando volta run ejecutará el comando que le des, usando versiones de herramientas que se especifican en la línea de comandos. Tiene la siguiente sintaxis:

Ejecuta un comando con versiones personalizadas de Node, npm, y/o Yarn

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

FLAGS:
        --bundled-npm    Fuerza que npm sea la versión empaquetada con Node
        --no-yarn        Deshabilita Yarn
        --verbose        Habilita diagnósticos verbosos
        --quiet          Previene salida innecesaria
    -h, --help           Imprime información de ayuda

OPTIONS:
        --node <version>         Establece la versión personalizada de Node
        --npm <version>          Establece la versión personalizada de npm
        --yarn <version>         Establece la versión personalizada de Yarn
        --env <NAME=value>...    Establece una variable de entorno (se puede usar múltiples veces)

ARGS:
    <command>    El comando a ejecutar
    <args>...    Argumentos a pasar al comando

Cómo Funciona

Cualquier herramienta que no tenga una versión especificada directamente tendrá su versión determinada por la detección de contexto usual de Volta, usando las versiones fijadas en un proyecto o las versiones por defecto.

Nota Las configuraciones de versión deben venir antes del comando que deseas ejecutar. Cualquier cosa después del comando será tratada como argumentos y no será leída por Volta.

Ejemplos

Ejecutando con una Versión Específica de Node

# Ejecutar npm test con Node 14
volta run --node 14 npm test

# Ejecutar un script con la última Node 16
volta run --node 16 node script.js

Ejecutando con Versiones Personalizadas de Gestores de Paquetes

# Ejecutar con una versión específica de npm
volta run --npm 7.10.0 npm install

# Ejecutar con una versión específica de Yarn
volta run --yarn 1.22.10 yarn add express

Combinando Versiones de Herramientas

# Ejecutar con versiones específicas de Node y npm
volta run --node 14.17.0 --npm 6.14.13 npm install

# Ejecutar con Node 16 y Yarn 1.22.10
volta run --node 16 --yarn 1.22.10 yarn build

Usando npm Empaquetado o Deshabilitando Yarn

# Forzar usar la versión de npm empaquetada con Node
volta run --bundled-npm npm install

# Deshabilitar Yarn en el entorno
volta run --no-yarn some-command

Estableciendo Variables de Entorno

# Establecer una sola variable de entorno
volta run --env DEBUG=true npm test

# Establecer múltiples variables de entorno
volta run --env NODE_ENV=production --env DEBUG=false node server.js

Casos de Uso

El comando volta run es útil para:

1. Probar con Diferentes Versiones: Probar tu código contra diferentes versiones de Node.js sin cambiar tu configuración por defecto o de proyecto
2. Tareas Puntuales: Ejecutar comandos con versiones específicas de herramientas para tareas especializadas
3. Entornos CI/CD: Usar en pipelines de integración continua para probar contra múltiples versiones de Node.js
4. Instalación de Dependencias: Instalar dependencias con una versión específica de npm o Yarn
5. Cambios Temporales de Entorno: Ejecutar comandos con variables de entorno modificadas sin afectar tu configuración global

Patrones Comunes

Probando A Través de Múltiples Versiones de Node

# Probar con Node 14
volta run --node 14 npm test

# Probar con Node 16
volta run --node 16 npm test

# Probar con Node 18
volta run --node 18 npm test

Ejecutando Comandos NPX con Versiones Específicas

# Ejecutar create-react-app con una versión específica de Node
volta run --node 16 npx create-react-app my-app

# Ejecutar compilador de TypeScript con una versión específica de Node
volta run --node 14 npx tsc

Ejecución de Scripts

# Ejecutar un script de construcción con un entorno específico
volta run --env NODE_ENV=production node build.js