Kunci Versi Node Lewat Cara Menambahkan Engines Node di Package Json

Cara menambahkan engines node di package json adalah menulis blok engines berisi versi Node yang dipakai proyek, contohnya "engines": { "node": "20.x" }. Kesalahan yang paling sering terjadi adalah menulis versi asal tanpa mengecek versi aktif lewat node -v, sehingga anggota tim dan server memakai versi berbeda dan muncul error saat install.

Kebutuhan Sebelum Menambah Engines

Jalankan node -v dan npm -v di folder proyek untuk memastikan versi yang benar-benar berjalan. Catat versi mayornya, misalnya Node 20 dan npm 10.

  • Gunakan format semver: 20.11.0 untuk exact, ^20.11.0 untuk kompatibel minor dan patch, >=18 <21 untuk rentang.
  • Bedakan engines.node untuk runtime Node dengan engines.npm untuk versi package manager.
  • Samakan format dengan versi yang dipakai di server deployment, bukan hanya laptop pengembang.

Langkah Menambah Engines Node di Package Json

1. Buka package.json dan cek versi Node aktif dengan perintah node -v.

2. Tambahkan blok engines minimal sejajar dengan name dan scripts. Pilih satu range yang jelas, jangan menulis banyak range tumpang tindih.

3. Simpan file, lalu validasi dengan perintah npm pkg get engines. Perintah ini menampilkan isi engines yang terbaca npm.

4. Uji dengan Node berbeda memakai nvm, misalnya nvm use 18 lalu npm install, untuk memastikan peringatan versi muncul.

{
  "name": "backend-api",
  "version": "1.0.0",
  "engines": {
    "node": "20.x",
    "npm": ">=10"
  }
}

Tabel Aturan Versi Engines yang Sering Dipakai

Penulisan Arti Contoh Pakai
>=18 Node 18 ke atas Proyek lama transisi LTS
20.x Semua Node 20 Tim dan CI yang seragam
^20.11.0 Kompatibel dari 20.11.0 Butuh fitur patch tertentu

Untuk proyek tim, 20.x paling aman karena fleksibel terhadap patch tapi tetap mengunci mayor. Untuk deployment produksi, kunci lebih sempit seperti 20.11.0 bila server memakai image tetap.

  • "node": ">=18"
  • "node": "20.x"
  • "node": "^20.11.0"
  • "node": ">=20 <23"

FAQ

Apakah engines otomatis memblokir npm install beda versi?

Tidak, npm hanya memberi peringatan kecuali engine-strict=true aktif di .npmrc.

Format engines apa yang aman untuk tim?

Gunakan 20.x agar patch bebas bergeser tetapi mayor tetap sama.

Perlu menulis engines npm juga?

Ya bila proyek sensitif terhadap lockfile, tulis "npm": ">=10" untuk mencegah npm lama.