module.exports: ce oferă un modul
Ai folosit un modul scris de altcineva. Acum îl scrii tu. Tot ce declari într-un fișier rămâne ascuns, până când pui în module.exports ce vrei să oferi. În această lecție scrii modulul calcule.js și îl testezi chiar din el, cu idiomul require.main === module.
Totul e privat, până îl exporți
Fiecare modul are propriul spațiu. Funcțiile și variabilele din calcule.js nu se văd din index.js, chiar dacă fișierele stau unul lângă altul. Ce pui în module.exports este singurul lucru pe care îl primește cine face require("./calcule").
// calcule.js
const COTA = 0.21; // privată: nu e exportată
function tva(pret) {
return pret * COTA;
}
module.exports = { tva }; // doar tva e vizibilă din afară// index.js
const calcule = require("./calcule");
console.log(calcule.tva(100)); // 21
console.log(calcule.COTA); // undefinedExportă doar ce au nevoie ceilalți. Ce rămâne privat poți schimba oricând fără să strici restul aplicației. Asta se numește încapsulare.
Scrie modulul calcule.js (fișierul din editor). Cota TVA este 21%. - tva(pret) întoarce pret * 0.21; - pretFinal(pret) întoarce prețul cu TVA inclus (folosește tva); - exportă ambele funcții cu module.exports; - sub if (require.main === module) testează-le pentru prețul 100 și afișează: TVA: 21 Final: 121
- Scrie funcțiile tva și pretFinal.
- Exportă-le: module.exports = { tva, pretFinal };.
- Adaugă blocul if (require.main === module) { ... } cu cele două afișări.
Soluția exercițiului
// calcule.js
const COTA_TVA = 0.21;
function tva(pret) {
return Math.round(pret * COTA_TVA * 100) / 100;
}
function pretFinal(pret) {
return pret + tva(pret);
}
module.exports = { tva, pretFinal };
if (require.main === module) {
console.log(`TVA: ${tva(100)}`);
console.log(`Final: ${pretFinal(100)}`);
} Vrei să afli mai mult?Forme ale lui module.exports · Testul din același fișier: require.main === module · Greșeli frecvente · Module scrise de echipe reale
Forme ale lui module.exports
module.exports poate fi orice valoare. Cele mai folosite forme:
| Formă | Exemplu | Folosire |
|---|---|---|
| obiect cu funcții | module.exports = { tva, pretFinal }; | const { tva } = require("./calcule") |
| o singură funcție | module.exports = function salut(n) {...}; | const salut = require("./salut") |
| o clasă | module.exports = class Cos {...}; | const Cos = require("./cos") |
| o valoare | module.exports = { port: 3000 }; | configurări |
Scurtătura { tva, pretFinal } (proprietăți scurte, din cursul JavaScript) înseamnă { tva: tva, pretFinal: pretFinal }.
Testul din același fișier: require.main === module
Când rulezi un fișier direct (node calcule.js), Node îl numește modulul principal: require.main este chiar module. Când fișierul e adus cu require din alt fișier, cele două sunt diferite. Așa poți pune cod de test care rulează doar când pornești modulul direct:
function dublu(x) {
return x * 2;
}
module.exports = { dublu };
if (require.main === module) {
console.log("Rulez direct modulul");
console.log("dublu(21) =", dublu(21));
}Rulez direct modulul dublu(21) = 42
În lecția aceasta editorul conține fișierul calcule.js, iar butonul Rulează face node calcule.js, deci blocul de test rulează. Dacă un alt fișier ar face require("./calcule"), testul n-ar mai afișa nimic.
Idiomul acesta este Node real și foarte folosit: modulele unelte (de exemplu un script de migrare) pot fi și importate, și rulate direct.
Greșeli frecvente
- Uiți exportul: fără module.exports, require întoarce un obiect gol {}, iar calcule.tva(100) dă TypeError: calcule.tva is not a function.
- Exporți rezultatul, nu funcția: module.exports = { tva: tva(100) } exportă numărul 21, nu funcția.
- Două atribuiri: module.exports = { tva }; module.exports = { pretFinal }; — a doua o înlocuiește pe prima; pune totul într-un singur obiect.
Module scrise de echipe reale
facturi.js exportă calculeazaTotal, aplicaReducere, genereazaNumar; restul aplicației nu știe cum sunt calculate.
auth.js exportă doar autentifica(email, parola); funcțiile de criptare rămân private.
migrare.js se poate rula cu node migrare.js sau importa în teste, datorită lui require.main === module.
