厉害了，ECMAScript 新提案：JSON模块

ECMAScript 模块系统( import 和 export 关键字)默认只能导入 JavaScript 代码。厉害了

但是新提，将应用程序的厉害了配置保存在一个JSON文件中往往很方便，因此，新提我们可能想直接将JSON文件导入ES模块中。厉害了

长期以来，新提commonjs 模块格式支持导入JSON。厉害了

好消息是新提，第三阶段的厉害了一个名为JSON模块的新提议，提出了一种将JSON导入到ES模块的新提方法。现在，厉害了我们来看看JSON模块是新提如何工作的。

1.导入 config.json.

假设，厉害了我们有一个 config.json 文件，新提内容如下：

{    "name": "My Application",厉害了   "version": "v1.2" } 

如何将 config.json 导入ES模块?

例如，我们创建一个简单的Web应用程序，从JSON配置文件中显示应用程序的名称和版本。

如果你试图直接导入 config.json ，Node.js会抛出一个错误。源码下载

import http from http; import config from ./config.json; http   .createServer((req, res) => {      res.write(`App name: ${ config.name}\n`);     res.write(`App version: ${ config.version}`);     res.end();   })   .listen(8080); 

尝试运行应用程序时，node.js抛出错误 TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".json"

Node.js 在使用 import语句时，默认期望的是JavaScript代码。但由于JSON模块的提议，你可以表明你要导入的数据类型：JSON。

在修复应用程序之前，我们先来看看JSON模块提案有哪些内容。

2. JSON 模块提案

JSON模块提案的本质是允许使用常规的import语句在ES模块中导入JSON数据。

可以通过添加导入断言来导入JSON内容：

import jsonObject from "./file.json" assert {  type: "json" }; 

assert { type: "json"}是一个导入断言，指示模块应该被解析和导入为json。

jsonObject变量包含解析file.json的内容后创建的普通JavaScript对象。

一个JSON模块的内容是使用默认导入的，命名的导入不可用。

JSON模块也可以动态导入：

const {  default: jsonObject } = await import(./file.json, {    assert: {      type: json   } }); 

当一个模块被动态导入时，云南idc服务商包括一个JSON模块，默认的内容在default属性中可用。

在这种情况下，导入断言表示JSON类型。但是，有一个更通用的提议导入断言(目前在第3阶段)，允许导入更多数据格式，如CSS模块。

3. 启用JSON模块

现在，我们将JSON模块集成到Web应用程序中：

import http from http; import config from ./config.json assert {  type: "json" }; http   .createServer((req, res) => {      res.write(`App name: ${ config.name}\n`);     res.write(`App version: ${ config.version}`);     res.end();   })   .listen(8080); 

主模块现在导入config.json文件，并访问其值config.name和config.version。

JSON模块工作在Node.js版本>=17.1中，也可以使用--experimental-json-modules标志启用Experimental JSON模块

node --experimental-json-modules index.mjs 

在浏览器环境中，JSON模块从Chrome 91开始可用。

4.总结

默认情况下，ES模块只能导入JavaScript代码。

由于JSON模块的提议，你可以直接将JSON内容导入到ES模块中。只要在导入语句后使用导入断言就可以了。

import jsonContent from "./file.json" assert {  type: "json" }; 

你可以从Node.js 17.1开始使用JSON模块，使用实验性标志--experimental-json-modules，并在Chrome 91及以上版本中使用。

作者：Dmitri Pavlutin 译者：前端小智 来源：dmitripavlutin 原文：https://dmitripavlutin.com/javascript-json-modules/