Supaya Startup Ringan, Pakai Cara Lazy Load Module Node Js Ini

Cara lazy load module Node.js adalah menunda require() atau import() sampai kode benar-benar membutuhkannya, bukan memuat semua di baris atas file. Pola ini memangkas waktu startup untuk aplikasi yang punya route berat atau package besar yang jarang dipakai.

Startup load cocok untuk modul yang selalu dipakai seperti Express, router utama, atau koneksi database. Lazy load cocok untuk beban sesekali, karena memori hanya terpakai saat fitur itu dibuka.

  • Generate PDF, export Excel, atau render laporan
  • Pengolah gambar seperti sharp atau ffmpeg
  • Route admin yang jarang diakses
  • Perintah CLI seperti migrasi, seed, atau backup

Syarat Module: CommonJS vs ES Module

Cek dulu field type di package.json sebelum memilih sintaks. Proyek tanpa type: module berjalan sebagai CommonJS. Proyek dengan type: module berjalan sebagai ES Module.

CommonJS memanggil require() di dalam fungsi. ES Module memakai await import() di dalam fungsi async.

// CommonJS
function buatPDF(data) {
  const pdfLib = require("pdfkit");
  return pdfLib.buat(data);
}

// ES Module, type: module
async function buatPDF(data) {
  const { default: pdfLib } = await import("pdfkit");
  return pdfLib.buat(data);
}

Langkah Lazy Load Module Node Js

1. Identifikasi modul berat dengan melihat waktu startup dan ukuran package. Curigai modul yang hanya dipakai satu route.
2. Pindahkan load dari atas file ke dalam handler atau fungsi perintah.
3. Simpan hasil load ke variabel cache agar tidak dimuat ulang setiap request.
4. Uji startup dengan mengukur waktu booting sebelum dan sesudah perubahan.
5. Tangani error load dengan try/catch agar satu fitur gagal tidak mematikan server.

const express = require("express");
const app = express();
let sharp;

app.post("/resize", async (req, res, next) => {
  try {
    if (!sharp) sharp = require("sharp");
    await sharp(req.body.file).resize(800).toFile("out.jpg");
    res.json({ ok: true });
  } catch (err) {
    next(err);
  }
});
  • Jangan lazy load modul yang dipakai setiap request, hasilnya hanya menambah overhead
  • Jangan lupa await pada dynamic import(), modulnya masih Promise
  • Jangan pasang listener atau koneksi baru di dalam fungsi lazy, panggil sekali lalu pakai ulang

Perbandingan Pola Load dan Dampaknya

Tahap Tindakan Catatan
Normal load Require di atas file Startup lambat, request stabil
Lazy require Require di fungsi Startup cepat, khusus CommonJS
Dynamic import Await import di fungsi Wajib async, untuk ES Module

Node menyimpan modul yang sudah dimuat di cache, jadi pemanggilan kedua tidak membaca ulang file. Bungkus load pertama dengan try/catch dan kirim respons 500 yang jelas bila package belum terinstal. Diagnosis dulu dengan pencatatan waktu startup dan pemakaian memori, karena lazy load tidak memperbaiki memory leak atau query lambat.

FAQ

Apakah lazy load selalu mempercepat Node.js?

Tidak. Ia mempercepat startup, tetapi request pertama ke fitur itu menjadi sedikit lebih lambat.

Bagaimana lazy load di ES Module dengan type module?

Gunakan await import("nama-package") di dalam fungsi async.

Kenapa dynamic import error ERR_MODULE_NOT_FOUND?

Nama package salah, package belum diinstal, atau path relatif tidak diawali ./ atau ../.