如何编写可在Node.js与浏览器环境同时运行的JavaScript代码？

通过检测全局对象区分环境，如用isNode()判断；2. 避免使用fs、document等平台特有API；3. 用polyfill兼容功能差异，如node-fetch、path-browserify；4. 采用ESM并配置package.json支持双模块语法，实现跨平台运行。

要让JavaScript代码在Node.js和浏览器中都能运行，关键在于避免使用环境特有的API，并通过条件判断来适配不同环境。以下是具体实现方法。

1. 检测当前运行环境

通过检查全局对象来判断代码运行在哪个环境中：

• 浏览器环境中，typeof window !== 'undefined' 为真
• Node.js环境中，typeof process !== 'undefined' && process.versions?.node 为真

可以封装一个简单的检测函数：

2. 避免使用环境专有API

不要直接使用只存在于某一环境的全局变量或模块，例如：

立即学习“Java免费学习笔记（深入）”；

• Node.js中的 require('fs')、__dirname
• 浏览器中的 document、localStorage（在Node中无默认实现）

如果需要文件操作或网络请求，应抽象成统一接口，根据环境选择实现。

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

51

查看详情

3. 使用兼容性模块或polyfill

某些功能在两个环境中行为不一致，可引入通用实现：

• 使用 fetch：浏览器原生支持，Node.js从18版本开始支持，旧版本可通过 node-fetch 或 undici 补充
• 路径处理：使用 path 模块时，在浏览器中可用 path-browserify
• Buffer：浏览器中可通过 buffer npm包模拟

打包工具如Webpack或Rollup可自动注入这些polyfill。

4. 导出兼容模块语法

Node.js支持CommonJS（module.exports）和ES Module，浏览器推荐使用ES Module。建议使用ESM语法并配置package.json：

基本上就这些。核心是识别环境差异，隔离平台相关逻辑，用统一接口对外暴露功能。这样写的代码可移植性强，适合工具库开发。

以上就是如何编写可在Node.js与浏览器环境同时运行的JavaScript代码？的详细内容，更多请关注php中文网其它相关文章！