...
← Curs Node.js: toate lecțiile
Lecția 15 · Module

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);       // undefined
Bine de știut

Exportă 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.

Exercițiul tău

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.
pretFinal(pret) poate fi pret + tva(pret). Pentru 100, rezultatul trebuie afișat ca număr întreg: Math.round te ajută dacă apar zecimale.

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)}`);
}
Excelent! Continuă cu lecția următoare →
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ăExempluFolosire
obiect cu funcțiimodule.exports = { tva, pretFinal };const { tva } = require("./calcule")
o singură funcțiemodule.exports = function salut(n) {...};const salut = require("./salut")
o clasămodule.exports = class Cos {...};const Cos = require("./cos")
o valoaremodule.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.

Important

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

Facturare

facturi.js exportă calculeazaTotal, aplicaReducere, genereazaNumar; restul aplicației nu știe cum sunt calculate.

Autentificare

auth.js exportă doar autentifica(email, parola); funcțiile de criptare rămân private.

Scripturi

migrare.js se poate rula cu node migrare.js sau importa în teste, datorită lui require.main === module.

calcule.jsNode.js
ConsolăSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Rulează codul cu butonul de sus sau cu Ctrl + Enter / Cmd + Enter.
Parcursul tău Node.js de la zero Lecția 15 · module.exports: ce oferă un modul
Progres 0% 0 din 17
Lecția curentă 15 / 15 Module