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 --version dan npm --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 document tidak 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" di package.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) dengan async/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 — http mentah 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: URL dan URLSearchParams juga 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: (misalnya node: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/.bin tanpa 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-file tanpa dotenv:

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

  1. Gunakan ES Module ("type": "module") untuk proyek baru.

  2. Gunakan node: prefix untuk modul bawaan — membedakan dari package npm.

  3. Gunakan fs/promises (async) daripada fs synchronous di server.

  4. Gunakan path.join() untuk path — menangani separator Windows/Linux.

  5. Commit package.json dan package-lock.json — jangan commit node_modules/.

  6. Gunakan .gitignore — node_modules/, .env, *.log, dist/.

  7. Pisahkan dependencies dan devDependencies — package testing/linting cukup di dev.

  8. Gunakan npm ci di CI/CD — instalasi strict dan cepat.

  9. Jangan hardcode konfigurasi sensitif — gunakan environment variables.

  10. Selalu tangani error di fungsi async — try/catch.

  11. Gunakan nodemon saat development — auto-restart saat file berubah.

  12. 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.json adalah pusat konfigurasi proyek.
  • package-lock.json mengunci versi — commit ke Git.
  • node_modules/ jangan di-commit — gunakan .gitignore.
  • npm ci untuk CI/CD — lebih cepat dan strict.
  • npx untuk 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.

Top