如何判断JavaScript模块/库适用于浏览器还是Node/Deno环境？

一、通过package.json字段判断 #

1. 浏览器环境标识：browser字段 #

你提到的browser字段是最常用的标识——当库依赖浏览器专属API（如window、document）时，开发者会用这个字段指定浏览器环境下的入口文件，或替换Node专属代码逻辑。比如部分库会在browser字段里把Node的fs模块替换成浏览器端的模拟实现。

2. Node环境专属标识 #

• engines字段：仅支持Node的库通常会用这个字段明确指定Node版本要求，示例：

  "engines": {
    "node": ">=16.0.0"
  }
  

  这种配置基本能说明库只针对Node环境开发，不考虑浏览器兼容性。
• exports字段：现代模块常用这个字段做环境区分，若只定义了node条件、未包含browser分支，说明库仅适配Node：

  "exports": {
    ".": {
      "node": "./dist/node/index.js"
    }
  }
  

• 依赖Node专属包：如果库的dependencies里包含serialport、node-gyp这类仅能在Node环境运行的包，那它肯定只适用于Node。

二、通过代码直接判断 #

1. 检查依赖的API/模块 #

• Node专属特征：代码中出现require('fs')、require('path')、process、child_process等Node内置模块；或使用__dirname、__filename这类Node专属变量。
• 浏览器专属特征：直接引用window、document、navigator、localStorage等浏览器全局对象；或包含大量DOM操作逻辑（如创建DOM元素、绑定页面事件）。
• 跨环境兼容特征：代码存在环境判断逻辑，示例：

  if (typeof window !== 'undefined') {
    // 浏览器端逻辑
  } else {
    // Node端逻辑
  }
  

  这种情况说明库支持双环境。

2. 具体库的判断例子 #

• Angular库：多数官方Angular库（如@angular/core、@angular/common）是跨环境兼容的——既可以在浏览器端渲染，也能在Node端做SSR（服务端渲染）。但UI组件库（如@angular/material）因依赖DOM操作，通常仅适用于浏览器环境，查看代码会发现大量DOM相关API调用。
• node-homie库：从命名就能看出是Node专属库。查看代码会发现它依赖Node的net、fs等内置模块处理网络通信和文件配置；package.json里大概率有engines字段指定Node版本，且无browser字段，完全不考虑浏览器兼容性。

内容的提问来源于stack exchange，提问作者dinika saxena