Skip to content

Memahami Volta

Cara Kerja Volta

Volta mengelola alat baris perintah JavaScript Anda dengan membuat shim yang mengarah ke versi yang benar berdasarkan direktori saat ini. Ini memungkinkan proyek yang berbeda menggunakan versi alat yang sama tanpa konfigurasi tambahan.

Sistem Shim

Saat Anda menginstal Volta, ini menambahkan serangkaian shim kecil ke PATH Anda:

  • Satu untuk node
  • Satu untuk setiap package manager (npm, yarn, pnpm, dll.)
  • Satu untuk setiap paket global yang Anda instal

Shim ini adalah executable kecil yang menentukan versi aktual alat mana yang akan dijalankan dengan:

  1. Memeriksa apakah Anda berada dalam proyek dengan versi alat yang dipin
  2. Menggunakan versi default Anda jika tidak ada versi spesifik proyek yang ditemukan

Versi Spesifik Proyek

Volta menyimpan persyaratan alat proyek di file package.json Anda di bawah bagian volta:

json
{
  "volta": {
    "node": "16.15.1",
    "npm": "8.11.0"
  }
}

Saat Anda menjalankan perintah di direktori dengan konfigurasi ini, Volta secara otomatis memastikan Anda menggunakan versi yang tepat ini.

Versi Default

Untuk lokasi di luar proyek dengan versi yang dipin, Volta menggunakan alat default Anda. Anda dapat mengatur ini dengan:

bash
volta install node@16.15.1
volta install npm@8.11.0

Mengapa Volta?

Lingkungan yang Konsisten

Volta memastikan semua orang yang bekerja pada proyek menggunakan toolchain yang persis sama, menghilangkan masalah "berfungsi di mesin saya".

Nol Overhead

Tidak seperti manajer versi lainnya, Volta tidak memerlukan perintah tambahan untuk beralih versi saat Anda mengubah proyek. Ini terjadi secara otomatis saat Anda menavigasi sistem file Anda.

Kinérja Cepat

Dibangun dalam Rust, Volta dirancang untuk kecepatan. Arsitektur shim-nya berarti overhead minimal saat menjalankan alat JavaScript.

Integrasi yang Mulus

Volta bekerja bersama alur kerja pengembangan JavaScript Anda yang ada tanpa memerlukan perubahan pada kebiasaan atau proses Anda.

Alur Kerja Umum

Memulai Proyek Baru

bash
# Buat direktori dan siapkan paket
mkdir my-project && cd my-project
npm init -y

# Pin versi Node.js dan npm
volta pin node@16
volta pin npm@8

# Instal dependensi
npm install express

Berkontribusi pada Proyek yang Ada

bash
# Clone repositori
git clone https://github.com/example/project.git
cd project

# Jika proyek memiliki konfigurasi volta di package.json,
# alat yang benar akan digunakan secara otomatis

# Jika tidak, Anda dapat menambahkannya
volta pin node@14

Menginstal Alat Global

bash
# Instal paket global
volta install typescript

# Sekarang Anda dapat menggunakannya dari mana saja
tsc --version

Released under the BSD 2-Clause License.