Vue.js构建Chrome扩展:注入式Vue3应用无法被Vue Devtools检测

基于Vue.js构建了一款Chrome扩展,通过Content Script注入方式加载自研Vue 3应用,无论使用稳定版还是Beta版Vue Devtools,都无法检测到该Vue应用。
已完成的排查操作
- 在
chrome://extensions/扩展管理页为Vue Devtools开启「允许访问文件URL」权限
现有配置
vue.config.js
module.exports = { filenameHashing: false, pages: { popup: { template: 'public/browser-extension.html', entry: './src/popup/main.js', title: 'Popup' }, options: { template: 'public/browser-extension.html', entry: './src/options/main.js', title: 'Options' } }, pluginOptions: { browserExtension: { components: { background: true, contentScripts: true }, componentOptions: { contentScripts: { entries: { "page": 'src/content-scripts/page.js', "results": 'src/content-scripts/results.js', }, }, }, manifestTransformer: (manifest) => { delete manifest.content_security_policy // 该操作用于兼容Chrome Manifest V3规范 return manifest; } } }, configureWebpack: { devtool: "true", } }
package.json
{ "scripts": { "serve": "vue-cli-service build --mode development --watch", "build": "vue-cli-service build", "lint": "vue-cli-service lint" }, "dependencies": { "@tailwindcss/postcss7-compat": "^2.0.2", "autoprefixer": "^9", "core-js": "^3.6.5", "lodash": "^4.17.21", "postcss": "^7", "tailwindcss": "npm:@tailwindcss/postcss7-compat@^2.0.2", "vue": "^3.0.0-beta.1", "vue-router": "^4.0.0-alpha.6", "vuex": "^4.0.0" }, "devDependencies": { "@vue/cli-plugin-babel": "~4.5.0", "@vue/cli-plugin-eslint": "~4.5.0", "@vue/cli-plugin-router": "~4.5.0", "@vue/cli-plugin-vuex": "~4.5.0", "@vue/cli-service": "~4.5.0", "@vue/compiler-sfc": "^3.0.0-beta.1", "babel-eslint": "^10.1.0", "eslint": "^6.7.2", "eslint-plugin-vue": "^7.0.0-alpha.0", "sass": "^1.26.5", "sass-loader": "^8.0.2", "vue-cli-plugin-browser-extension": "latest", "vue-cli-plugin-tailwind": "~2.0.6", "webpack-extension-reloader": "^1.1.4" } }
解决Content Script环境隔离问题
Chrome扩展的Content Script默认运行在独立的隔离世界,与页面主世界、Vue Devtools注入的脚本上下文完全不共享全局变量。Vue Devtools依赖识别主世界window上挂载的__VUE__全局钩子检测应用,隔离环境中的Vue实例对Devtools完全不可见。
调整方式:将Vue应用初始化逻辑从Content Script隔离环境迁出,通过动态插入页面脚本的方式让代码运行在主世界:// Content Script中仅保留注入逻辑 const appInitScript = document.createElement('script') // 引用编译后输出的Vue应用入口文件 appInitScript.src = chrome.runtime.getURL('your-vue-entry.js') appInitScript.onload = () => appInitScript.remove() document.head.appendChild(appInitScript)同时需要在manifest的
web_accessible_resources配置中,将上述Vue入口文件加入可访问白名单,否则Chrome会拦截资源加载。手动开启Vue应用的Devtools权限
自定义打包场景下容易出现Devtools开关未自动生效的问题,需要在应用初始化时手动配置:import { createApp } from 'vue' import App from './App.vue' const app = createApp(App) // 开发环境下强制启用Devtools app.config.devtools = true app.mount('#app')升级依赖到兼容的稳定版本
当前项目使用的Vue、vue-router、vuex均为早期alpha/beta预发布版本,与正式版Vue Devtools的通信协议不兼容,需要升级到与Vue3正式版匹配的稳定版本,避免预发布版本之间的协议差异导致检测失败。修正webpack配置错误
现有配置中devtool: "true"是非法的webpack配置值,会导致sourcemap生成异常、Devtools无法定位组件源码。将该值替换为合法的开发环境sourcemap配置,例如devtool: 'cheap-module-source-map'。修正CSP配置
直接删除content_security_policy的操作不符合Manifest V3规范,反而会导致资源加载受限。需要按照Chrome官方要求配置CSP规则,允许扩展脚本正常执行,不要为了兼容性直接删除该字段。
内容的提问来源于stack exchange,提问作者sparkle

