wxt

WXT - 浏览器扩展框架

适用场景

适用于以下情况：

• 项目根目录中有 wxt.config.ts
• 代码使用 defineBackground、defineContentScript、defineUnlistedScript
• package.json 将 wxt 列为依赖项
• 入口点目录包含扩展入口文件
• 代码从 #imports 或 wxt/* 导入内容

快速参考

主题	参考资料
配置、清单、环境变量、TypeScript	references/config.md
入口点（后台、HTML 页面、未列出脚本）	references/entrypoints.md
内容脚本（UI、主世界、SPA）	references/content-scripts.md
存储 API、defineItem、迁移、监听器	references/storage.md
消息传递（跨上下文通信）	references/messaging.md
使用 WxtVitest 和 fakeBrowser 进行测试	references/testing.md
WXT 模块（使用与创建）	references/modules.md
多浏览器构建和运行时检测	references/multi-browser.md
Vue、React、Svelte、Solid 配置	references/frontend-frameworks.md
常见模式和反模式	references/patterns.md

最常见模式

// entrypoints/background.ts
export default defineBackground({
  main() {
    // ALL runtime code must be inside main() - cannot be async
    browser.runtime.onInstalled.addListener(() => {
      console.log('Extension installed');
    });
  },
});

重要：main() 不能是 async。main() 之外的代码会在 Node.js 中于构建时运行。