Come Node.js Carica i Moduli

Per lavorare efficacemente con i moduli in Node.js, è necessario comprendere come Node.js li individua e li carica. Questo processo è chiamato risoluzione dei moduli. Quando si utilizza la funzione require per importare un modulo, Node.js segue un algoritmo specifico per individuare il file o il pacchetto richiesto. Il processo di risoluzione tiene conto delle estensioni dei file, della struttura delle cartelle e persino della presenza di file speciali come package.json.

Node.js verifica innanzitutto se il modulo richiesto è un modulo core, come fs o http. Se non si tratta di un modulo core, Node.js interpreta la stringa passata a require come un percorso relativo (che inizia con ./ o ../), un percorso assoluto o un nome di modulo. Per i percorsi relativi e assoluti, Node.js tenta di risolvere il file controllando, nell'ordine:

• Se esiste esattamente il file con il nome fornito;
• Se esiste il file aggiungendo l'estensione .js;
• Se esiste il file aggiungendo l'estensione .json;
• Se esiste il file aggiungendo l'estensione .node.

Se il percorso punta a una directory, Node.js cercherà un file package.json all'interno di quella directory. Se lo trova, utilizzerà il campo main per determinare quale file caricare. Se non esiste un package.json o il campo main, Node.js cercherà un file index.js, index.json o index.node all'interno della directory.

Se si richiede un modulo per nome (non un percorso), Node.js lo cercherà nelle cartelle node_modules, partendo dalla directory corrente e risalendo la struttura delle cartelle fino alla radice.