module.exports vs exports di Node.js, dengan Contoh

module.exports adalah nilai yang diberikan sebuah file Node.js kepada file lain yang memuatnya dengan require(). Nilainya berawal dari object kosong: tambahkan property padanya untuk meng-export beberapa hal, atau isi dengan nilai baru (fungsi, class) untuk meng-export satu hal. exports adalah variabel singkat yang menunjuk ke object yang sama, jadi exports.add = ... bekerja, tetapi exports = ... memutus hubungannya dan tidak meng-export apa pun.

const fs = require('fs');

// setup: write a second module next to index.js
fs.writeFileSync('math.js', `
module.exports.add = (a, b) => a + b;
exports.multiply = (a, b) => a * b;
module.exports.PI = 3.14159;
`);

const math = require('./math');

console.log(math.add(2, 3), math.multiply(4, 5), math.PI);
console.log(Object.keys(math));

Hasilnya 5 20 3.14159, lalu [ 'add', 'multiply', 'PI' ]. Ketiga baris di math.js menambahkan property ke object yang sama, entah lewat module.exports atau exports, dan require('./math') mengembalikan object itu.

Export fungsi, class, atau object

Saat sebuah module punya satu hal utama, isikan langsung ke module.exports. Pemanggil lalu mendapat fungsinya sendiri, bukan object yang membungkusnya:

const fs = require('fs');

// setup: two modules, one exports a function, one a class
fs.writeFileSync('greet.js', `
module.exports = function greet(name) {
    return 'Hello, ' + name;
};
`);
fs.writeFileSync('user.js', `
class User {
    constructor(name) { this.name = name; }
    describe() { return this.name + ' (user)'; }
}
module.exports = User;
`);

const greet = require('./greet');
const User = require('./user');

console.log(greet('Ada'));
console.log(new User('Grace').describe());

Hasilnya Hello, Ada dan Grace (user). Kalau kamu melihat TypeError: greet is not a function, pemanggil memakai bentuk yang salah: tulis const { greet } = require(...) untuk property object dan const greet = require(...) untuk nilai yang diisikan langsung.

module.exports vs exports: jebakan mengisi ulang

Sebelum file-mu berjalan, Node.js menetapkan exports = module.exports. Kedua nama menunjuk ke satu object, dan require mengembalikan module.exports. Mengisi nilai baru ke exports hanya mengubah variabel lokalnya:

const fs = require('fs');

// setup: the same export written two ways
fs.writeFileSync('broken.js', 'exports = { version: 2 };');
fs.writeFileSync('working.js', 'module.exports = { version: 2 };');

console.log('broken:', require('./broken'));
console.log('working:', require('./working'));

broken.js meng-export {}, karena exports sekarang menunjuk ke object baru yang tidak dikembalikan oleh siapa pun. working.js meng-export { version: 2 }.

Aturan paling sederhana: selalu tulis module.exports. Cara ini bekerja di setiap kasus, dan kodenya menyatakan apa yang dilakukannya.

require mengembalikan object yang sama dari cache

Node.js menjalankan kode sebuah module sekali, saat pertama kali di-require, lalu menyimpan module.exports di cache. Setiap require berikutnya untuk file yang sama mengembalikan object yang sama, jadi state di dalam sebuah module dibagi oleh setiap file yang memuatnya:

const fs = require('fs');

// setup: a module that counts and logs when it loads
fs.writeFileSync('counter.js', `
console.log('counter.js is running');
let count = 0;
module.exports = { next: () => ++count };
`);

const a = require('./counter');
const b = require('./counter.js');

a.next();
a.next();
console.log('b sees', b.next());
console.log('same object:', a === b);

counter.js is running muncul sekali, b.next() mengembalikan 3, dan a === b bernilai true, karena kunci cache-nya adalah path file yang sudah di-resolve, dan ./counter serta ./counter.js mengarah ke file yang sama. Itulah sebabnya koneksi database atau object konfigurasi yang dibuat di satu module dipakai bersama oleh seluruh aplikasi.

module.exports dan ES module

ES module memakai export dan import. Bentuk-bentuknya saling berpadanan seperti ini:

// CommonJS                              // ES modules
module.exports = greet;                  export default greet;
module.exports.add = add;                export { add };
const greet = require('./greet');        import greet from './greet.js';
const { add } = require('./math');       import { add } from './math.js';

ES module bisa meng-import file CommonJS: module.exports miliknya datang sebagai default import. Sejak Node.js 22.12, require() juga bisa memuat ES module yang tidak punya top-level await. Untuk kapan memilih yang mana, lihat CommonJS vs ES modules.

Kesalahan umum

Mencampur exports.x dengan module.exports = ... dalam satu file. Pengisian itu menggantikan object-nya, jadi setiap exports.x yang ditulis sebelumnya hilang. Pilih satu gaya per file.

Meng-export nilai yang nanti berubah. module.exports = { count } menyalin angkanya saat dimuat; saat module memperbarui count, pemanggil tetap melihat nilai lama. Export fungsi yang mengembalikannya, seperti yang dilakukan counter.js di atas.

Lupa menulis ./. require('math') mencari package di node_modules, bukan math.js di samping file-mu. File lokal selalu diawali ./ atau ../.