Node.js & npm Dasar
Node.js memungkinkan JavaScript berjalan di sisi server. Artikel ini membahas dasar Node.js, npm untuk mengelola package, package.json, script, serta modul bawaan seperti fs, path, dan http.
Pendahuluan
Selama ini kita menjalankan JavaScript di browser. Node.js membawa JavaScript ke sisi server — memungkinkan kita membuat API, CLI tool, web server, dan aplikasi backend lainnya dengan bahasa yang sama.
Node.js juga menyertakan npm (Node Package Manager) — salah satu registry package terbesar di dunia dengan jutaan library siap pakai.
Artikel ini membahas:
- Apa itu Node.js dan cara kerjanya.
- Modul bawaan Node.js (
fs,path,http, dll.). - npm:
package.json, dependencies, script. - Membuat project Node.js pertama.
- Perbedaan Node.js vs browser.
Asumsi: Anda sudah menginstal Node.js (dibahas di artikel Instalasi & Persiapan Lingkungan). Verifikasi dengan
node --versiondannpm --version.
Apa itu Node.js?
Node.js adalah runtime environment yang menjalankan JavaScript di luar browser, dibangun di atas V8 engine (mesin JavaScript Chrome).
Karakteristik Node.js
- Single-threaded — sama seperti JavaScript di browser.
- Non-blocking I/O — operasi I/O (file, network) asynchronous, tidak memblokir thread.
- Event-driven — menggunakan event loop (konsep yang sama dengan browser).
- Cross-platform — Windows, Linux, macOS.
- npm — package manager bawaan.
Node.js vs Browser
| Aspek | Browser | Node.js |
|---|---|---|
| Global object | window |
global |
| DOM API | ✅ (document, window) |
❌ |
localStorage |
✅ | ❌ |
File system (fs) |
❌ | ✅ |
| HTTP server | ❌ | ✅ (http, Express) |
process |
❌ | ✅ |
fetch |
✅ | ✅ (Node 18+) |
console.log |
✅ | ✅ |
Penting: Kode yang menggunakan
documenttidak akan berjalan di Node.js, dan sebaliknya. Namun, kode logika murni (array, object, fungsi) berjalan di keduanya.
Menjalankan JavaScript dengan Node.js
File .js
Buat hello.js:
console.log("Hello dari Node.js!");
console.log("Versi Node:", process.version);
console.log("Platform:", process.platform);
Jalankan:
node hello.js
REPL (Read-Eval-Print Loop)
Mirip console browser — untuk eksperimen cepat:
node
> 2 + 3
5
> [1, 2, 3].map(x => x * 2)
[ 2, 4, 6 ]
> .exit
Argumen Command Line
// args.js
const args = process.argv.slice(2);
console.log("Argumen:", args);
node args.js halo dunia
# Argumen: [ 'halo', 'dunia' ]
process.argv[0] = path Node.js, process.argv[1] = path script.
Modul di Node.js
Node.js menggunakan modul untuk memecah kode. Ada dua sistem modul:
1. CommonJS (CJS) — Default Lama
Menggunakan require() dan module.exports.
// math.js
function tambah(a, b) {
return a + b;
}
function kali(a, b) {
return a * b;
}
module.exports = { tambah, kali };
// app.js
const { tambah, kali } = require("./math.js");
console.log(tambah(2, 3)); // 5
console.log(kali(4, 5)); // 20
Export satu nilai:
// logger.js
module.exports = function log(pesan) {
console.log(`[LOG] ${pesan}`);
};
// app.js
const log = require("./logger.js");
log("Hello");
2. ES Module (ESM) — Modern
Menggunakan import/export — sama seperti di browser.
Aktifkan dengan salah satu cara:
- Beri ekstensi
.mjs. - Atau tambahkan
"type": "module"dipackage.json.
// math.mjs
export function tambah(a, b) {
return a + b;
}
export default function kali(a, b) {
return a * b;
}
// app.mjs
import kali, { tambah } from "./math.mjs";
console.log(tambah(2, 3)); // 5
console.log(kali(4, 5)); // 20
Rekomendasi: Untuk proyek baru, gunakan ES Module (
"type": "module"). Untuk proyek lama atau library yang belum mendukung ESM, gunakan CommonJS.
Perbandingan CJS vs ESM
| Aspek | CommonJS | ES Module |
|---|---|---|
| Sintaks | require / module.exports |
import / export |
| Loading | Synchronous | Asynchronous |
| Top-level await | ❌ | ✅ |
__dirname |
✅ | ❌ (gunakan import.meta.url) |
| Ekstensi | .js (default) |
.mjs atau "type": "module" |
Modul Bawaan Node.js
Node.js menyertakan banyak modul tanpa perlu instal. Berikut yang paling sering digunakan.
fs — File System
Membaca, menulis, dan memanipulasi file.
import fs from "node:fs/promises";
// Baca file
const isi = await fs.readFile("data.txt", "utf-8");
console.log(isi);
// Tulis file
await fs.writeFile("output.txt", "Hello, World!", "utf-8");
// Cek keberadaan
try {
await fs.access("data.txt");
console.log("File ada");
} catch {
console.log("File tidak ada");
}
// Hapus file
await fs.unlink("output.txt");
// Buat folder
await fs.mkdir("folder-baru", { recursive: true });
// Baca isi folder
const files = await fs.readdir(".");
console.log(files);
Versi synchronous (hindari di server — memblokir):
import fs from "node:fs";
const isi = fs.readFileSync("data.txt", "utf-8");
fs.writeFileSync("output.txt", "Hello");
Rekomendasi: Gunakan versi promise (
node:fs/promises) denganasync/await— non-blocking.
path — Manipulasi Path
import path from "node:path";
console.log(path.join("folder", "subfolder", "file.txt"));
// "folder/subfolder/file.txt" (Linux) atau "folder\\subfolder\\file.txt" (Windows)
console.log(path.resolve("data.txt"));
// "/home/user/proyek/data.txt" (absolute)
console.log(path.basename("/home/user/file.txt")); // "file.txt"
console.log(path.dirname("/home/user/file.txt")); // "/home/user"
console.log(path.extname("file.txt")); // ".txt"
console.log(path.parse("/home/user/file.txt"));
// { root: "/", dir: "/home/user", base: "file.txt", ext: ".txt", name: "file" }
Tips: Selalu gunakan
path.join()daripada menggabungkan string manual — menangani separator Windows/Linux dengan benar.
http — HTTP Server
Membuat web server tanpa framework.
import http from "node:http";
const server = http.createServer((req, res) => {
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify({ pesan: "Hello, World!" }));
});
server.listen(3000, () => {
console.log("Server berjalan di http://localhost:3000");
});
Routing sederhana:
const server = http.createServer((req, res) => {
if (req.url === "/" && req.method === "GET") {
res.writeHead(200, { "Content-Type": "text/html" });
res.end("<h1>Halaman Utama</h1>");
} else if (req.url === "/api/produk" && req.method === "GET") {
res.writeHead(200, { "Content-Type": "application/json" });
res.end(JSON.stringify([{ id: 1, nama: "Keyboard" }]));
} else {
res.writeHead(404);
res.end("Not Found");
}
});
Catatan: Untuk aplikasi nyata, gunakan framework seperti Express —
httpmentah terlalu verbose.
os — Informasi Sistem
import os from "node:os";
console.log(os.platform()); // "linux", "darwin", "win32"
console.log(os.arch()); // "x64", "arm64"
console.log(os.cpus().length); // jumlah core CPU
console.log(os.totalmem()); // total RAM (byte)
console.log(os.freemem()); // RAM tersedia (byte)
console.log(os.homedir()); // "/home/user"
console.log(os.hostname());
crypto — Kriptografi
import crypto from "node:crypto";
// Hash
const hash = crypto.createHash("sha256").update("password").digest("hex");
console.log(hash);
// Random bytes
const token = crypto.randomBytes(32).toString("hex");
console.log(token);
// UUID
console.log(crypto.randomUUID());
// "550e8400-e29b-41d4-a716-446655440000"
url — Manipulasi URL
import { URL, URLSearchParams } from "node:url";
const url = new URL("https://api.example.com/produk?kategori=elektronik&page=2");
console.log(url.hostname); // "api.example.com"
console.log(url.pathname); // "/produk"
console.log(url.searchParams.get("kategori")); // "elektronik"
url.searchParams.set("page", "3");
console.log(url.toString());
Catatan:
URLdanURLSearchParamsjuga tersedia di browser — API-nya sama.
events — EventEmitter
Node.js menggunakan event-driven architecture — banyak object adalah EventEmitter.
import { EventEmitter } from "node:events";
const emitter = new EventEmitter();
emitter.on("pesanan:baru", (pesanan) => {
console.log("Pesanan baru:", pesanan);
});
emitter.emit("pesanan:baru", { id: 1, total: 500000 });
// "Pesanan baru: { id: 1, total: 500000 }"
Ringkasan Modul Bawaan
| Modul | Kegunaan |
|---|---|
fs |
File system (baca/tulis file) |
path |
Manipulasi path file |
http / https |
HTTP server & client |
os |
Informasi sistem operasi |
crypto |
Hash, random, enkripsi |
url |
Manipulasi URL |
events |
EventEmitter |
process |
Info & kontrol proses |
Tips: Gunakan prefix
node:(misalnyanode:fs) untuk membedakan modul bawaan dari package npm.
npm — Node Package Manager
npm mengelola package (library) dan dependensi proyek.
Inisialisasi Proyek
mkdir proyek-saya
cd proyek-saya
npm init -y
Menghasilkan package.json:
{
"name": "proyek-saya",
"version": "1.0.0",
"description": "",
"main": "index.js",
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC"
}
package.json — Konfigurasi Proyek
Field penting:
| Field | Arti |
|---|---|
name |
Nama package/proyek |
version |
Versi (semver: major.minor.patch) |
main |
Entry point (file utama) |
type |
"module" untuk ESM, atau default CommonJS |
scripts |
Perintah npm yang bisa dijalankan |
dependencies |
Package yang dibutuhkan saat runtime |
devDependencies |
Package yang dibutuhkan saat development |
Contoh package.json yang lebih lengkap:
{
"name": "toko-online-api",
"version": "1.0.0",
"description": "API toko online",
"type": "module",
"main": "src/index.js",
"scripts": {
"start": "node src/index.js",
"dev": "nodemon src/index.js",
"test": "vitest"
},
"dependencies": {
"express": "^4.18.2"
},
"devDependencies": {
"nodemon": "^3.0.1",
"vitest": "^1.0.0"
}
}
Menginstal Package
Dependencies (runtime):
npm install express
# atau singkat
npm i express
DevDependencies (development):
npm install --save-dev nodemon
# atau
npm i -D nodemon
Global (CLI tool):
npm install -g typescript
Menggunakan Package
// ESM
import express from "express";
// CommonJS
const express = require("express");
Versi Package (Semver)
| Simbol | Arti | Contoh |
|---|---|---|
^1.2.3 |
Update minor & patch (bukan major) | 1.2.3 → 1.9.0 ✅, 2.0.0 ❌ |
~1.2.3 |
Update patch saja | 1.2.3 → 1.2.9 ✅, 1.3.0 ❌ |
1.2.3 |
Versi exact | Hanya 1.2.3 |
* |
Versi apa pun | — |
>=1.2.3 |
Minimal versi | — |
Tips: Gunakan
^(default npm) untuk library — mendapat bug fix & fitur minor. Gunakan versi exact untuk aplikasi produksi jika butuh stabilitas penuh.
package-lock.json
File ini mengunci versi exact semua package (termasuk transitive dependencies). Commit ke Git agar semua developer & server menggunakan versi yang sama.
Jangan edit manual. Dibuat otomatis oleh npm.
node_modules/
Folder berisi semua package yang diinstal. Ukurannya bisa sangat besar.
Jangan commit ke Git — tambahkan ke .gitignore:
node_modules/
.env
*.log
Untuk menginstal ulang dari package.json (misalnya setelah clone):
npm install
# atau untuk CI (lebih cepat, strict)
npm ci
Menghapus Package
npm uninstall express
npm uninstall --save-dev nodemon
Melihat Package yang Terinstal
npm list --depth=0
Update Package
npm update # update sesuai semver
npm outdated # lihat package yang ketinggalan
npm install express@latest # update ke versi terbaru
Script npm
Field scripts di package.json memungkinkan mendefinisikan perintah yang bisa dijalankan dengan npm run.
{
"scripts": {
"start": "node src/index.js",
"dev": "nodemon src/index.js",
"test": "vitest",
"lint": "eslint .",
"build": "tsc"
}
}
Menjalankan:
npm start # khusus "start" — tanpa "run"
npm run dev
npm test # khusus "test" — tanpa "run"
npm run lint
npm run build
Script dengan Argumen
npm run dev -- --port 4000
-- memisahkan argumen npm dari argumen script.
Script Pre/Post
npm otomatis menjalankan script pre<nama> dan post<nama>:
{
"scripts": {
"prebuild": "rm -rf dist",
"build": "tsc",
"postbuild": "echo 'Build selesai!'"
}
}
npm run build akan menjalankan prebuild → build → postbuild.
Script Chaining
{
"scripts": {
"lint": "eslint .",
"test": "vitest",
"check": "npm run lint && npm test"
}
}
&& menjalankan script berikutnya hanya jika yang sebelumnya berhasil.
npx — Menjalankan Package Tanpa Install Global
npx mengunduh package sementara (jika belum ada) dan menjalankannya.
npx create-vite my-app
npx eslint .
npx prettier --write .
npx tsx script.ts
Keuntungan:
- Tidak mengotori global package.
- Selalu menggunakan versi terbaru (atau versi yang ditentukan).
- Bisa menjalankan binary dari
node_modules/.bintanpa path lengkap.
Membuat Project Node.js Pertama
Mari buat aplikasi CLI sederhana yang membaca file dan menghitung baris.
1. Inisialisasi
mkdir line-counter
cd line-counter
npm init -y
Edit package.json — tambahkan "type": "module":
{
"name": "line-counter",
"version": "1.0.0",
"type": "module",
"main": "index.js",
"scripts": {
"start": "node index.js"
}
}
2. Buat index.js
import fs from "node:fs/promises";
import path from "node:path";
async function hitungBaris(filePath) {
try {
const isi = await fs.readFile(filePath, "utf-8");
const baris = isi.split("\n").length;
const karakter = isi.length;
const kata = isi.split(/\s+/).filter(Boolean).length;
console.log(`File: ${path.basename(filePath)}`);
console.log(`Baris: ${baris}`);
console.log(`Kata: ${kata}`);
console.log(`Karakter: ${karakter}`);
} catch (error) {
if (error.code === "ENOENT") {
console.error(`File tidak ditemukan: ${filePath}`);
} else {
console.error(`Error: ${error.message}`);
}
process.exit(1);
}
}
const filePath = process.argv[2];
if (!filePath) {
console.error("Penggunaan: node index.js <file>");
process.exit(1);
}
hitungBaris(filePath);
3. Jalankan
echo "Hello World
Baris kedua
Baris ketiga" > contoh.txt
node index.js contoh.txt
Output:
File: contoh.txt
Baris: 3
Kata: 6
Karakter: 35
4. Tambahkan Dependency
Mari tambahkan package chalk untuk warna output:
npm install chalk
Ubah index.js:
import chalk from "chalk";
// ...
console.log(chalk.blue(`File: ${path.basename(filePath)}`));
console.log(chalk.green(`Baris: ${baris}`));
console.log(chalk.yellow(`Kata: ${kata}`));
console.log(chalk.cyan(`Karakter: ${karakter}`));
Jalankan lagi — output berwarna.
Environment Variables
Environment variables menyimpan konfigurasi sensitif (API key, database URL) di luar kode.
Mengakses di Node.js
console.log(process.env.NODE_ENV); // "development" / "production"
console.log(process.env.DATABASE_URL);
console.log(process.env.PORT || 3000);
File .env
Buat file .env:
NODE_ENV=development
PORT=3000
DATABASE_URL=mysql://root:password@localhost:3306/toko_online
API_KEY=rahasia123
Jangan commit .env ke Git! Tambahkan ke .gitignore.
Membaca .env dengan dotenv
npm install dotenv
import "dotenv/config";
console.log(process.env.PORT); // "3000"
Atau manual:
import dotenv from "dotenv";
dotenv.config();
Catatan: Node.js 20.6+ mendukung
--env-filetanpadotenv:node --env-file=.env index.js
File .env.example
Commit file contoh tanpa nilai sensitif agar developer lain tahu variabel yang dibutuhkan:
NODE_ENV=development
PORT=3000
DATABASE_URL=
API_KEY=
Tips & Best Practice
-
Gunakan ES Module (
"type": "module") untuk proyek baru. -
Gunakan
node:prefix untuk modul bawaan — membedakan dari package npm. -
Gunakan
fs/promises(async) daripadafssynchronous di server. -
Gunakan
path.join()untuk path — menangani separator Windows/Linux. -
Commit
package.jsondanpackage-lock.json— jangan commitnode_modules/. -
Gunakan
.gitignore—node_modules/,.env,*.log,dist/. -
Pisahkan
dependenciesdandevDependencies— package testing/linting cukup di dev. -
Gunakan
npm cidi CI/CD — instalasi strict dan cepat. -
Jangan hardcode konfigurasi sensitif — gunakan environment variables.
-
Selalu tangani error di fungsi async —
try/catch. -
Gunakan
nodemonsaat development — auto-restart saat file berubah. -
Gunakan
process.exit(1)untuk menandakan error di CLI.
Ringkasan
| Konsep | Poin Penting |
|---|---|
| Node.js | Runtime JavaScript di luar browser (V8 engine) |
| Modul CJS | require() / module.exports |
| Modul ESM | import / export ("type": "module") |
fs |
File system (baca/tulis file) |
path |
Manipulasi path |
http |
HTTP server |
process |
Info proses & environment |
package.json |
Konfigurasi proyek & dependencies |
npm install |
Menginstal package |
npm ci |
Instalasi strict dari lock file |
npx |
Menjalankan package tanpa install global |
scripts |
Perintah npm yang bisa dijalankan |
.env |
Environment variables (jangan commit!) |
Poin penting:
- Node.js menjalankan JavaScript di sisi server — tidak ada DOM.
- Gunakan ES Module untuk proyek baru.
- Modul bawaan (
fs,path,http, dll.) tidak perlu diinstal. package.jsonadalah pusat konfigurasi proyek.package-lock.jsonmengunci versi — commit ke Git.node_modules/jangan di-commit — gunakan.gitignore.npm ciuntuk CI/CD — lebih cepat dan strict.npxuntuk menjalankan package tanpa install global.- Environment variables untuk konfigurasi sensitif — jangan hardcode.
Pada artikel berikutnya, kita akan membahas Module Bundler & Build Tool — Vite, Webpack, Babel, ESLint, dan Prettier.