Handle service worker sleep errors in messaging

Silently ignore 'Could not establish connection' errors caused by Manifest V3 service worker sleep in runtime messaging across background, newtab, and options scripts. Bump extension version to 1.2 and update build script for improved packaging and manifest handling for Firefox compatibility.

Author: cloud-oc

build/build.sh

@@ -1,83 +1,54 @@
 #!/bin/bash
-
-# PixTab 打包脚本
-# 使用 Node.js 处理 JSON，避免 sed 产生的语法错误
-
+# PixTab 一键打包脚本 (macOS/Linux)
 set -e
 
-# 切换到项目根目录
 cd "$(dirname "$0")/.."
 
 echo "🔨 开始打包 PixTab..."
 
-# 检查是否安装了 node
-if ! command -v node &> /dev/null; then
-    echo "❌ 错误: 需要安装 Node.js 才能运行此脚本"
-    exit 1
-fi
-
-# 从 manifest.json 读取版本号 (使用 node 读取更稳健)
+# 读取版本号
 VERSION=$(node -e "console.log(require('./manifest.json').version)")
 echo "📋 版本号: $VERSION"
 
-# 清空并重建 dist 目录
 rm -rf dist
 mkdir -p dist
 
-# ------------------------------------------------------------------
-# 📦 1. 打包 Chrome/Edge 版本
-# ------------------------------------------------------------------
+# 打包 Chrome/Edge 版本
 echo "📦 打包 Chrome/Edge 版本..."
 zip -r "dist/pixtab-${VERSION}-chrome.zip" manifest.json LICENSE index.html options.html style.css _locales icons src -x "*.git*" -x "*.DS_Store"
 
-# ------------------------------------------------------------------
-# 📦 2. 打包 Firefox 版本
-# ------------------------------------------------------------------
+# 打包 Firefox 版本（临时修改 manifest）
 echo "📦 打包 Firefox 版本..."
 cp manifest.json manifest.backup.json
 
-# --- 关键修改：使用 Node.js 脚本修改 manifest ---
-# 这段脚本会自动处理逗号、格式和字段替换，100% 安全
+# 用 Node.js 处理 manifest 字段，兼容 Firefox
 node -e "
 const fs = require('fs');
 const manifestPath = 'manifest.json';
 const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-
-// 1. 修改 background: 把 service_worker 换成 scripts
 if (manifest.background && manifest.background.service_worker) {
     const swPath = manifest.background.service_worker;
     manifest.background.scripts = [swPath];
     delete manifest.background.service_worker;
-    // 移除 type: module（Firefox 不支持）
     if (manifest.background.type) delete manifest.background.type;
 }
-
-// 2. 转换 action.default_icon（如果是对象）为单字符串（优先 48 -> 32 -> 16 -> 128）
 if (manifest.action && manifest.action.default_icon && typeof manifest.action.default_icon === 'object') {
     const sizes = ['48', '32', '16', '128'];
     let selected = null;
     for (const s of sizes) { if (manifest.action.default_icon[s]) { selected = manifest.action.default_icon[s]; break; } }
     if (!selected) selected = 'icons/icon-48.png';
     manifest.action.default_icon = selected;
 }
-
-// 3. 确保 browser_specific_settings.gecko 的字段存在并合法，解决 Firefox 警告
 if (!manifest.browser_specific_settings) manifest.browser_specific_settings = {};
 if (!manifest.browser_specific_settings.gecko) manifest.browser_specific_settings.gecko = {};
-// gecko.strict_min_version: set to a version that supports data_collection_permissions (>=140) and options_page (>=126)
 manifest.browser_specific_settings.gecko.strict_min_version = '142.0';
-// gecko_android: set explicit Android min version to satisfy Android-specific warnings
 manifest.browser_specific_settings.gecko_android = { strict_min_version: '142.0' };
-// data_collection_permissions: requires 'none' entry in required
 manifest.browser_specific_settings.gecko.data_collection_permissions = manifest.browser_specific_settings.gecko.data_collection_permissions || { collects: false, required: ['none'], optional: [] };
-
 fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
 "
-# ------------------------------------------------------
 
 zip -r "dist/pixtab-${VERSION}-firefox.xpi" manifest.json LICENSE index.html options.html style.css _locales icons src -x "*.git*" -x "*.DS_Store"
 
-# 恢复原始 manifest
 mv manifest.backup.json manifest.json
 
 echo ""

dist/pixtab-1.1-chrome.zip dist/pixtab-1.2-chrome.zipdist/pixtab-1.1-chrome.zip renamed to dist/pixtab-1.2-chrome.zip

@@ -1,7 +1,7 @@
 {
   "name": "__MSG_extensionName__",
   "description": "__MSG_extensionDescription__",
-  "version": "1.1",
+  "version": "1.2",
   "manifest_version": 3,
   "default_locale": "en",
   "browser_specific_settings": {

dist/pixtab-1.1-firefox.xpi dist/pixtab-1.2-firefox.xpidist/pixtab-1.1-firefox.xpi renamed to dist/pixtab-1.2-firefox.xpi

@@ -700,14 +700,22 @@ browserAPI.runtime.onMessage.addListener(function (
           try {
             browserAPI.runtime.sendMessage({ action: 'artworkLoadSucceeded' });
           } catch (e) {
-            dbg('Failed to send artworkLoadSucceeded message', e);
+            if (e && e.message && e.message.includes('Could not establish connection')) {
+              // 静默忽略 Manifest V3 service worker 休眠导致的错误
+            } else {
+              dbg('Background sendMessage error:', e);
+            }
           }
         } else {
           // Notify UI that artwork failed to load (keep spinner, but indicate failure)
           try {
             browserAPI.runtime.sendMessage({ action: 'artworkLoadFailed' });
           } catch (e) {
-            dbg('Failed to send artworkLoadFailed message', e);
+            if (e && e.message && e.message.includes('Could not establish connection')) {
+              // 静默忽略 Manifest V3 service worker 休眠导致的错误
+            } else {
+              dbg('Background sendMessage error:', e);
+            }
           }
           sendResponse(null);
         }

manifest.json

@@ -264,8 +264,15 @@ import browserAPI from "../shared/browser-polyfill.js";
       setRefreshing(true);
       showSpinnerIfBlank();
       browserAPI.runtime.sendMessage({ action: "requestArtwork" }, (res) => {
-        if (browserAPI.runtime.lastError) {
-          console.warn("Context invalidated, message could not be processed:", browserAPI.runtime.lastError.message);
+        const lastError = browserAPI.runtime.lastError;
+        if (lastError) {
+          if (lastError.message && lastError.message.includes('Could not establish connection')) {
+            // 静默忽略 Manifest V3 service worker 休眠导致的错误
+            setRefreshing(false);
+            isRequestInProgress = false;
+            return;
+          }
+          console.warn("Extension messaging error:", lastError.message);
           setRefreshing(false);
           isRequestInProgress = false;
           return;

src/background/runtime.js

@@ -53,11 +53,17 @@ const saveOptions = () => {
   );
 
   browserAPI.runtime.sendMessage({ action: "refreshPreferences" }, (response) => {
-    let lastError = browserAPI.runtime.lastError;
+    const lastError = browserAPI.runtime.lastError;
     if (lastError) {
-      console.log(lastError.message);
+      // 仅在调试时输出，生产环境可静默处理
+      if (lastError.message && lastError.message.includes('Could not establish connection')) {
+        // 静默忽略 Manifest V3 service worker 休眠导致的错误
+        return;
+      }
+      console.warn('Extension messaging error:', lastError.message);
       return;
     }
+    // 可根据需要处理 response
   });
 };