为何读取onExecute时chrome.fileBrowserHandler API显示未定义？

为什么会出现这个错误？ #

你遇到的两个问题本质是同一个原因：chrome.fileBrowserHandler API不支持Manifest V3的Service Worker。

这个API属于Chrome App专属接口，仅能在Manifest V2的背景页（而非Service Worker）或ChromeOS的Chrome App中使用。当你在Manifest V3的Service Worker里调用它时：

1. 浏览器会直接判定Service Worker不合法，抛出“注册失败，状态码15”的警告；
2. 代码中访问chrome.fileBrowserHandler会得到undefined，进而触发Cannot read properties of undefined (reading 'onExecute')的错误。

你测试时的现象也能印证这点：chrome.runtime.onInstalled是Manifest V3 Service Worker支持的API，所以单独用它时扩展能正常运行；但chrome.fileBrowserHandler不在支持列表里，一调用就报错。

怎么解决？ #

临时方案（继续使用fileBrowserHandler） #

将扩展切换为Manifest V2格式（ChromeOS目前仍允许Manifest V2扩展）：

1. 修改manifest.json：
   • 将manifest_version改为2；
   • 替换background字段为背景页配置：

     "background": {
       "page": "background.html"
     }
     

   • 其余字段（如permissions、file_browser_handlers）无需修改。
2. 创建background.html文件，引入你的逻辑代码：

   <!DOCTYPE html>
   <html>
     <body>
       <script src="background.js"></script>
     </body>
   </html>
   

长期方案（适配Manifest V3） #

由于Manifest V2会逐步被淘汰，建议迁移到ChromeOS支持的标准Web API：使用File System Access API让用户手动选择文件进行加密，替代文件管理器右键菜单的触发方式。这样既符合Manifest V3的规范，也能保证长期兼容性。

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