如何不基于构建工具优雅的实现模块导入?

开发
当 ES Module​ 最开始作为一种新的 JavaScript​ 模块化方案在 ES6​ 中被引入的候,其实是通过在 import 语句中强制指定相对路径或绝对路径来实现的。

当 ES Module​ 最开始作为一种新的 JavaScript​ 模块化方案在 ES6​ 中被引入的候,其实是通过在 import 语句中强制指定相对路径或绝对路径来实现的。

import dayjs from "https://cdn.skypack.dev/dayjs@1.10.7"; // ES modules
console.log(dayjs("2022-08-12").format("YYYY-MM-DD"));

这和其他常见的模块化系统(例如 CommonJS​)的工作方式略有不同,并且在使用像 webpack 这样的模块打包工具的时候会使用更简单的语法:

const dayjs = require('dayjs') // CommonJS

import dayjs from 'dayjs'; // webpack

在这些系统里,模块导入语句通过 Node.js​ 运行时或相关构建工具映射到特定(版本)的文件。用户只需要在 import 语句中直接编写模块说明符(通常是包名),模块就可以自动处理。

由于开发人员已经熟悉了这种从 npm 导入包的方式,因此必须要先经过一个的构建步骤才能确保以这种方式编写的代码可以在浏览器中运行。

Import maps 就可以解决这个问题,它可以将模块说明符(包名)自动映射到它的相对或绝对路径。从而让我们不使用构建工具也能使用简洁的模块导入语法。

如何使用 Import maps

我们可以通过 HTML​ 中的 <script type="importmap">​ 标签来指定一个 Import maps。

<script type="importmap">
{
"imports": {
"dayjs": "https://cdn.skypack.dev/dayjs@1.10.7",
}
}
</script>

为了成功的在模块解析之前对其进行解析。这个 script​ 标签必须放在文档中第一个 <script type="module">​ 标签之前(最好放在 <head>​中),另外,目前每个 HTML​ 只允许编写一个 Import maps 。

<script type="module">
import dayjs from 'dayjs';

console.log(dayjs("2022-08-12").format("YYYY-MM-DD"));
</script>

在 script​ 标签内,我们可以通过一个 JSON​ 对象来为文档中的脚本所需导入的模块指定所有必要的映射。一个典型的 importmap 结构如下所示:

<script type="importmap">
{
"imports": {
"react": "https://cdn.jsdelivr.net/npm/react/umd/react.production.min.js",
"react-dom": "https://cdn.jsdelivr.net/npm/react-dom/umd/react-dom.production.min.js"
"square": "./modules/square.js",
"lodash": "/node_modules/lodash-es/lodash.js"
}
}
</script>

在上面的 import​ 对象中,每个属性对应一个映射。映射的左侧是导入说明符的名称(一般是包名),而右侧是说明符需要映射到的相对或绝对路径。在映射中指定相对路径时,必须要确保它们始终以 /、../或 ./ 开头。

另外,importmap​ 中声明的包并不一定意味着它一定会被浏览器加载。页面上的脚本没有使用到的任何模块都不会被浏览器加载,即便你在 importmap 中声明了它。

编写好 importmap​ 之后,你就可以在后面的脚本中直接使用 ES Module 语法了。

<script type="module">
import { cloneDeep } from 'lodash';

const objects = [{ a: 1 }, { b: 2 }];

const deep = cloneDeep(objects);
console.log(deep[0] === objects[0]);
</script>

外部映射

你还可以在外部文件中指定你的映射,然后使用 script​ 的 src​ 属性链接到这个文件(Content-Type Header​ 必须要设置为 application/importmap+json 才能正常加载)。

<script type="importmap" src="importmap.json"></script>

不过尽量不要使用这种方式,因为它的性能比直接内联编写要差。

映射整个包

除了将一个说明符映射到模块之外,你还可以将一个说明符映射到包含多个模块的包:

<script type="importmap">
{
"imports": {
"lodash/": "/node_modules/lodash-es/"
}
}
</script>

这种编写方式可以让你直接导入指定路径中的任何模块,相应的,浏览器也会把所有组件模块下载下来。

<script type="module">
import toUpper from 'lodash/toUpper.js';
import toLower from 'lodash/toLower.js';

console.log(toUpper('ConardLi'));
console.log(toLower('ConardLi'));
</script>

动态映射

你也可以基于一些条件在 script 中添加一个动态映射,比如,在下面的示例中我们通过判断是否存在 IntersectionObserver API 来导入不同文件:

<script>
const importMap = {
imports: {
lazyload: 'IntersectionObserver' in window
? './lazyload.js'
: './lazyload-fallback.js',
},
};

const im = document.createElement('script');
im.type = 'importmap';
im.textContent = JSON.stringify(importMap);
document.currentScript.after(im);
</script>

使用同一模块的不同版本

使用 importmap 我们可以将不同的版本的模块映射到不同的包名中:

    <script type="importmap">
{
"imports": {
"lodash@3/": "https://unpkg.com/lodash-es@3.10.1/",
"lodash@4/": "https://unpkg.com/lodash-es@4.17.21/"
}
}
</script>

另外你还可以通过 scopes 来实现同一个包不同模块的更细粒度的版本控制:

<script type="importmap">
{
"imports": {
"lodash/": "https://unpkg.com/lodash-es@4.17.21/"
},
"scopes": {
"/static/js": {
"lodash/": "https://unpkg.com/lodash-es@3.10.1/"
}
}
}
</script>

/static/js​ 下的模块会使用 3.10.1​ 版本,而其他模块会使用 4.17.21 版本。

兼容性

图片

这项技术目前在 Chrome​ 和 Edge​ 浏览器 89​ 及更高版本提供了全面支持,但 Firefox、Safari 和一些移动浏览器还没有支持。我们可以通过下面的代码来判断浏览器的支持情况:

if (HTMLScriptElement.supports && HTMLScriptElement.supports('importmap')) {
// import maps is supported
}

对于没有提供支持的浏览器,我们可以使用下面这个 polyfill:https://github.com/guybedford/es-module-shims

另外官方也推荐了一些其他 importmap​ 相关的 polyfill 和工具:

图片

https://github.com/WICG/import-maps#community-polyfills-and-tooling

责任编辑:赵宁宁 来源: code秘密花园
相关推荐

2020-04-23 08:55:01

LinuxGradle工具

2021-05-31 17:37:26

ViteReactesbuild

2023-08-22 10:13:53

模块工具JavaScrip

2023-03-15 23:59:13

前端构建工具

2020-09-07 14:40:20

Vue.js构建工具前端

2021-05-25 16:34:06

JavaScript前端

2021-08-30 06:27:21

工具容器Docker

2010-02-03 15:09:13

Python 构建工具

2011-12-30 09:23:25

JavaPhing

2022-05-16 09:14:28

前端构建工具

2013-01-31 10:15:28

JavaScriptGrunt

2021-06-05 18:01:05

工具Rollup前端

2011-12-07 10:56:29

ApacheMakeJava

2022-09-01 11:02:42

前端工具

2021-06-18 06:11:26

工具WebpackSnowpack

2016-01-31 09:47:13

Java程序员构建工具

2017-08-01 07:31:55

Router模块化页面

2021-11-01 15:51:33

OpenHarmony工业操作系统

2021-04-30 08:00:00

数据工程师开发工具

2020-08-26 07:17:19

通信
点赞
收藏

51CTO技术栈公众号