阅读 717

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

背景

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

由于WebpackBabel等打包、转义工具的出现,开发者已经可以在开发中使用ES ModuleAMD已是明日黄花,使用的人越来越少,不太值得去关注。但CommonJS方案由于Nodejs在前端构建工具和服务端中的普及度,在Nodejs全面支持ES Module、老版本Nodejs消亡之前,我们还是要关注CommonJS方案以及它与ES Module之间的区别,以免搞混、记忆混淆,酿成bug。为了为后面的禁止点做铺垫,先让我们来了解或回顾两个API:Object.preventExtensionsObject.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.preventExtensionsObject.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方案中,你是可以修改整体导入模块对象的直接属性的,长期在CommonJSES 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.preventExtensionsObject.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对象新增属性,整体导入时,不允许给模块对象新增属性,因为整体导入时的模块对象是一个不可拓展的对象,不可以给模块对象新增任何属性
复制代码
关注下面的标签,发现更多相似文章
评论