package.json 中的 browser main module
npm
包其实又分为:只允许在客户端使用的,只允许造服务端使用的,浏览器/服务端都可以使用。
如果我们需要开发一个 npm
包同时兼容支持 web端 和 server 端,需要在不同环境下加载npm包不同的入口文件,显然一个 main
字段已经不能够满足我们的需求,这就衍生出来了 module
与 browser
字段。
文件优先级
在说 package.json
之前,先说下文件优先级
由于我们使用的模块规范有 ESM 和 commonJS 两种,为了能在 node 环境下原生执行 ESM 规范的脚本文件,.mjs
文件就应运而生。
当存在 index.mjs
和 index.js
这种同名不同后缀的文件时,import './index'
或者 require('./index')
是会优先加载 index.mjs
文件的。
也就是说,优先级 mjs
> js
browser
,module
和 main
字段
字段定义
-
main
: 定义了npm
包的入口文件,browser 环境和 node 环境均可使用 -
module
: 定义npm
包的 ESM 规范的入口文件,browser 环境和 node 环境均可使用 -
·
browser
: 定义npm
包在 browser 环境下的入口文件
总结
-
如果
npm
包导出的是 ESM 规范的包,使用 module -
如果
npm
包只在 web 端使用,并且严禁在 server 端使用,使用 browser。 -
如果
npm
包只在 server 端使用,使用 main -
如果
npm
包在 web 端和 server 端都允许使用,使用 browser 和 main
实际情况 https://github.com/SunshowerC/blog/issues/8
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 25岁的心里话
· 闲置电脑爆改个人服务器(超详细) #公网映射 #Vmware虚拟网络编辑器
· 基于 Docker 搭建 FRP 内网穿透开源项目(很简单哒)
· 零经验选手,Compose 一天开发一款小游戏!
· 一起来玩mcp_server_sqlite,让AI帮你做增删改查!!