关于ES模块你必须要知道的一些禁忌(一)

背景

ES Module是JavaScript在ES2015版本开始提供的语言标准级别的模块化方案，在此之前JavaScript一直没有语言级别的模块化体系。没有模块化的支持，使用JavaScript开发大型应用将举步维艰，所以经过大量的实践，社区制定了一些模块加载方案，最主要的有运行于浏览器的AMD方案和运行于以Nodejs为代表的服务端的CommonJS方案。

由于Webpack和Babel等打包、转义工具的出现，开发者已经可以在开发中使用ES Module，AMD已是明日黄花，使用的人越来越少，不太值得去关注。但CommonJS方案由于Nodejs在前端构建工具和服务端中的普及度，在Nodejs全面支持ES Module、老版本Nodejs消亡之前，我们还是要关注CommonJS方案以及它与ES Module之间的区别，以免搞混、记忆混淆，酿成bug。为了为后面的禁止点做铺垫，先让我们来了解或回顾两个API：Object.preventExtensions和Object.freeze。

Object.preventExtensions

Object.preventExtensions()将对象标记为不再可扩展，因此它将永远不会具有超出它被标记为不可扩展的属性。注意，一般来说，不可扩展对象的属性可能仍然可被删除。尝试将新属性添加到不可扩展对象将静默失败或抛出TypeError（在strict mode下）
当我们在严格模式下，尝试对不可拓展的对象进行属性添加时，就会抛出异常，具体代码如下：

"use strict"
var obj = {
    age: 23,
    name: 'rioli',
    city: ['sz', 'jy']
};
Object.preventExtensions(obj);
obj.province = 'GD';

运行结果：

Uncaught TypeError: Cannot add property 'province', object is not extensible 

Object.freeze

Object.freeze() 方法可以冻结一个对象，冻结指的是不能向这个对象添加新的属性，不能修改其已有属性的值，不能删除已有属性，以及不能修改该对象已有属性的可枚举性、可配置性、可写性。该方法返回被冻结的对象。
当我们在严格模式下，尝试对已冻结的对象进行属性修改时，就会抛出异常，具体代码如下：

"use strict"
var obj = {
    age: 23,
    name: 'rioli',
    city: ['sz', 'jy']
};
Object.freeze(obj);
obj.age = 26;

运行结果：

Uncaught TypeError: Cannot assign to read only property 'age' of object '#<Object>'

构建不可拓展的冻结对象

我们可以利用Object.preventExtensions和Object.freeze这两个API来组合构建一个不可拓展的冻结对象，即：不能对对象的顶级属性对象增、删、改等操作。

"use strict"
var obj = {
    age: 23,
    name: 'rioli',
    city: ['sz', 'jy']
};
Object.freeze(obj);
Object.preventExtensions(obj);
// obj.age = 26; 修改顶级属性将引发报错
// obj.province = 'GD';  新增顶级属性将引发报错
// delete obj.name; 删除顶级属性将引发报错
// 但仍然可以修改对象的子对象的属性，因为修改对象的子对象的属性并不会修改子对象的引用，对于引用类型来说等于没有发生值的改变
obj.city[0] = 'zq';
obj.city.push('st');

ES Module禁忌之不可以修改整体导入模块对象的直接属性

为什么会列出这个禁忌，这是因为在CommonJS方案中，你是可以修改整体导入模块对象的直接属性的，长期在CommonJS在ES Module中交叉使用，难免会造成不必要的记忆混淆。但是在 ES Module中，整体导入的模块对象是一个不可拓展的冻结的常量对象，对其直接属性的修改和新增将引发报错。

假定我们正处于CommonJs环境下，例如NodeJS中，我们导入等个模块，然后尝试对模块对象的属性进行修改和新增，具体代码如下：

lib.js

exports.time = Date.now();
exports.getCurrrentYear = function () {
    return new Date().getFullYear();
}
exports.people = {
    age: 26,
    name: 'rioli',
    cities: ['jieyang', 'shenzhen']
};

main.js

const lib = require('./lib');
const people = lib.people;

const print = (data) => {
    console.log("===================================");
    console.log(data);
};

print(people);
print(lib);

people.age = 999;
print(people);

people.father = 'baba';
print(people);

lib.people = 23;
print(lib);

lib.people.age = 666;
print(lib);

lib.provices = ['GD', 'FJ'];
print(lib);

运行结果通过，控制台输出结果如下：

===================================
{ age: 26, name: 'rioli', cities: [ 'jieyang', 'shenzhen' ] }
===================================
{ time: 1545274516494,
  getCurrrentYear: [Function],
  people: { age: 26, name: 'rioli', cities: [ 'jieyang', 'shenzhen' ] } }
===================================
{ age: 999, name: 'rioli', cities: [ 'jieyang', 'shenzhen' ] }
===================================
{ age: 999,
  name: 'rioli',
  cities: [ 'jieyang', 'shenzhen' ],
  father: 'baba' }
===================================
{ time: 1545274516494, getCurrrentYear: [Function], people: 23 }
===================================
{ time: 1545274516494, getCurrrentYear: [Function], people: 23 }
===================================
{ time: 1545274516494,
  getCurrrentYear: [Function],
  people: 23,
  provices: [ 'GD', 'FJ' ] }

---

在ES Module环境下，整体导入的模块对象，但我们对其进行修改和新增属性的时候，其表现和上述利用Object.preventExtensions和Object.freeze这两个API来组合构建一个不可拓展的冻结对象的表现一样，即：这个模块对象是一个不可拓展的冻结的常量对象。演示代码如下：
lib.mjs

export const time = Date.now();

export function getCurrrentYear() {
    return new Date().getFullYear();
}

export const people = {
    age: 26,
    name: 'rioli',
    cities: ['jieyang', 'shenzhen']
};

main.mjs

import { people } from './lib.mjs';
import * as lib from './lib.mjs';

// 首先定一个基调，其实但我们用 import * as xx from 'yy' 将一个模块做整体导入时，此时xx会作为作为模块命名空间

const print = (data) => {
    console.log("===================================");
    console.log(data);
};

print(people);
print(lib);

// 允许修改
people.age = 999;
print(people);

// 允许修改
people.father = 'baba';
print(people);

// 不允许修改，因为作为整体导入时，模块对象的直接一级属性是只读属性，修改将引发报错
try {
    lib.people = 23;
    print(lib);
} catch (e) {
    print(e);
    print("不允许修改lib.people，因为作为整体导入时，模块对象的直接一级属性是只读属性，修改将引发报错");
}

// 允许修改，因为作为整体导入时，模块对象的直接一级属性是只读属性，但一级
// 属性引用的对象不是只读对象，可以修改其属性（只要没有被设置为不可写）
lib.people.age = 666;
print(lib);

// 整体导入时，不允许给模块对象新增属性，因为整体导入时的模块对象是一个不可拓展的对象,不可以给模块对象新增任何属性
try {
    lib.provices = ['GD', 'FJ'];
    print(lib);
} catch (e) {
    print(e);
    print("不允许对lib对象新增属性,整体导入时，不允许给模块对象新增属性，因为整体导入时的模块对象是一个不可拓展的对象,不可以给模块对象新增任何属性");
}

具体运行结果：

===================================
{ age: 26, name: 'rioli', cities: [ 'jieyang', 'shenzhen' ] }
===================================
{ getCurrrentYear: [Function: getCurrrentYear],
  people: { age: 26, name: 'rioli', cities: [ 'jieyang', 'shenzhen' ] },
  time: 1545275257126 }
===================================
{ age: 999, name: 'rioli', cities: [ 'jieyang', 'shenzhen' ] }
===================================
{ age: 999,
  name: 'rioli',
  cities: [ 'jieyang', 'shenzhen' ],
  father: 'baba' }
===================================
TypeError: Cannot assign to read only property 'people' of object '[object Module]'
    at ModuleJob.run (internal/modules/esm/ModuleJob.js:106:14)
    at <anonymous>
===================================
不允许修改lib.people，因为作为整体导入时，模块对象的直接一级属性是只读属性，修改将引发报错
===================================
{ getCurrrentYear: [Function: getCurrrentYear],
  people:
   { age: 666,
     name: 'rioli',
     cities: [ 'jieyang', 'shenzhen' ],
     father: 'baba' },
  time: 1545275257126 }
===================================
TypeError: Cannot add property provices, object is not extensible
    at ModuleJob.run (internal/modules/esm/ModuleJob.js:106:14)
    at <anonymous>
===================================
不允许对lib对象新增属性,整体导入时，不允许给模块对象新增属性，因为整体导入时的模块对象是一个不可拓展的对象,不可以给模块对象新增任何属性