Какова цель Node.js module.exports и как вы его используете?

Это уже ответили, но я хотел добавить некоторые пояснения...

Вы можете использовать как exports, так и module.exports для импорта кода в ваше приложение следующим образом:

var mycode = require('./path/to/mycode');

Основной пример использования, который вы увидите (например, в примере кода ExpressJS), заключается в том, что вы устанавливаете свойства объекта exports в файле .js, который затем импортируете с помощью require()

Итак, в простом примере подсчета вы могли бы:

(counter.js):

var count = 1;

exports.increment = function() {
    count++;
};

exports.getCount = function() {
    return count;
};

... затем в вашем приложении (web.js или действительно любой другой .js файл):

var counting = require('./counter.js');

console.log(counting.getCount()); // 1
counting.increment();
console.log(counting.getCount()); // 2

В простых терминах вы можете думать о требуемых файлах как о функциях, которые возвращают один объект, и вы можете добавлять свойства (строки, числа, массивы, функции и т.д.) к объекту, который возвращался путем установки их на exports.

Иногда вам нужно, чтобы объект, возвращенный из вызова require(), был функцией, которую вы можете вызвать, а не только объект со свойствами. В этом случае вам также нужно установить module.exports, например:

(sayhello.js):

module.exports = exports = function() {
    console.log("Hello World!");
};

(app.js):

var sayHello = require('./sayhello.js');
sayHello(); // "Hello World!"

Разница между экспортом и module.exports объясняется лучше в этом ответе здесь.

Обратите внимание, что механизм модуля NodeJS основан на CommonJS модулях которые поддерживаются во многих других реализациях, таких как RequireJS, но также SproutCore, CouchDB, Wakanda, OrientDB, ArangoDB, RingoJS, TeaJS, SilkJS, curl.js > или даже Adobe Photoshop (через PSLib). Вы можете найти полный список известных реализаций здесь.

Если ваш модуль не использует специальные функции или модуль node, я настоятельно рекомендую вам использовать export вместо module.exports , который не является частью Стандарт CommonJS, а затем в большинстве случаев не поддерживается другими реализациями.

Другая особенность NodeJS - это когда вы назначаете ссылку на новый объект на export вместо того, чтобы просто добавлять к нему свойства и методы, как в последнем примере, представленном Jed Watson в этом потоке. Я лично бы отказался от этой практики, так как эта нарушает круглую справочную поддержку механизма механизма модулей CommonJS. Затем он не поддерживается всеми реализациями, и пример Jed должен быть написан таким образом (или аналогичным) для обеспечения более универсального модуля:

(sayhello.js):

  export.run = function() {   console.log( "Hello World!" );
}
Код>

(app.js):

  var sayHello = require ('./sayhello');
sayHello.run();// "Привет мир!" 
Код>

Или используя функции ES6

(sayhello.js):

  Object.assign(экспорт, {   // Поместите весь свой публичный API здесь.   скажи привет() {       console.log( "Hello World!" );   }
});
Код>

(app.js):

  const {sayHello} = require ('./sayhello');
скажи привет();// "Привет мир!" 
Код>

PS: Похоже, что Appcelerator также реализует модули CommonJS, но без поддержки круглых ссылок (см. Модули Appcelerator и CommonJS (кеширование и циклические ссылки))

Несколько вещей, которые вы должны позаботиться, если назначить ссылку на новый объект на exports и/или modules.exports:

1. Все свойства/методы, ранее прикрепленные к оригиналу exports или module.exports, конечно, потеряны, потому что экспортируемый объект теперь ссылается на новый новый

Это очевидно, но , если вы добавили экспортированный метод в начале существующего модуля, убедитесь, что собственный экспортированный объект не ссылается на другой объект в конце

exports.method1 = function () {}; // exposed to the original exported object
exports.method2 = function () {}; // exposed to the original exported object

module.exports.method3 = function () {}; // exposed with method1 & method2

var otherAPI = {
    // some properties and/or methods
}

exports = otherAPI; // replace the original API (works also with module.exports)

2. Если один из exports или module.exports ссылается на новое значение, они больше не ссылаются на один и тот же объект

exports = function AConstructor() {}; // override the original exported object
exports.method2 = function () {}; // exposed to the new exported object

// method added to the original exports object which not exposed any more
module.exports.method3 = function () {}; 

3. Трудное следствие. Если вы измените ссылку на exports и module.exports, трудно сказать, какой API открыт (это выглядит как module.exports побед)

// override the original exported object
module.exports = function AConstructor() {};

// try to override the original exported object
// but module.exports will be exposed instead
exports = function AnotherConstructor() {}; 

свойство module.exports или объект экспорта позволяет модулю выбирать, что должно быть совместно использовано с приложением

У меня есть видео на доступном module_export здесь

При делении кода программы на несколько файлов module.exports используется для публикации переменных и функций для потребителя модуля. Вызов require() в исходном файле заменяется соответствующим module.exports, загруженным из модуля.

Помните при написании модулей

• Загрузка модулей кэшируется, только исходный вызов оценивает JavaScript.
• Можно использовать локальные переменные и функции внутри модуля, не все должно быть экспортировано.
• Объект module.exports также доступен как стенограмма exports. Но при возврате единственной функции всегда используйте module.exports.

В соответствии с: "Модули Часть 2 - Написание модулей" .

ссылка ссылается примерно так:

exports = module.exports = function(){
    //....
}

свойства exports или module.exports, такие как функции или переменные, будут отображаться вне

вы должны уделять больше внимания: не экспортируйте override.

почему?

поскольку экспортирует только ссылку на module.exports, вы можете добавить свойства в экспорт, но если вы переопределите экспорт, ссылка будет нарушена.

хороший пример:

exports.name = 'william';

exports.getName = function(){
   console.log(this.name);
}

неверный пример:

exports = 'william';

exports = function(){
     //...
}

Если вы просто хотите открыть только одну функцию или переменную, например:

// test.js
var name = 'william';

module.exports = function(){
    console.log(name);
}   

// index.js
var test = require('./test');
test();

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

В node.js есть определенные модули по умолчанию или существующие, когда вы загружаете и устанавливаете node.js, например http, sys и т.д.

Так как они уже находятся в node.js, когда мы хотим использовать эти модули, мы в основном используем модули импорта, но почему? потому что они уже присутствуют в node.js. Импорт - это как перенос их из node.js и включение их в вашу программу. И затем, используя их.

В то время как Экспорт в точности противоположный, вы создаете модуль, который вы хотите, скажем, module addition.js и помещая этот модуль в node.js, вы делаете это, экспортируя его.

Прежде чем писать что-нибудь здесь, помните, module.exports.additionTwo совпадает с export.additionTwo

Да, так, что причина, нам нравится

exports.additionTwo = function(x)
{return x+2;};

Будьте осторожны с дорогой

Допустим, вы создали модуль add.js,

exports.additionTwo = function(x){
return x + 2;
};

Когда вы запустите это в командной строке node.JS:

node
var run = require('addition.js');

Это приведет к ошибке:

Ошибка: не удается найти модуль add.js

Это связано с тем, что процесс node.js не может быть добавлен. js, так как мы не упоминали путь. Таким образом, мы можем установить путь, используя NODE_PATH

set NODE_PATH = path/to/your/additon.js

Теперь это должно успешно работать без ошибок!

Кроме того, вы также можете запустить файл added.js, не установив NODE_PATH, обратно в командную строку nodejs:

node
var run = require('./addition.js');

Так как мы предоставляем путь сюда, указав его в текущем каталоге ./, это также должно успешно выполняться.

Модуль инкапсулирует связанный код в единую единицу кода. При создании модуля это можно интерпретировать как перемещение всех связанных функций в файл.

Предположим, что есть файл Hello.js, который включает в себя две функции

sayHelloInEnglish = function() {
  return "Hello";
};
sayHelloInSpanish = function() {
  return "Hola";
};

Мы пишем функцию только тогда, когда полезность кода имеет более одного вызова.

Предположим, что мы хотим повысить полезность функции в другом файле, скажем World.js, в этом случае экспортируется файл, который может быть получен с помощью module.exports.

Вы можете просто экспортировать обе функции по приведенному ниже коду

var anyVariable={
 sayHelloInEnglish = function() {
      return "Hello";
    };
  sayHelloInSpanish = function() {
      return "Hola";
    }; 
}
module.export=anyVariable;

Теперь вам просто нужно указать имя файла в World.js inorder для использования этих функций

var world= require("./hello.js");

Чтобы понять этот конкретный вопрос о том, какой экспорт или module.exports и как он работает, я хотел бы рекомендовать всем, кто ищет ответ, посетить эти сайты:

• https://www.sitepoint.com/understanding-module-exports-exports-node-js/
• http://www.tutorialsteacher.com/nodejs/nodejs-module-exports

Надеюсь, это прояснит сомнения. Дайте мне знать, если это поможет!