基于 Vite + React 构建 Chrome Extension (MV3) 开发环境

前言

此前一直想做一个 bilibili 的弹幕插件，最近借着研究 Vite 的契机实操了一下，花了两天时间算是搭好了基于 Vite + React 的 Chrome Extension (MV3) 开发环境，核心功能如下：

• JS 打包成单文件
• 自动引入 CSS
• 打包 service worker
• 开发环境热更新

这里重点介绍一下当前热更新的实现，其他功能相对而言简单很多，详情可参考 theprimone/violet

一次偶然的机会在 B 站看了 《紫罗兰永恒花园》，给人印象深刻，刚好这次打算做个 bilibili 的弹幕插件，索性就取了女主名字中的 violet

实操

热更新大致的流程如下图所示：

启动

通过 npm run dev 同时执行三个命令：

• tsc 编译 service worker 并监听变化
• vite 编译 extension
• websocket 服务监听打包后目录 /dist 的变化

其中，由于 vite build --watch 还未发布，暂时通过自定义脚本监听源码变化，待 vite 该功能发布后可移除。

热更新

浏览器页面加载 content scripts 后会创建一个 websocket 链接，服务端收到请求后会开启对 /dist 目录的监听，websocket 服务监听到 /dist 的变化后主动发起通知。

content scripts 收到需要更新 Extension 的通知，通过 chrome.runtime.sendMessage 触发 service worker 中通过 chrome.runtime.onMessage 注册的事件，依次触发 chrome.runtime.reload 和 chrome.tabs.reload 更新 Extension 和当前页面。实现了所写即所得，无需任何手动介入

可能会有读者有个疑问，为什么不直接在 service worker 中监听 websocket 的通知呢？

此前一直也是这么想的，在 Manifest V3 下使用 service worker 提倡 Thinking with events，通过 chrome.runtime.onInstalled 和 chrome.runtime.onStartup 创建 websocket 客户端会被意外的关闭，即便是使用定时器轮询也会在执行多次之后被关闭再启动。因此，当前找到的最佳方案是在 service worker 中监听 chrome.runtime.onMessage 事件。

这样就实现了当页面加载目标插件时才会触发热更新的流程。

总结

由于现在的 Chrome Extension 大多是低于 MV3 版本的，两天下来，踩了不少坑，对于此前没有接触过的浏览器插件开发也有了一定程度的了解。现在只是针对 Chrome Extension 的场景，后续会在不断完善当前场景的情况下，完成对其他浏览器插件的支持。最终应该可以封装一个浏览器插件开发的工具。