Node.js, Require и Exports

Когда я только-только начал играться с Node.js, для меня существовала лишь одна вещь, которая доставляла мне дискомфорт. Занятно, но я говорю сейчас о module.exports. Говоря занятно, я намекаю на то, что это, всё-таки, одна из фундаментальных частей Node.js и она достаточно проста. Сейчас же, оглядываясь назад, я не могу объяснить почему меня это так стопорило… Просто помню, что этот момент был для меня не очевиден. Ну и, полагаю, что я один из тех многих, кто встретив его разок-другой, сначала только путался, прежде чем написал что-либо применив его.

В Node, все штуки видны друг другу только в рамках одного и того же файла. Под штуками я подразумеваю переменные, функции, классы и их члены. Например у нас есть файл misc.js следующего содержания:

var x = 5; var addX = function(value) {   return value + x; }; 

Привычный доступ к переменной x и функции addX из другого файла невозможен. Это никак не связано с использованием var. Дело в том, что Node состоит из блоков называемых модулями, и каждый отдельный файл по своей сути — отдельный блок, чья область видимости изолирована от других таких же блоков.

Теперь, перед тем как мы узнаем, как сделать эти штуки видимыми вне модуля, рассмотрим более подробно как загружаются модули в Node.js. Сейчас речь пойдёт о том месте, где пишется require. require используют для загрузки модуля, обычно присваивая результат его работы какой-то переменной:

var misc = require('./misc'); 

Конечно же, до тех пор, пока наш модуль ничего не отдаёт, все приведённые примеры бесполезны. А чтобы наш модуль что-нибудь отдал, мы будем использовать module.exports:

var x = 5; var addX = function(value) {   return value + x; }; module.exports.x = x; module.exports.addX = addX; 

Вот теперь наш модуль стал гораздо более полезным:

var misc = require('./misc'); console.log("Добавив %d к 10 мы получим %d", misc.x, misc.addX(10)); 

Есть ещё такой способ отдать штуки из нашего модуля:

var User = function(name, email) {   this.name = name;   this.email = email; }; module.exports = User; 

Разница между этими подходами не велика, но важна. Как видно, в данном случае мы экспортируем функцию напрямую:

module.exports.User = User; //vs module.exports = User; 

Всё это к тому, что потом её будет легче использовать:

var user = require('./user');  var u = new user.User(); //vs var u = new user(); 

Выгода от использования такого способа заключается в том, что в данном случае нам не важно, будет ли ваш модуль представлять контейнер c экспортируемыми значениями или нет.

Чтобы ещё более красочно представить процесс взаимодействия модулей, давайте рассмотрим следующий пример:

var powerLevel = function(level) {   return level > 9000 ? "it's over 9000!!!" : level; }; module.exports = powerLevel; 

Когда вы подключите данный модуль используя require, фактически им будет являться функция, что позволит вам сделать следующее:

require('./powerlevel')(9050); 

Что по своей сути является упрощённой записью следующего кода:

var powerLevel = require('./powerlevel') powerLevel(9050);  

Надеюсь эти примеры помогут вам освоиться!