✨ 添加 GM_audio 与 GM.audio 支持 (TM)

packages/message/server.test.ts

@@ -489,6 +489,12 @@ describe("Server", () => {
       expect(extSender.documentId).toBe("doc-123");
     });
 
+    it.concurrent("应该保留合法的 tabId 0，而不是当作后台上下文", async () => {
+      const sender = new SenderRuntime({ tab: { id: 0, windowId: 0 } } as RuntimeMessageSender);
+
+      expect(sender.getExtMessageSender()).toMatchObject({ tabId: 0, windowId: 0 });
+    });
+
     it.concurrent("应该为没有 tab 的 sender 返回 -1 tabId", async () => {
       let capturedSender: IGetSender;
 

packages/message/server.ts

@@ -47,8 +47,8 @@ export class SenderConnect {
     if (this.sender instanceof ExtensionMessageConnect) {
       const con = this.sender.getPort();
       return {
-        windowId: con.sender?.tab?.windowId || -1, // -1表示后台脚本
-        tabId: con.sender?.tab?.id || -1, // -1表示后台脚本
+        windowId: con.sender?.tab?.windowId ?? -1, // -1表示后台脚本
+        tabId: con.sender?.tab?.id ?? -1, // -1表示后台脚本
         frameId: con.sender?.frameId,
         documentId: con.sender?.documentId,
       };
@@ -97,8 +97,8 @@ export class SenderRuntime {
       };
     }
     return {
-      windowId: sender.tab?.windowId || -1, // -1表示后台脚本
-      tabId: sender.tab?.id || -1, // -1表示后台脚本
+      windowId: sender.tab?.windowId ?? -1, // -1表示后台脚本
+      tabId: sender.tab?.id ?? -1, // -1表示后台脚本
       frameId: sender.frameId,
       documentId: sender.documentId,
     };

src/app/service/content/create_context.test.ts

@@ -102,6 +102,22 @@ describe.concurrent("createContext", () => {
     expect(context.GM_cookie.delete.name).toBe("bound GM_cookie.delete");
   });
 
+  it.concurrent("按 @grant 注入 GM_audio 与 GM.audio 的完整方法", () => {
+    const legacyContext = createTestContext(["GM_audio"]);
+    const promiseContext = createTestContext(["GM.audio"]);
+
+    for (const context of [legacyContext, promiseContext]) {
+      expect(context.GM_audio.setMute.name).toBe("bound GM_audio.setMute");
+      expect(context.GM_audio.getState.name).toBe("bound GM_audio.getState");
+      expect(context.GM_audio.addStateChangeListener.name).toBe("bound GM_audio.addStateChangeListener");
+      expect(context.GM_audio.removeStateChangeListener.name).toBe("bound GM_audio.removeStateChangeListener");
+      expect(context.GM.audio.setMute.name).toBe("bound GM.audio.setMute");
+      expect(context.GM.audio.getState.name).toBe("bound GM.audio.getState");
+      expect(context.GM.audio.addStateChangeListener.name).toBe("bound GM.audio.addStateChangeListener");
+      expect(context.GM.audio.removeStateChangeListener.name).toBe("bound GM.audio.removeStateChangeListener");
+    }
+  });
+
   it.concurrent("window grant 先挂到 context.window，再由代理沙盒暴露为 window 方法", () => {
     const context = createTestContext(["window.close", "window.focus"]);
     const sandbox = createProxyContext(context);
@@ -178,6 +194,33 @@ describe.concurrent("createContext", () => {
     });
     expect(listener).toHaveBeenCalledTimes(1);
   });
+
+  it.concurrent("音频注册尚未返回连接时上下文失效也应立即结算注册", async () => {
+    let resolveConnection!: (connection: unknown) => void;
+    const message = {
+      connect: vi.fn(
+        () =>
+          new Promise((resolve) => {
+            resolveConnection = resolve;
+          })
+      ),
+    } as any;
+    const context = createContext(createScriptInfo(), {}, "vitest", message, message, new Set(["GM.audio"]));
+    const registration = context.GM.audio.addStateChangeListener(vi.fn());
+
+    context.setInvalidContext();
+    await expect(
+      Promise.race([
+        registration.then(
+          () => "resolved",
+          (error: unknown) => `rejected:${String(error)}`
+        ),
+        new Promise<string>((resolve) => setTimeout(() => resolve("timeout"), 0)),
+      ])
+    ).resolves.toBe("resolved");
+
+    resolveConnection({ disconnect: vi.fn() });
+  });
 });
 
 describe.concurrent("createProxyContext", () => {

src/app/service/content/create_context.ts

@@ -52,6 +52,11 @@ export const createContext = (
     setInvalidContext() {
       if (invalid) return;
       invalid = true;
+      const audioState = this.audioStateChange;
+      audioState?.settleRegistration?.();
+      audioState?.connection?.disconnect(true);
+      audioState?.listeners.clear();
+      this.audioStateChange = undefined;
       this.valueChangeListener.clear();
       this.EE.removeAllListeners();
       this.runFlag = `${uuidv4()}(invalid)`; // 更改 uuid 防止 runFlag 相关操作