[v1.3] 重构通讯机制：采用 storage.local 广播 + 符合 Firefox MV3 scripting 规范 + 不可追踪的动态同步 MessageFlag

example/tests/early_inject_content_test.js

@@ -18,47 +18,93 @@
 // @run-at       document-start
 // ==/UserScript==
 
-(async function () {
-  "use strict";
-
-  console.log("%c=== Content环境 GM API 测试开始 ===", "color: blue; font-size: 16px; font-weight: bold;");
-
-  let testResults = {
-    passed: 0,
-    failed: 0,
-    total: 0,
-  };
-
-  // 测试辅助函数（支持同步和异步）
-  async function test(name, fn) {
-    testResults.total++;
-    try {
-      await fn();
-      testResults.passed++;
-      console.log(`%c✓ ${name}`, "color: green;");
-      return true;
-    } catch (error) {
-      testResults.failed++;
-      console.error(`%c✗ ${name}`, "color: red;", error);
-      return false;
-    }
+// 测试辅助函数（支持同步和异步）
+async function test(name, fn) {
+  testResults.total++;
+  try {
+    await fn();
+    testResults.passed++;
+    console.log(`%c✓ ${name}`, "color: green;");
+    return true;
+  } catch (error) {
+    testResults.failed++;
+    console.error(`%c✗ ${name}`, "color: red;", error);
+    return false;
   }
-
-  // assert(expected, actual, message) - 比较两个值是否相等
-  function assert(expected, actual, message) {
-    if (expected !== actual) {
-      const valueInfo = `期望 ${JSON.stringify(expected)}, 实际 ${JSON.stringify(actual)}`;
-      const error = message ? `${message} - ${valueInfo}` : `断言失败: ${valueInfo}`;
-      throw new Error(error);
-    }
+}
+
+function testSync(name, fn) {
+  testResults.total++;
+  try {
+    fn();
+    testResults.passed++;
+    console.log(`%c✓ ${name}`, "color: green;");
+    return true;
+  } catch (error) {
+    testResults.failed++;
+    console.error(`%c✗ ${name}`, "color: red;", error);
+    return false;
   }
+}
+
+// assert(expected, actual, message) - 比较两个值是否相等
+function assert(expected, actual, message) {
+  if (expected !== actual) {
+    const valueInfo = `期望 ${JSON.stringify(expected)}, 实际 ${JSON.stringify(actual)}`;
+    const error = message ? `${message} - ${valueInfo}` : `断言失败: ${valueInfo}`;
+    throw new Error(error);
+  }
+}
 
-  // assertTrue(condition, message) - 断言条件为真
-  function assertTrue(condition, message) {
-    if (!condition) {
-      throw new Error(message || "断言失败: 期望条件为真");
-    }
+// assertTrue(condition, message) - 断言条件为真
+function assertTrue(condition, message) {
+  if (!condition) {
+    throw new Error(message || "断言失败: 期望条件为真");
   }
+}
+
+console.log("%c=== Content环境 GM API 测试开始 ===", "color: blue; font-size: 16px; font-weight: bold;");
+
+let testResults = {
+  passed: 0,
+  failed: 0,
+  total: 0,
+};
+
+// 同步测试
+
+// ============ GM_addElement/GM_addStyle 测试 ============
+console.log("\n%c--- DOM操作 API 测试 ---", "color: orange; font-weight: bold;");
+
+testSync("GM_addElement", () => {
+  const element = GM_addElement("div", {
+    textContent: "GM_addElement测试元素",
+    style: "display:none;",
+    id: "gm-test-element",
+  });
+  assertTrue(element !== null && element !== undefined, "GM_addElement应该返回元素");
+  assert("gm-test-element", element.id, "元素ID应该正确");
+  assert("DIV", element.tagName, "元素标签应该是DIV");
+  console.log("返回元素:", element);
+  // 清理测试元素
+  element.parentNode.removeChild(element);
+});
+
+testSync("GM_addStyle", () => {
+  const styleElement = GM_addStyle(`
+            .gm-style-test {
+                color: #10b981 !important;
+            }
+        `);
+  assertTrue(styleElement !== null && styleElement !== undefined, "GM_addStyle应该返回样式元素");
+  assertTrue(styleElement.tagName === "STYLE" || styleElement.sheet, "应该返回STYLE元素或样式对象");
+  console.log("返回样式元素:", styleElement);
+  // 清理测试样式
+  styleElement.parentNode.removeChild(styleElement);
+});
+
+(async function () {
+  "use strict";
 
   // ============ 早期脚本环境检查 ============
   console.log("\n%c--- 早期脚本环境检查 ---", "color: orange; font-weight: bold;");
@@ -107,37 +153,11 @@
     console.log("脚本注入到:", node.tagName);
   });
 
-  // ============ GM_addElement/GM_addStyle 测试 ============
-  console.log("\n%c--- DOM操作 API 测试 ---", "color: orange; font-weight: bold;");
-
-  await test("GM_addElement", () => {
-    const element = GM_addElement("div", {
-      textContent: "GM_addElement测试元素",
-      style: "display:none;",
-      id: "gm-test-element",
-    });
-    assertTrue(element !== null && element !== undefined, "GM_addElement应该返回元素");
-    assert("gm-test-element", element.id, "元素ID应该正确");
-    assert("DIV", element.tagName, "元素标签应该是DIV");
-    console.log("返回元素:", element);
-  });
-
-  await test("GM_addStyle", () => {
-    const styleElement = GM_addStyle(`
-            .gm-style-test {
-                color: #10b981 !important;
-            }
-        `);
-    assertTrue(styleElement !== null && styleElement !== undefined, "GM_addStyle应该返回样式元素");
-    assertTrue(styleElement.tagName === "STYLE" || styleElement.sheet, "应该返回STYLE元素或样式对象");
-    console.log("返回样式元素:", styleElement);
-  });
-
   // ============ GM_log 测试 ============
   console.log("\n%c--- GM_log 测试 ---", "color: orange; font-weight: bold;");
 
   await test("GM_log", () => {
-    GM_log("测试日志输出", { type: "test", value: 123 });
+    GM_log("测试日志输出", "info", { type: "test", value: 123 });
     // GM_log本身不返回值,只要不抛出异常就算成功
     assertTrue(true, "GM_log应该能正常输出");
   });

example/tests/early_test.js

@@ -17,47 +17,91 @@
 // @run-at       document-start
 // ==/UserScript==
 
-(async function () {
-  "use strict";
-
-  console.log("%c=== 早期脚本 GM API 测试开始 ===", "color: blue; font-size: 16px; font-weight: bold;");
-
-  let testResults = {
-    passed: 0,
-    failed: 0,
-    total: 0,
-  };
-
-  // 测试辅助函数（支持同步和异步）
-  async function test(name, fn) {
-    testResults.total++;
-    try {
-      await fn();
-      testResults.passed++;
-      console.log(`%c✓ ${name}`, "color: green;");
-      return true;
-    } catch (error) {
-      testResults.failed++;
-      console.error(`%c✗ ${name}`, "color: red;", error);
-      return false;
-    }
+// 测试辅助函数（支持同步和异步）
+async function test(name, fn) {
+  testResults.total++;
+  try {
+    await fn();
+    testResults.passed++;
+    console.log(`%c✓ ${name}`, "color: green;");
+    return true;
+  } catch (error) {
+    testResults.failed++;
+    console.error(`%c✗ ${name}`, "color: red;", error);
+    return false;
   }
-
-  // assert(expected, actual, message) - 比较两个值是否相等
-  function assert(expected, actual, message) {
-    if (expected !== actual) {
-      const valueInfo = `期望 ${JSON.stringify(expected)}, 实际 ${JSON.stringify(actual)}`;
-      const error = message ? `${message} - ${valueInfo}` : `断言失败: ${valueInfo}`;
-      throw new Error(error);
-    }
+}
+
+function testSync(name, fn) {
+  testResults.total++;
+  try {
+    fn();
+    testResults.passed++;
+    console.log(`%c✓ ${name}`, "color: green;");
+    return true;
+  } catch (error) {
+    testResults.failed++;
+    console.error(`%c✗ ${name}`, "color: red;", error);
+    return false;
   }
+}
+
+// assert(expected, actual, message) - 比较两个值是否相等
+function assert(expected, actual, message) {
+  if (expected !== actual) {
+    const valueInfo = `期望 ${JSON.stringify(expected)}, 实际 ${JSON.stringify(actual)}`;
+    const error = message ? `${message} - ${valueInfo}` : `断言失败: ${valueInfo}`;
+    throw new Error(error);
+  }
+}
 
-  // assertTrue(condition, message) - 断言条件为真
-  function assertTrue(condition, message) {
-    if (!condition) {
-      throw new Error(message || "断言失败: 期望条件为真");
-    }
+// assertTrue(condition, message) - 断言条件为真
+function assertTrue(condition, message) {
+  if (!condition) {
+    throw new Error(message || "断言失败: 期望条件为真");
   }
+}
+
+console.log("%c=== 早期脚本 GM API 测试开始 ===", "color: blue; font-size: 16px; font-weight: bold;");
+
+let testResults = {
+  passed: 0,
+  failed: 0,
+  total: 0,
+};
+
+// ============ GM_addElement/GM_addStyle 测试 ============
+console.log("\n%c--- DOM操作 API 测试 ---", "color: orange; font-weight: bold;");
+
+testSync("GM_addElement", () => {
+  const element = GM_addElement("div", {
+    textContent: "GM_addElement测试元素",
+    style: "display:none;",
+    id: "gm-test-element",
+  });
+  assertTrue(element !== null && element !== undefined, "GM_addElement应该返回元素");
+  assert("gm-test-element", element.id, "元素ID应该正确");
+  assert("DIV", element.tagName, "元素标签应该是DIV");
+  console.log("返回元素:", element);
+  // 清理测试元素
+  element.parentNode.removeChild(element);
+});
+
+testSync("GM_addStyle", () => {
+  const styleElement = GM_addStyle(`
+            .gm-style-test {
+                color: #10b981 !important;
+            }
+        `);
+  assertTrue(styleElement !== null && styleElement !== undefined, "GM_addStyle应该返回样式元素");
+  assertTrue(styleElement.tagName === "STYLE" || styleElement.sheet, "应该返回STYLE元素或样式对象");
+  console.log("返回样式元素:", styleElement);
+  // 清理测试样式
+  styleElement.parentNode.removeChild(styleElement);
+});
+
+(async function () {
+  "use strict";
 
   // ============ 早期脚本环境检查 ============
   console.log("\n%c--- 早期脚本环境检查 ---", "color: orange; font-weight: bold;");
@@ -135,37 +179,11 @@
     }
   });
 
-  // ============ GM_addElement/GM_addStyle 测试 ============
-  console.log("\n%c--- DOM操作 API 测试 ---", "color: orange; font-weight: bold;");
-
-  await test("GM_addElement", () => {
-    const element = GM_addElement("div", {
-      textContent: "GM_addElement测试元素",
-      style: "display:none;",
-      id: "gm-test-element",
-    });
-    assertTrue(element !== null && element !== undefined, "GM_addElement应该返回元素");
-    assert("gm-test-element", element.id, "元素ID应该正确");
-    assert("DIV", element.tagName, "元素标签应该是DIV");
-    console.log("返回元素:", element);
-  });
-
-  await test("GM_addStyle", () => {
-    const styleElement = GM_addStyle(`
-            .gm-style-test {
-                color: #10b981 !important;
-            }
-        `);
-    assertTrue(styleElement !== null && styleElement !== undefined, "GM_addStyle应该返回样式元素");
-    assertTrue(styleElement.tagName === "STYLE" || styleElement.sheet, "应该返回STYLE元素或样式对象");
-    console.log("返回样式元素:", styleElement);
-  });
-
   // ============ GM_log 测试 ============
   console.log("\n%c--- GM_log 测试 ---", "color: orange; font-weight: bold;");
 
   await test("GM_log", () => {
-    GM_log("测试日志输出", { type: "test", value: 123 });
+    GM_log("测试日志输出", "info", { type: "test", value: 123 });
     // GM_log本身不返回值,只要不抛出异常就算成功
     assertTrue(true, "GM_log应该能正常输出");
   });

example/tests/inject_content_test.js

@@ -99,7 +99,7 @@
   console.log("\n%c--- GM_log 测试 ---", "color: orange; font-weight: bold;");
 
   await test("GM_log", () => {
-    GM_log("测试日志输出", { type: "test", value: 123 });
+    GM_log("测试日志输出", "info", { type: "test", value: 123 });
     // GM_log本身不返回值,只要不抛出异常就算成功
     assertTrue(true, "GM_log应该能正常输出");
   });