Dokumentasi Resmi Node.js

Dokumentasi resmi adalah sumber belajar yang terus hidup setelah Course ini selesai: setiap rilis baru, halaman-halaman resmi ikut diperbarui, sedangkan materi kursus selalu tertulis pada satu titik waktu. Keterampilan paling tahan lama yang perlu kita bawa pulang bukan menghafal API, melainkan menemukan jawaban sendiri di dokumentasi dalam hitungan menit. Kendalanya, dokumentasi Node.js tersebar di beberapa tempat — referensi API, panduan Learn, blog, arsip versi, hingga repositori GitHub — dan membaca di tempat yang salah membuang waktu meskipun semua materinya benar. Chapter ini memetakan sumber-sumber resmi tersebut, menjelaskan cara dokumentasi disimpan per versi, lalu menutup dengan strategi mencari yang cepat.

Peta Sumber Resmi #

Empat sumber berikut menutup hampir seluruh kebutuhan harian. Kuncinya adalah mengenali pertanyaan yang kita bawa lebih dulu, lalu membuka sumber yang memang dirancang menjawab pertanyaan itu.

Dua pelengkap lain layak dicatat meski jarang dibuka setiap hari. Blog resmi di nodejs.org/en/blog memuat pengumuman rilis besar, pengumuman akhir dukungan sebuah garis, dan advisori keamanan. Halaman nodejs.org/en/about/previous-releases merangkum status seluruh garis rilis beserta codename-nya — halaman ini pula yang mengumumkan perubahan besar seperti model rilis tahunan mulai Node.js 27.

Referensi API dan Pemversiannya #

Alamat nodejs.org/api/ selalu menampilkan dokumentasi untuk garis rilis terkini. Perilaku ini praktis untuk sekadar melihat-lihat, tetapi berisiko menyesatkan ketika runtime kita lebih tua: fitur yang tercatat di sana belum tentu tersedia pada Node.js yang sedang kita jalankan. Untuk itu, setiap rilis Node.js menyimpan snapshot dokumentasinya di arsip nodejs.org/docs/ dengan tiga pola alamat:

Versi runtime yang berjalan bisa kita baca dari dalam kode, lalu dirangkai menjadi alamat dokumentasi yang cocok. Berkas cek-versi.mjs berikut melakukan keduanya:

// Sebelum membaca dokumentasi, cocokkan dulu versi runtime kita.
const versi = process.version;        // misalnya "v24.21.0"
const garis = versi.split(".")[0];    // "v24"

console.log(`Runtime lokal        : ${versi}`);
console.log(`Dokumen versi persis : nodejs.org/docs/${versi}/api/`);
console.log(`Dokumen garis rilis  : nodejs.org/docs/latest-${garis}.x/api/`);

Output yang Dihasilkan:

Runtime lokal        : v24.21.0
Dokumen versi persis : nodejs.org/docs/v24.21.0/api/
Dokumen garis rilis  : nodejs.org/docs/latest-v24.x/api/

Mari kita telaah baris-baris kode di atas:

1. Baris 2 (process.version): property process.version menyimpan string versi lengkap dengan awalan v, misalnya v24.21.0.
2. Baris 3 (versi.split(".")[0]): potongan pertama sebelum titik adalah garis rilisnya, yaitu v24; inilah bagian yang dipakai pada pola latest-v24.x.
3. Baris 5-7 (console.log): kedua alamat dokumentasi dirangkai lewat template literal, mengikuti pola pada tabel di atas. Alamat pertama menunjuk snapshot versi persis, sedangkan alamat kedua selalu mengikuti pembaruan terbaru pada garis yang sama.

Panduan Learn dan Blog Resmi #

Referensi API menjawab “apa”, sedangkan panduan Learn menjawab “bagaimana” dan “mengapa”. Panduan ini disusun per kelompok topik — di antaranya Getting Started, Command Line, HTTP, Asynchronous Work, Concurrency, dan TypeScript — dan tiap artikel berjalan bertahap dari konsep sampai contoh kode yang bisa langsung dicoba. Beberapa artikelnya juga menjadi rujukan resmi untuk praktik keamanan dasar dan teknik debugging.

Blog resmi melengkapi keduanya dengan kabar yang bersifat waktu: pengumuman rilis mayor, jadwal perpindahan status LTS, dan advisori keamanan. Ketika sebuah tutorial lama tiba-tiba berperilaku berbeda, blog adalah tempat pertama untuk memeriksa apakah ada perubahan kebijakan atau API yang baru diumumkan.

Repositori GitHub dan Changelog #

Seluruh kode sumber Node.js hidup di GitHub pada organisasi nodejs, dan halaman releases adalah jendela resminya terhadap apa yang berubah. Setiap rilis mencantumkan nomor versi, tanggal, dan daftar perubahan dari sekian commit — termasuk penanda semver-major untuk perubahan yang merusak kompatibilitas. Changelog inilah rujukan pertama ketika kita menaikkan versi Node.js di server dan ingin tahu risikonya, atau ketika perilaku berubah diam-diam setelah pembaruan rutin.

Repositori yang sama juga memuat jadwal rilis resmi beserta tanggal-tanggal penting setiap garis LTS — dokumen yang kita pakai untuk menyusun tabel garis rilis pada Chapter Versi Node.js dan Kompatibilitas.

Strategi Mencari yang Cepat #

Dengan peta di atas, pola mencari bisa dipadatkan menjadi tabel keputusan. Latih urutan ini beberapa kali sampai menjadi refleks:

Peta sumber resmi kini lengkap di tangan kita: referensi API untuk fakta presisi, Learn untuk konsep bertahap, blog untuk kabar terbaru, arsip per versi untuk kecocokan runtime, dan changelog untuk riwayat perubahan. Peta saja belum cukup — langkah berikutnya adalah belajar membaca satu entri referensi API secara menyeluruh, dari stability index sampai tabel History, di Chapter Membaca Referensi API.