volta run

La commande volta run exécutera la commande que vous fournissez, en utilisant les versions d'outils spécifiées sur la ligne de commande. Elle a la syntaxe suivante :

Exécuter une commande avec des versions personnalisées de Node, npm et/ou Yarn

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

Drapeaux :
        --bundled-npm    Forcer npm à utiliser la version groupée avec Node
        --no-yarn        Désactiver Yarn
        --verbose        Activer les diagnostics détaillés
        --quiet          Empêcher les sorties inutiles
    -h, --help           Imprimer les informations d'aide

Options :
        --node <version>         Définir une version Node personnalisée
        --npm <version>          Définir une version npm personnalisée
        --yarn <version>         Définir une version Yarn personnalisée
        --env <NAME=value>...    Définir des variables d'environnement (peut être utilisé plusieurs fois)

Arguments :
    <command>    La commande à exécuter
    <args>...    Arguments à passer à la commande

Comment ça fonctionne

Tout outil qui n'a pas de version directement spécifiée aura sa version déterminée par la détection de contexte normale de Volta, en utilisant des versions épinglées dans un projet ou des versions par défaut.

Note Les paramètres de version doivent venir avant la commande que vous souhaitez exécuter. Tout ce qui vient après la commande sera traité comme des arguments et ne sera pas lu par Volta.

Exemples

Exécuter avec des versions Node spécifiques

# Exécuter npm test avec Node 14
volta run --node 14 npm test

# Exécuter un script avec la dernière version Node 16
volta run --node 16 node script.js

Exécuter avec des versions de gestionnaire de paquets personnalisées

# Exécuter avec une version npm spécifique
volta run --npm 7.10.0 npm install

# Exécuter avec une version Yarn spécifique
volta run --yarn 1.22.10 yarn add express

Combiner des versions d'outils

# Exécuter avec des versions Node et npm spécifiques
volta run --node 14.17.0 --npm 6.14.13 npm install

# Exécuter avec Node 16 et Yarn 1.22.10
volta run --node 16 --yarn 1.22.10 yarn build

Utiliser npm groupé ou désactiver Yarn

# Forcer l'utilisation de la version npm groupée avec Node
volta run --bundled-npm npm install

# Désactiver Yarn dans l'environnement
volta run --no-yarn some-command

Définir des variables d'environnement

# Définir une seule variable d'environnement
volta run --env DEBUG=true npm test

# Définir plusieurs variables d'environnement
volta run --env NODE_ENV=production --env DEBUG=false node server.js

Cas d'utilisation

La commande volta run est utile pour :

1. Tester avec différentes versions : Tester votre code contre différentes versions de Node.js sans changer vos paramètres par défaut ou de projet
2. Tâches ponctuelles : Exécuter des commandes avec des versions d'outils spécifiques pour des tâches spécialisées
3. Environnements CI/CD : Utiliser dans des pipelines d'intégration continue pour tester contre plusieurs versions de Node.js
4. Installation de dépendances : Installer des dépendances avec des versions spécifiques de npm ou Yarn
5. Changements d'environnement temporaires : Exécuter des commandes avec des variables d'environnement modifiées sans affecter les paramètres globaux

Motifs courants

Tester à travers plusieurs versions Node

# Tester avec Node 14
volta run --node 14 npm test

# Tester avec Node 16
volta run --node 16 npm test

# Tester avec Node 18
volta run --node 18 npm test

Exécuter des commandes NPX avec des versions spécifiques

# Exécuter create-react-app avec une version Node spécifique
volta run --node 16 npx create-react-app my-app

# Exécuter le compilateur TypeScript avec une version Node spécifique
volta run --node 14 npx tsc

Exécution de scripts

# Exécuter un script de build avec un environnement spécifique
volta run --env NODE_ENV=production node build.js