Node.js 模块系统入门

在编程领域中,模块是自包含的功能单元,可以跨项目共享和重用。它们使开发人员的生活更加轻松,因为我们可以使用它来增加应用程序的功能,而不必亲自编写这些功能。它还让我们可以组织和解耦代码,从而使应用程序更容易理解、调试和维护。

在本文中,我们来探究如何使用 Node.js 中的模块,主要介绍如何导出和导入。

不同的模块格式

由于JavaScript 最初没有模块的概念,随着时间的推移出现了各种相互竞争的格式。以下是主流的几种格式:

  • 格式, 用于浏览器端,使用 define 函数定义模块。
  •  格式,用于 Node.js,使用 require 和 module.exports 定义依赖和模块。
  •   格式。从 ES6 (ES2015)开始,JavaScript 支持原生模块格式。它使用export 关键字导出模块的公开 API,并用 import 关键字导入。
  •   格式被设计用于在ES5 中 支持 ES6 模块。
  •   格式,在浏览器和 Node.js 中都可以使用。当模块需要被多种模块加载程序导入时,这个很有用。

请注意,本文只讨论 CommonJS 格式,它是Node.js 中的标准格式。如果你想深入了解其他格式,我推荐你阅读,作者是 SitePoint 的 Jurgen Van de Moere。

加载模块

Node.js 有一系列的,我们在代码中无需安装即可使用。为此,我们需要使用require关键字加载这个模块,并把它赋值给一个变量。这样就可以调用模块暴露的任何方法了。

例如,要列出目录的内容,你可以使用 的 readdir 方法:

const fs = require('fs');
const folderPath = '/home/jim/Desktop/';

fs.readdir(folderPath, (err, files) => {
  files.forEach(file => {
    console.log(file);
  });
});

注意,在 CommonJS 里,模块是按照出现的顺序同步加载和处理的。

创建和导出模块

现在我们来看看如何创建模块并导出,以便在程序的其他地方使用。先创建一个 user.js 文件,并添加如下内容。

const getName = () => {
  return 'Jim';
};

exports.getName = getName;

然后在同一个目录中创建一个 index.js 文件,添加以下内容:

const user = require('./user');
console.log(`User: ${user.getName()}`);

用命令node index.js 运行程序,你应该会在控制台看到如下输出:

User: Jim

这里发生了什么?如果你查看一下user.js文件,你会注意到我们定义了一个getName函数,然后使用exports关键字使其可以在其他地方导入。然后是 index.js文件,我们导入了这个方法并执行它。还要注意的是在require 语句中,模块名字加了前缀 ./,因为它是本地文件。另外就是不需要加文件扩展名。

导出多个方法和值

我们可以用同样的方式导出多个方法和值:

const getName = () => {
  return 'Jim';
};

const getLocation = () => {
  return 'Munich';
};

const dateOfBirth = '12.01.1982';

exports.getName = getName;
exports.getLocation = getLocation;
exports.dob = dateOfBirth;

 index.js 文件:

const user = require('./user');
console.log(
  `${user.getName()} lives in ${user.getLocation()} and was born on ${user.dob}.`
);

上面的代码结果如下:

Jim lives in Munich and was born on 12.01.1982.

注意,我们为导出的dateOfBirth变量指定的名称可以是任何我们想要的名称(本例中为dob)。它不必与原来的变量名相同。

多种语法形式

还需要提到的是,你可以在中途导出方法和值,并不一定要在文件末尾。
例如:

exports.getName = () => {
  return 'Jim';
};

exports.getLocation = () => {
  return 'Munich';
};

exports.dob = '12.01.1982';

另外要感谢,我们可以根据需要选择性导入:

const { getName, dob } = require('./user');
console.log(
  `${getName()} was born on ${dob}.`
);

如你所料,这会输出日志:

Jim was born on 12.01.1982.

导出默认值

在上面的例子中,我们分别导出了函数和值。这对于整个应用程序都需要的辅助函数来说是很方便的,但是当你的模块只导出单个对象时,通常使用module.exports

class User {
  constructor(name, age, email) {
    this.name = name;
    this.age = age;
    this.email = email;
  }

  getUserStats() {
    return `
      Name: ${this.name}
      Age: ${this.age}
      Email: ${this.email}
    `;
  }
}

module.exports = User;

 index.js文件:

const User = require('./user');
const jim = new User('Jim', 37, 'jim@example.com');

console.log(jim.getUserStats());

上面的代码输出日志:

Name: Jim
Age: 37
Email: jim@example.com

 module.exports 和 exports 的区别是什么

你在网上可能会遇到以下语法:

module.exports = {
  getName: () => {
    return 'Jim';
  },

  getLocation: () => {
    return 'Munich';
  },

  dob: '12.01.1982',
};

这里我们把要导出的函数和值赋给 module 的 exports 属性——当然这也是可以的:

const { getName, dob } = require('./user');
console.log(
  `${getName()} was born on ${dob}.`
);

输出日志如下:

Jim was born on 12.01.1982.

那么, module.exports和 exports之间的区别到底是什么?后者只是个别名吗?

嗯,有一点,但不完全是。

为了说明我的意思,让我们更改index.js 中的代码,输出module的值:

console.log(module);

输出结果为:

Module {
  id: '.',
  exports: {},
  parent: null,
  filename: '/home/jim/Desktop/index.js',
  loaded: false,
  children: [],
  paths:
   [ '/home/jim/Desktop/node_modules',
     '/home/jim/node_modules',
     '/home/node_modules',
     '/node_modules' ] }

可以看到,module 有一个exports 属性。让我们再加点东西:

// index.js
exports.foo = 'foo';
console.log(module);

这会输出:

Module {
  id: '.',
  exports: { foo: 'foo' },
  ...

exports 添加属性,也会添加到 module.exports。这是因为exportsmodule.exports的一个引用。

我应该用哪个?

既然 module.exports 和 exports 都指向同一个对象,你使用哪一个通常无关紧要。例如:

exports.foo = 'foo';
module.exports.bar = 'bar';

这段代码将会使模块的导出对象变成{ foo: 'foo', bar: 'bar' }

不过,这里有个需要注意的地方。你赋值给module.exports的内容将成为模块导出的值。

举例如下:

exports.foo = 'foo';
module.exports = () => { console.log('bar'); };

这样只会导出一个匿名函数。foo变量将被忽略。

如果你想了解更多,我推荐你阅读 。

总结

模块已经成为 JavaScript 生态系统不可分割的一部分,它让我们能用更小的部分组成大型程序。我希望本文为你在 Node.js 中使用模块做了良好介绍,以及帮助你了解模块语法。

作者:James Hibbard
来源:
翻译:1024译站

更多前端技术干货尽在微信公众号:1024译站

posted @ 2020-01-08 12:14  李中凯  阅读( ...)  评论( ...)    收藏