后台服务工作线程

后台服务工作线程是浏览器扩展的核心组件，运行在独立的服务工作线程上下文中。这一特性赋予了它强大的能力，例如可以绕过同源策略（CORS）限制，从任意源获取资源。通常会将计算密集型任务卸载到后台服务工作线程中执行，以保持页面响应的流畅性。

创建第一个后台服务工作线程

要创建您的第一个后台服务工作线程，只需在项目根目录下创建一个 background.ts 文件，然后开始编写代码：

background.ts


export {}
 
console.log(
  "活在当下，珍惜每一刻。时光流转，此刻永不再来。"
)

⚠️

重要提示： 由于 Plasmo 的默认 TypeScript 配置将所有源文件视为 ES 模块，如果文件中没有导入或导出语句，必须在文件开头添加 export {} 来明确标识为模块。在创建第一个内容脚本时也会遇到同样的要求！

重新加载扩展后，打开浏览器的”服务工作线程检查器”：

服务工作线程检查器界面

您将在检查器中看到输出的日志信息：

后台服务工作线程控制台输出

完整的功能示例请参考 with-background 示例项目。

状态持久化管理

⚠️

开发模式说明： 在 Plasmo 的 dev 开发模式下，服务工作线程会始终保持 active 状态以便于调试。

在实际运行环境中，服务工作线程在闲置几秒后会进入休眠状态，浏览器通常会在 5 分钟后完全终止其进程。这意味着所有内存中的状态（变量、对象等）都会丢失，除非使用持久化存储机制。

状态持久化方案

持久化后台服务工作线程状态的最简单方法是使用 Plasmo 的存储 API，该 API 提供了跨会话的数据保存能力。

对于更高级的使用场景，可以考虑以下方案：

远程数据存储：通过 fetch API 或 WebSocket 连接将状态数据发送到远程服务器或数据库
IndexedDB：使用浏览器内置的 IndexedDB 进行结构化数据存储
LocalStorage（有限制）：虽然可用，但需要注意存储容量限制和同步问题

核心功能特性

后台服务工作线程支持以下重要功能：

网络请求代理


// 代理网页请求示例
chrome.webRequest.onBeforeRequest.addListener(
  (details) => {
    // 处理请求逻辑
    return { cancel: false }
  },
  { urls: ["<all_urls>"] },
  ["blocking"]
)

定时任务执行


// 定时执行任务
chrome.alarms.create("daily-task", { periodInMinutes: 1440 })
chrome.alarms.onAlarm.addListener((alarm) => {
  if (alarm.name === "daily-task") {
    // 执行每日任务
  }
})

消息通信枢纽


// 处理来自其他扩展组件的消息
chrome.runtime.onMessage.addListener((message, sender, sendResponse) => {
  // 处理消息并回复
  sendResponse({ received: true })
})

最佳实践建议

💡

性能优化： 尽量减少后台服务工作线程的内存使用，避免长时间运行的同步操作，以保持扩展的整体性能。

⚠️

错误处理： 务必添加完善的错误处理机制，使用 try-catch 块捕获可能出现的异常，确保服务工作线程的稳定性。

🚀

调试技巧： 利用 Chrome DevTools 的服务工作线程面板进行调试，监控网络请求和内存使用情况，优化代码性能。

常见使用场景

数据同步：定期从服务器获取最新数据
消息中转：在不同扩展组件之间传递消息
资源预处理：提前加载和缓存所需资源
定时任务：执行计划性后台操作
网络监控：拦截和处理网络请求

通过合理利用后台服务工作线程，您可以构建出功能强大、响应迅速的浏览器扩展应用。