如何在Manifest V3版Chrome扩展中让main.js访问SheetJS库？

原因分析 #

Manifest V3的内容脚本（content scripts）运行在*隔离世界（isolated world）*中，与页面的全局环境隔离。如果SheetJS的脚本没有在这个隔离环境的window对象上正确暴露XLSX变量，就会导致main.js无法访问。

解决方案 #

方案1：手动暴露全局变量 #

• 打开你使用的xlsx.full.min.js文件，在文件末尾添加一行代码：

  window.XLSX = XLSX;
  

• 保存修改后的脚本，重新加载扩展。此时main.js就能通过window.XLSX访问SheetJS的API。

方案2：使用ES模块加载（推荐） #

Manifest V3支持内容脚本使用ES模块，这种方式更规范，避免全局变量冲突：

• 下载SheetJS的ES模块版本（xlsx.esm.min.js），替换原有的xlsx.full.min.js。
• 修改manifest.json中的内容脚本配置，添加"type": "module"：

  "content_scripts": [
      {
        "matches": ["https://example.com/*"],
        "run_at" : "document_end",
        "type": "module",
        "js": ["xlsx.esm.min.js", "main.js"]
      }
    ]
  

• 在main.js中通过导入语句引入SheetJS：

  import * as XLSX from './xlsx.esm.min.js';
  

• 重新加载扩展，即可正常调用SheetJS的方法。

方案3：改用轻量版本 #

如果不需要SheetJS的全部功能，可以尝试使用xlsx.mini.min.js（SheetJS的轻量版本），该版本默认会在全局环境暴露XLSX变量，直接替换原脚本即可，无需额外修改。

验证步骤 #

• 打开Chrome扩展管理页面，开启"开发者模式"。
• 点击"重新加载"按钮刷新你的扩展。
• 访问目标页面（https://example.com/*），打开开发者工具的控制台，检查是否还有"XLSX is not defined"错误。

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