Configuración

Volta usa varios archivos de configuración para gestionar tu cadena de herramientas JavaScript. Esta referencia explica las opciones de configuración disponibles y sus formatos.

Configuración del Proyecto

Las configuraciones específicas del proyecto se almacenan en el archivo package.json de tu proyecto bajo la clave volta.

Formato

{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0",
    "yarn": "1.22.19",
    "extends": "../shared-volta-config.json"
  }
}

Propiedades

Propiedad	Tipo	Descripción
node	String	La versión de Node.js a usar en este proyecto
npm	String	La versión de npm a usar en este proyecto
yarn	String	La versión de Yarn a usar en este proyecto
pnpm	String	La versión de pnpm a usar en este proyecto
extends	String	Ruta a un archivo de configuración compartido de Volta

Formato de Versión

Las cadenas de versión en la configuración volta pueden usar los siguientes formatos:

• Versión exacta: 16.14.2
• Solo versión mayor: 16
• Mayor y menor: 16.14
• Rangos de versión (npm semver): ^16.14.0
• Etiquetas: latest, lts

Configuración Compartida del Proyecto

Puedes crear configuraciones compartidas de Volta que múltiples proyectos pueden extender. Esto es útil para organizaciones que quieren estandarizar versiones de herramientas a través de proyectos.

Formato

{
  "node": "16.14.2",
  "npm": "8.5.0"
}

El formato es el mismo que la sección volta en package.json, pero en el nivel raíz del archivo JSON.

Configuración de Usuario

La configuración de usuario de Volta se almacena en el directorio home de Volta:

• Unix: ~/.volta/
• Windows: %LOCALAPPDATA%\Volta\

Almacenamiento de Herramientas

Las herramientas instaladas se almacenan en directorios estructurados:

• Node.js: ~/.volta/tools/image/node/
• Gestores de paquetes: ~/.volta/tools/image/yarn/, ~/.volta/tools/image/npm/
• Paquetes: ~/.volta/tools/user/packages/

Directorio de Hooks

Los hooks personalizados se almacenan en ~/.volta/hooks/. Ver la sección Características Avanzadas para más detalles.

Variables de Entorno

Las variables de entorno proporcionan otra manera de configurar el comportamiento de Volta. Ver la página Variables de Entorno para una referencia completa.

Precedencia de Configuración

Al resolver qué versión de herramienta usar, Volta verifica fuentes en el siguiente orden:

1. Argumentos de línea de comandos (ej., volta run --node 14)
2. Configuración del proyecto en el package.json más cercano con una sección volta
3. Versiones por defecto de herramientas del usuario (establecidas vía volta install)
4. Versiones empaquetadas (ej., el npm que viene empaquetado con Node.js)

Ejemplos

Configuración Típica de Proyecto

{
  "name": "my-project",
  "version": "1.0.0",
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  },
  "dependencies": {
    // ...
  }
}

Configuración Extendida

// shared-config.json
{
  "node": "16.14.2",
  "yarn": "1.22.19"
}

// package.json
{
  "name": "my-project",
  "version": "1.0.0",
  "volta": {
    "extends": "./shared-config.json",
    "npm": "8.5.0"  // Sobrescribe cualquier versión de npm en la configuración extendida
  }
}

Configuración de Espacio de Trabajo

Para proyectos basados en espacios de trabajo, la configuración del package.json raíz se aplica a todos los paquetes del espacio de trabajo:

// package.json raíz
{
  "name": "workspace-root",
  "volta": {
    "node": "16.14.2",
    "yarn": "1.22.19"
  },
  "workspaces": [
    "packages/*"
  ]
}

// packages/app/package.json - usará Node.js 16.14.2 y Yarn 1.22.19
{
  "name": "app",
  "version": "1.0.0",
  // No se necesita sección volta aquí
}