Konfigurasi

Volta menggunakan beberapa file konfigurasi untuk mengelola toolchain JavaScript Anda. Referensi ini menjelaskan opsi konfigurasi yang tersedia dan formatnya.

Konfigurasi Proyek

Konfigurasi spesifik proyek disimpan dalam file package.json proyek Anda di bawah kunci volta.

Format

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

Properti

Properti	Tipe	Deskripsi
node	String	Versi Node.js yang akan digunakan dalam proyek ini
npm	String	Versi npm yang akan digunakan dalam proyek ini
yarn	String	Versi Yarn yang akan digunakan dalam proyek ini
pnpm	String	Versi pnpm yang akan digunakan dalam proyek ini
extends	String	Jalur ke file konfigurasi Volta bersama

Format Versi

String versi dalam konfigurasi volta dapat menggunakan format berikut:

• Versi tepat: 16.14.2
• Hanya versi utama: 16
• Utama dan minor: 16.14
• Rentang versi (npm semver): ^16.14.0
• Tag: latest, lts

Konfigurasi Proyek Bersama

Anda dapat membuat konfigurasi Volta bersama yang dapat diperluas oleh beberapa proyek. Ini berguna untuk organisasi yang ingin menstandarkan versi alat di seluruh proyek.

Format

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

Formatnya sama dengan bagian volta di package.json, tetapi di level root file JSON.

Konfigurasi Pengguna

Konfigurasi pengguna Volta disimpan di direktori rumah Volta:

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

Penyimpanan Alat

Alat yang terinstal disimpan dalam direktori terstruktur:

• Node.js: ~/.volta/tools/image/node/
• Package manager: ~/.volta/tools/image/yarn/, ~/.volta/tools/image/npm/
• Paket: ~/.volta/tools/user/packages/

Direktori Hook

Hook kustom disimpan di ~/.volta/hooks/. Lihat bagian Fitur Lanjutan untuk detail lebih lanjut.

Variabel Lingkungan

Variabel lingkungan menyediakan cara lain untuk mengonfigurasi perilaku Volta. Lihat halaman Variabel Lingkungan untuk referensi lengkap.

Prioritas Konfigurasi

Saat menentukan versi alat mana yang akan digunakan, Volta memeriksa sumber dalam urutan berikut:

1. Argumen baris perintah (misalnya, volta run --node 14)
2. Konfigurasi proyek di package.json terdekat dengan bagian volta
3. Versi alat default pengguna (diatur melalui volta install)
4. Versi yang dibundel (misalnya, npm yang dibundel dengan Node.js)

Contoh

Konfigurasi Proyek Tipikal

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

Konfigurasi Diperluas

// 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"  // Mengganti versi npm apa pun dalam konfigurasi yang diperluas
  }
}

Konfigurasi Workspace

Untuk proyek berbasis workspace, konfigurasi package.json root berlaku untuk semua paket workspace:

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

// packages/app/package.json - akan menggunakan Node.js 16.14.2 dan Yarn 1.22.19
{
  "name": "app",
  "version": "1.0.0",
  // Tidak perlu bagian volta di sini
}