兼容 Firefox MV3 规格

e2e/gm-api.spec.ts

@@ -130,10 +130,10 @@ async function runTestScript(
     page.on("console", (msg) => {
       const text = msg.text();
       logs.push(text);
-      const passMatch = text.match(/通过[:：]\s*(\d+)/);
-      const failMatch = text.match(/失败[:：]\s*(\d+)/);
-      if (passMatch) passed = parseInt(passMatch[1], 10);
-      if (failMatch) failed = parseInt(failMatch[1], 10);
+      const passMatch = text.match(/(通过|Passed)[:：]\s*(\d+)/);
+      const failMatch = text.match(/(失败|Failed)[:：]\s*(\d+)/);
+      if (passMatch) passed = parseInt(passMatch[2], 10);
+      if (failMatch) failed = parseInt(failMatch[2], 10);
       if (passed >= 0 && failed >= 0) resolve();
     });
   });
@@ -152,12 +152,18 @@ test.describe("GM API", () => {
   // Two-phase launch + script install + network fetches + permission dialogs
   test.setTimeout(300_000);
 
-  test("GM_ sync API tests (gm_api_test.js)", async ({ context, extensionId }) => {
-    const { passed, failed, logs } = await runTestScript(context, extensionId, "gm_api_test.js", TARGET_URL, 90_000);
+  test("GM_ sync API tests (gm_api_sync_test.js)", async ({ context, extensionId }) => {
+    const { passed, failed, logs } = await runTestScript(
+      context,
+      extensionId,
+      "gm_api_sync_test.js",
+      `${TARGET_URL}?gm_api_sync`,
+      90_000
+    );
 
-    console.log(`[gm_api_test] passed=${passed}, failed=${failed}`);
+    console.log(`[gm_api_sync_test] passed=${passed}, failed=${failed}`);
     if (failed !== 0) {
-      console.log("[gm_api_test] logs:", logs.join("\n"));
+      console.log("[gm_api_sync_test] logs:", logs.join("\n"));
     }
     expect(failed, "Some GM_ sync API tests failed").toBe(0);
     expect(passed, "No test results found - script may not have run").toBeGreaterThan(0);
@@ -168,7 +174,7 @@ test.describe("GM API", () => {
       context,
       extensionId,
       "gm_api_async_test.js",
-      TARGET_URL,
+      `${TARGET_URL}?gm_api_async`,
       90_000
     );
 
@@ -185,7 +191,7 @@ test.describe("GM API", () => {
       context,
       extensionId,
       "inject_content_test.js",
-      TARGET_URL,
+      `${TARGET_URL}?inject_content`,
       60_000
     );
 
@@ -196,4 +202,21 @@ test.describe("GM API", () => {
     expect(failed, "Some content inject tests failed").toBe(0);
     expect(passed, "No test results found - script may not have run").toBeGreaterThan(0);
   });
+
+  test("WindowMessage Transport Test (window_message_test.js)", async ({ context, extensionId }) => {
+    const { passed, failed, logs } = await runTestScript(
+      context,
+      extensionId,
+      "window_message_test.js",
+      `${TARGET_URL}?WINDOW_MESSAGE_TEST_SC`,
+      8_000
+    );
+
+    console.log(`[window_message_test] passed=${passed}, failed=${failed}`);
+    if (failed !== 0) {
+      console.log("[window_message_test] logs:", logs.join("\n"));
+    }
+    expect(failed, "Some tests failed").toBe(0);
+    expect(passed, "No test results found - script may not have run").toBeGreaterThan(0);
+  });
 });

example/tests/early_inject_content_test.js

@@ -1,9 +1,9 @@
 // ==UserScript==
-// @name         早期脚本 注入到 content环境测试
+// @name         Early-start Test (content 环境)
 // @namespace    https://docs.scriptcat.org/
 // @version      0.1.0
-// @description  早期脚本可以比页面更早到执行
-// @match        https://content-security-policy.com/
+// @description  early-start 可以比 document-start 更早执行
+// @match        https://content-security-policy.com/?early_inject_content
 // @inject-into  content
 // @early-start
 // @grant        GM_addElement

example/tests/early_test.js → example/tests/early_inject_page_test.js

@@ -1,9 +1,9 @@
 // ==UserScript==
-// @name         早期脚本
+// @name         Early-start Test (page 环境)
 // @namespace    https://docs.scriptcat.org/
 // @version      0.1.0
-// @description  早期脚本可以比页面更早到执行
-// @match        https://content-security-policy.com/
+// @description  early-start 可以比 document-start 更早执行
+// @match        https://content-security-policy.com/?early_inject_page
 // @early-start
 // @grant        GM_addElement
 // @grant        GM_addStyle

example/tests/gm_api_async_test.js

@@ -4,7 +4,7 @@
 // @version      1.0.0
 // @description  全面测试ScriptCat的所有GM.* (异步Promise版本) API功能
 // @author       ScriptCat
-// @match        https://content-security-policy.com/
+// @match        https://content-security-policy.com/?gm_api_async
 // @grant        GM.getValue
 // @grant        GM.setValue
 // @grant        GM.deleteValue

example/tests/gm_api_test.js → example/tests/gm_api_sync_test.js

@@ -1,10 +1,10 @@
 // ==UserScript==
-// @name         GM API 完整测试
+// @name         GM API 完整测试 (同步版本)
 // @namespace    https://docs.scriptcat.org/
 // @version      1.1.0
 // @description  全面测试ScriptCat的所有GM API功能
 // @author       ScriptCat
-// @match        https://content-security-policy.com/
+// @match        https://content-security-policy.com/?gm_api_sync
 // @grant        GM_getValue
 // @grant        GM_setValue
 // @grant        GM_deleteValue

example/tests/gm_xhr_redirect_test.js

@@ -0,0 +1,244 @@
+// ==UserScript==
+// @name         xhr_redirect_test
+// @namespace    tm-gmxhr-test
+// @version      0.1.0
+// @description  Comprehensive in-page tests for GM_xmlhttpRequest: normal, abnormal, and edge cases with clear pass/fail output.
+// @author       you
+// @match        *://*/*?GM_XHR_REDIRECT_TEST_SC
+// @grant        GM_xmlhttpRequest
+// @connect      httpbun.com
+// @noframes
+// ==/UserScript==
+
+const enableTool = true;
+(function () {
+  "use strict";
+  if (!enableTool) return;
+
+  // ---------- Panel ----------
+
+  const panel = document.createElement("div");
+  panel.id = "gmxhr-test-panel";
+  panel.innerHTML = `
+    <style>
+      #gmxhr-test-panel {
+        position:fixed; bottom:12px; right:12px; width:460px; max-height:70vh;
+        overflow:auto; z-index:2147483647; background:#111; color:#f5f5f5;
+        font:13px/1.4 system-ui,-apple-system,Segoe UI,Roboto,sans-serif;
+        border-radius:10px; box-shadow:0 12px 30px rgba(0,0,0,.4); border:1px solid #333;
+      }
+      #gmxhr-test-panel .hdr {
+        position:sticky; top:0; background:#181818; padding:10px 12px;
+        border-bottom:1px solid #333; display:flex; align-items:center; gap:8px;
+      }
+      #gmxhr-test-panel .hdr-info { flex:1 }
+      #gmxhr-test-panel button {
+        background:#2a6df1; color:#fff; border:0; padding:6px 10px;
+        border-radius:6px; cursor:pointer;
+      }
+      #gmxhr-test-panel #status { padding:6px 12px; border-bottom:1px solid #222; opacity:.9 }
+      #gmxhr-test-panel #log { padding:10px 12px }
+      #gmxhr-test-panel #log > div { padding:6px 0; border-bottom:1px dashed #2a2a2a }
+      #gmxhr-test-panel pre { white-space:pre-wrap; color:#bbb; margin:.5em 0 0 }
+    </style>
+    <div class="hdr">
+      <div class="hdr-info">
+        <div style="font-weight:500">GM_xmlhttpRequest Test Harness <span id="ver"></span></div>
+        <div style="display:flex"><span id="handler"></span><span id="counts" style="margin-left:auto;opacity:.8">…</span></div>
+      </div>
+      <button id="start">Run</button>
+      <button id="clear">Clear</button>
+    </div>
+    <div id="status">Status: idle</div>
+    <div id="log"></div>
+  `;
+  document.documentElement.append(panel);
+
+  panel.querySelector("#ver").textContent = GM.info?.script?.version ?? "";
+  panel.querySelector("#handler").textContent = `${GM.info?.scriptHandler} ${GM.info?.version}`;
+
+  const $log     = panel.querySelector("#log");
+  const $counts  = panel.querySelector("#counts");
+  const $status  = panel.querySelector("#status");
+
+  panel.querySelector("#clear").addEventListener("click", () => {
+    $log.textContent = "";
+    setCounts(0, 0, 0);
+    $status.textContent = "Status: idle";
+  });
+  panel.querySelector("#start").addEventListener("click", runAll);
+
+  function logLine(html) {
+    const el = document.createElement("div");
+    el.innerHTML = html;
+    $log.prepend(el);
+  }
+
+  function escapeHtml(s) {
+    return String(s).replace(/[&<>"']/g, m =>
+      ({ "&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;" })[m]);
+  }
+
+  const state = { pass: 0, fail: 0, skip: 0 };
+  function setCounts(p, f, s) { $counts.textContent = `✅ ${p}  ❌ ${f}  ⏳ ${s}`; }
+  function pass(msg) { state.pass++; setCounts(state.pass, state.fail, state.skip); logLine(`✅ ${escapeHtml(msg)}`); }
+  function fail(msg, extra) {
+    state.fail++; setCounts(state.pass, state.fail, state.skip);
+    logLine(`❌ ${escapeHtml(msg)}${extra ? `<pre>${escapeHtml(extra)}</pre>` : ""}`);
+  }
+  function skip(msg) { state.skip++; setCounts(state.pass, state.fail, state.skip); logLine(`⏭️ ${escapeHtml(msg)}`); }
+
+  // ---------- Request helper ----------
+  function gmRequest(details, { abortAfterMs } = {}) {
+    return new Promise((resolve, reject) => {
+      const t0 = performance.now();
+      const req = GM_xmlhttpRequest({
+        ...details,
+        onload:    res => resolve({ kind: "load",    res, ms: performance.now() - t0 }),
+        onerror:   res => reject ({ kind: "error",   res, ms: performance.now() - t0 }),
+        ontimeout: res => reject ({ kind: "timeout", res, ms: performance.now() - t0 }),
+        onabort:   res => reject ({ kind: "abort",   res, ms: performance.now() - t0 }),
+        onprogress: details.onprogress,
+      });
+      if (abortAfterMs != null) setTimeout(() => { try { req.abort(); } catch (_) {} }, abortAfterMs);
+    });
+  }
+
+  const HB = "https://httpbun.com";
+
+  // ---------- Assertion utils ----------
+  function assertEq(a, b, msg) {
+    if (a !== b) throw new Error(msg ? `${msg}: expected ${b}, got ${a}` : `expected ${b}, got ${a}`);
+  }
+
+  function objectProps(o) {
+    if (!o || typeof o !== "object") return "not an object";
+    let z, oD, zD;
+    try { z = Object.assign({}, o); } catch { return "Object.assign failed"; }
+    if (typeof (z.response    ?? "") !== "string") return "non-primitive response value exposed";
+    if (typeof (z.responseText ?? "") !== "string") return "non-primitive responseText value exposed";
+    if (typeof (z.responseXML  ?? "") !== "string") return "non-primitive responseXML value exposed";
+    try { oD = JSON.stringify(o); } catch { return "JSON.stringify failed"; }
+    try { zD = JSON.stringify(z); } catch { return "JSON.stringify failed"; }
+    if (oD !== zD) return "Object Props Failed";
+    return "ok";
+  }
+
+  // ---------- Tests ----------
+  const basicTests = [
+    {
+      name: 'GET basic with search params 1',
+      async run(fetch) {
+        const { res } = await gmRequest({ method: "GET", url: `${HB}/get?testing=234&abc=567`, responseType: "json", fetch });
+        assertEq(res.status, 200, "status 200");
+        assertEq(res.response?.args?.testing, "234", "response ok");
+        assertEq(res.response?.args?.abc, "567", "response ok");
+        assertEq(res.response?.url, `${HB}/get?testing=234&abc=567`, "response ok");
+        assertEq(objectProps(res), "ok", "Object Props OK");
+      },
+    },
+    {
+      name: 'GET basic with search params 2',
+      async run(fetch) {
+        const { res } = await gmRequest({ method: "GET", url: `${HB}/get?abc=567&testing=234`, responseType: "json", fetch });
+        assertEq(res.status, 200, "status 200");
+        assertEq(res.response?.args?.testing, "234", "response ok");
+        assertEq(res.response?.args?.abc, "567", "response ok");
+        assertEq(res.response?.url, `${HB}/get?abc=567&testing=234`, "response ok");
+        assertEq(objectProps(res), "ok", "Object Props OK");
+      },
+    },
+    {
+      name: "Redirect handling (finalUrl changes) [default]",
+      async run(fetch) {
+        const target = `${HB}/get?z=92`;
+        const { res } = await gmRequest({ method: "GET", url: `${HB}/redirect-to?url=${encodeURIComponent(target)}`, fetch });
+        assertEq(res.status, 200, "status after redirect is 200");
+        assertEq(res.finalUrl, target, "finalUrl is redirected target");
+        assertEq(objectProps(res), "ok", "Object Props OK");
+      },
+    },
+    {
+      name: "Redirect handling (finalUrl changes) [follow]",
+      async run(fetch) {
+        const target = `${HB}/get?z=94`;
+        const { res } = await gmRequest({ method: "GET", url: `${HB}/redirect-to?url=${encodeURIComponent(target)}`, redirect: "follow", fetch });
+        assertEq(res.status, 200, "status after redirect is 200");
+        assertEq(res.finalUrl, target, "finalUrl is redirected target");
+        assertEq(objectProps(res), "ok", "Object Props OK");
+      },
+    },
+    {
+      name: "Redirect handling (finalUrl changes) [error]",
+      async run(fetch) {
+        try {
+          await Promise.race([
+            gmRequest({ method: "GET", url: `${HB}/redirect-to?url=${encodeURIComponent(`${HB}/get?z=96`)}`, redirect: "error", fetch }),
+            new Promise(resolve => setTimeout(resolve, 4000)),
+          ]);
+          throw new Error("Expected error, got load");
+        } catch (e) {
+          assertEq(e?.kind, "error", "error ok");
+          assertEq(e?.res?.status, 408, "statusCode ok");
+          assertEq(!e?.res?.finalUrl, true, "!finalUrl ok");
+          assertEq(e?.res?.responseHeaders, "", "responseHeaders ok");
+          assertEq(objectProps(e?.res), "ok", "Object Props OK");
+        }
+      },
+    },
+    {
+      name: "Redirect handling (finalUrl changes) [manual]",
+      async run(fetch) {
+        const url = `${HB}/redirect-to?url=${encodeURIComponent(`${HB}/get?z=98`)}`;
+        const { res } = await Promise.race([
+          gmRequest({ method: "GET", url, redirect: "manual", fetch }),
+          new Promise(resolve => setTimeout(resolve, 4000)),
+        ]);
+        assertEq(res?.status, 301, "status is 301");
+        assertEq(res?.finalUrl, url, "finalUrl is original url");
+        assertEq(typeof res?.responseHeaders === "string" && res?.responseHeaders !== "", true, "responseHeaders ok");
+        assertEq(objectProps(res), "ok", "Object Props OK");
+      },
+    },
+  ];
+
+  const tests = [
+    ...basicTests,
+    ...basicTests.map(t => ({ ...t, useFetch: true })),
+  ];
+
+  // ---------- Runner ----------
+  function fmtMs(ms) { return ms < 1000 ? `${ms | 0}ms` : `${(ms / 1000).toFixed(2)}s`; }
+
+  async function runAll() {
+    state.pass = state.fail = state.skip = 0;
+    setCounts(0, 0, 0);
+    logLine(`<b>Starting GM_xmlhttpRequest test suite</b> — ${new Date().toLocaleString()}`);
+
+    for (let i = 0; i < tests.length; i++) {
+      const t = tests[i];
+      const tName = `${t.useFetch ? "[fetch]" : "[xhr]"} ${t.name}`;
+      $status.textContent = `Status: running (${i + 1}/${tests.length}): ${tName}`;
+      logLine(`▶️ <b>${escapeHtml(tName)}</b>`);
+      const t0 = performance.now();
+      try {
+        await t.run(t.useFetch ? true : false);
+        pass(`• ${tName}  (${fmtMs(performance.now() - t0)})`);
+      } catch (e) {
+        console.error(e);
+        const stack = e?.stack ? e.stack.split("\n").slice(0, 4).join("\n") : null;
+        fail(`• ${tName}  (${fmtMs(performance.now() - t0)})`, [e?.message, stack].filter(Boolean).join("\n"));
+      }
+    }
+
+    $status.textContent = "Status: done";
+    logLine(`<b>Done.</b> ✅ ${state.pass}  ❌ ${state.fail}  ⏳ ${state.skip}`);
+  }
+
+  setTimeout(() => {
+    if (!window.__gmxhr_test_autorun__) {
+      window.__gmxhr_test_autorun__ = true;
+      runAll();
+    }
+  }, 600);
+})();