✅ 补 extensionEnv / BgExecScriptWarp / sandbox run-in 单元测试

- extension_env.test.ts：覆盖 getExtensionUserAgentData 的 navigator 缺失、platformInfo 异常、bitness 64/32 派生
- exec_warp.test.ts：覆盖 BgExecScriptWarp 把 extensionEnv 注入 GM_info 的各分支
- sandbox/runtime.test.ts：覆盖 execScript 中 run-in × inIncognitoContext 的过滤逻辑（含 extensionEnv 为 undefined 的 fail-open 行为）

Author: CodFrm

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

@@ -0,0 +1,87 @@
+import { describe, expect, it } from "vitest";
+import { BgExecScriptWarp } from "./exec_warp";
+import type { ScriptLoadInfo } from "../service_worker/types";
+import type { Message } from "@Packages/message/types";
+import type { TExtensionEnv } from "../extension/extension_env";
+
+const buildScriptRes = () =>
+  ({
+    uuid: "uuid-bg",
+    name: "bg-script",
+    metadata: {
+      grant: ["none"],
+      version: ["1.0.0"],
+    },
+    code: "return GM_info;",
+    sourceCode: "return GM_info;",
+    value: {},
+  }) as unknown as ScriptLoadInfo;
+
+const fakeMessage = undefined as unknown as Message;
+
+const getGMInfo = (exec: BgExecScriptWarp) => (exec as any).named?.GM_info;
+
+describe("BgExecScriptWarp envInfo 注入", () => {
+  it("extensionEnv 为 undefined 时使用默认值", () => {
+    const exec = new BgExecScriptWarp(buildScriptRes(), fakeMessage, undefined);
+    const gmInfo = getGMInfo(exec);
+    expect(gmInfo.isIncognito).toBe(false);
+    expect(gmInfo.userAgentData).toEqual({
+      brands: [],
+      mobile: false,
+      platform: "",
+    });
+    expect(gmInfo.sandboxMode).toBe("raw");
+  });
+
+  it("inIncognitoContext=true 时覆盖 isIncognito 为 true", () => {
+    const extensionEnv: TExtensionEnv = { inIncognitoContext: true };
+    const exec = new BgExecScriptWarp(buildScriptRes(), fakeMessage, extensionEnv);
+    const gmInfo = getGMInfo(exec);
+    expect(gmInfo.isIncognito).toBe(true);
+    // 没传 userAgentData，沿用默认空值
+    expect(gmInfo.userAgentData).toEqual({
+      brands: [],
+      mobile: false,
+      platform: "",
+    });
+  });
+
+  it("传入完整 userAgentData 时整体替换默认值", () => {
+    const extensionEnv: TExtensionEnv = {
+      inIncognitoContext: false,
+      userAgentData: {
+        brands: [{ brand: "Chromium", version: "120" }],
+        mobile: true,
+        platform: "Android",
+        architecture: "arm",
+        bitness: "64",
+      } as any,
+    };
+    const exec = new BgExecScriptWarp(buildScriptRes(), fakeMessage, extensionEnv);
+    const gmInfo = getGMInfo(exec);
+    expect(gmInfo.isIncognito).toBe(false);
+    expect(gmInfo.userAgentData).toEqual({
+      brands: [{ brand: "Chromium", version: "120" }],
+      mobile: true,
+      platform: "Android",
+      architecture: "arm",
+      bitness: "64",
+    });
+  });
+
+  it("userAgentData 为 null 时保留默认值", () => {
+    const extensionEnv: TExtensionEnv = {
+      inIncognitoContext: true,
+      userAgentData: null,
+    };
+    const exec = new BgExecScriptWarp(buildScriptRes(), fakeMessage, extensionEnv);
+    const gmInfo = getGMInfo(exec);
+    expect(gmInfo.isIncognito).toBe(true);
+    expect(gmInfo.userAgentData).toEqual({
+      brands: [],
+      mobile: false,
+      platform: "",
+    });
+  });
+});

src/app/service/extension/extension_env.test.ts

@@ -0,0 +1,113 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { extensionEnv, getExtensionUserAgentData } from "./extension_env";
+
+describe("extensionEnv 常量", () => {
+  it("从 chrome.extension.inIncognitoContext 读取 incognito 状态", () => {
+    // mock 默认 inIncognitoContext = false
+    expect(extensionEnv.inIncognitoContext).toBe(false);
+    // userAgentData 为可选字段，常量初始化时不应填充
+    expect(extensionEnv.userAgentData).toBeUndefined();
+  });
+});
+
+describe("getExtensionUserAgentData", () => {
+  const originalUserAgentData = (navigator as any).userAgentData;
+  const originalGetPlatformInfo = chrome.runtime.getPlatformInfo;
+
+  const setNavigatorUserAgentData = (value: any) => {
+    Object.defineProperty(navigator, "userAgentData", {
+      configurable: true,
+      get: () => value,
+    });
+  };
+
+  afterEach(() => {
+    setNavigatorUserAgentData(originalUserAgentData);
+    if (originalGetPlatformInfo === undefined) {
+      // @ts-ignore
+      delete chrome.runtime.getPlatformInfo;
+    } else {
+      chrome.runtime.getPlatformInfo = originalGetPlatformInfo;
+    }
+    vi.restoreAllMocks();
+  });
+
+  it("navigator.userAgentData 缺失时返回 null", async () => {
+    setNavigatorUserAgentData(undefined);
+    const result = await getExtensionUserAgentData();
+    expect(result).toBeNull();
+  });
+
+  it("没有 chrome.runtime.getPlatformInfo 时只返回基础字段", async () => {
+    setNavigatorUserAgentData({
+      brands: [{ brand: "Chromium", version: "120" }],
+      mobile: false,
+      platform: "macOS",
+    });
+    // @ts-ignore
+    delete chrome.runtime.getPlatformInfo;
+
+    const result = await getExtensionUserAgentData();
+    expect(result).toEqual({
+      brands: [{ brand: "Chromium", version: "120" }],
+      mobile: false,
+      platform: "macOS",
+    });
+    expect((result as any).architecture).toBeUndefined();
+    expect((result as any).bitness).toBeUndefined();
+  });
+
+  it("getPlatformInfo 返回 x86-64 时 bitness 为 64", async () => {
+    setNavigatorUserAgentData({
+      brands: [],
+      mobile: false,
+      platform: "Linux",
+    });
+    chrome.runtime.getPlatformInfo = vi.fn().mockResolvedValue({
+      os: "linux",
+      arch: "x86-64",
+      nacl_arch: "x86-64",
+    }) as any;
+
+    const result = await getExtensionUserAgentData();
+    expect(result?.architecture).toBe("x86-64");
+    expect(result?.bitness).toBe("64");
+  });
+
+  it("getPlatformInfo 返回 x86-32 时 bitness 为 32", async () => {
+    setNavigatorUserAgentData({
+      brands: [],
+      mobile: false,
+      platform: "Windows",
+    });
+    chrome.runtime.getPlatformInfo = vi.fn().mockResolvedValue({
+      os: "win",
+      arch: "x86-32",
+      nacl_arch: "x86-32",
+    }) as any;
+
+    const result = await getExtensionUserAgentData();
+    expect(result?.architecture).toBe("x86-32");
+    expect(result?.bitness).toBe("32");
+  });
+
+  it("getPlatformInfo 抛异常时降级返回基础字段", async () => {
+    setNavigatorUserAgentData({
+      brands: [{ brand: "Chromium", version: "120" }],
+      mobile: false,
+      platform: "Android",
+    });
+    chrome.runtime.getPlatformInfo = vi.fn().mockRejectedValue(new Error("API not available")) as any;
+    const warnSpy = vi.spyOn(console, "warn").mockImplementation(() => {});
+
+    const result = await getExtensionUserAgentData();
+    expect(result).toEqual({
+      brands: [{ brand: "Chromium", version: "120" }],
+      mobile: false,
+      platform: "Android",
+    });
+    expect((result as any).architecture).toBeUndefined();
+    expect((result as any).bitness).toBeUndefined();
+    expect(warnSpy).toHaveBeenCalled();
+  });
+});

src/app/service/sandbox/runtime.test.ts

@@ -0,0 +1,110 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { initTestEnv } from "@Tests/utils";
+import type { Server } from "@Packages/message/server";
+import type { WindowMessage } from "@Packages/message/window_message";
+import type { ScriptLoadInfo } from "../service_worker/types";
+import type { TExtensionEnv } from "../extension/extension_env";
+
+// 单测重点：sandbox runtime.execScript 中新加的 run-in 过滤逻辑
+// 通过 mock BgExecScriptWarp 与 offscreen client，观察是否构造执行实例来判断过滤是否生效
+const mockExec = vi.fn().mockResolvedValue(undefined);
+const mockStop = vi.fn();
+const BgExecScriptWarpCtor = vi.fn().mockImplementation(() => ({
+  exec: mockExec,
+  stop: mockStop,
+  scriptRes: { uuid: "uuid-bg" },
+  valueUpdate: vi.fn(),
+  emitEvent: vi.fn(),
+}));
+
+vi.mock("../content/exec_warp", () => ({
+  BgExecScriptWarp: function (...args: any[]) {
+    return BgExecScriptWarpCtor(...args);
+  },
+  CATRetryError: class CATRetryError {},
+}));
+
+vi.mock("../offscreen/client", () => ({
+  proxyUpdateRunStatus: vi.fn(),
+}));
+
+import { Runtime } from "./runtime";
+
+initTestEnv();
+
+const buildScript = (runIn?: string): ScriptLoadInfo =>
+  ({
+    uuid: `uuid-${runIn ?? "none"}`,
+    name: "bg",
+    type: 2,
+    code: "",
+    sourceCode: "",
+    metadata: runIn ? { "run-in": [runIn] } : {},
+    metadataStr: "",
+    userConfig: {},
+    userConfigStr: "",
+    value: {},
+    resource: {},
+  }) as unknown as ScriptLoadInfo;
+
+const setup = (extensionEnv: TExtensionEnv | undefined) => {
+  const windowMessage = {} as WindowMessage;
+  const api = {} as Server;
+  return new Runtime(windowMessage, api, Promise.resolve(extensionEnv));
+};
+
+describe("Runtime.execScript run-in 过滤", () => {
+  beforeEach(() => {
+    BgExecScriptWarpCtor.mockClear();
+    mockExec.mockClear();
+    mockStop.mockClear();
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it("metadata 没有 run-in 时无论 incognito 状态都执行", async () => {
+    const runtime = setup({ inIncognitoContext: false });
+    await runtime.execScript(buildScript());
+    expect(BgExecScriptWarpCtor).toHaveBeenCalledTimes(1);
+  });
+
+  it('run-in === "all" 时无论 incognito 状态都执行', async () => {
+    const runtime = setup({ inIncognitoContext: true });
+    await runtime.execScript(buildScript("all"));
+    expect(BgExecScriptWarpCtor).toHaveBeenCalledTimes(1);
+  });
+
+  it('run-in === "normal-tabs" 在普通环境中执行', async () => {
+    const runtime = setup({ inIncognitoContext: false });
+    await runtime.execScript(buildScript("normal-tabs"));
+    expect(BgExecScriptWarpCtor).toHaveBeenCalledTimes(1);
+  });
+
+  it('run-in === "normal-tabs" 在隐身环境中跳过执行', async () => {
+    const runtime = setup({ inIncognitoContext: true });
+    await runtime.execScript(buildScript("normal-tabs"));
+    expect(BgExecScriptWarpCtor).not.toHaveBeenCalled();
+  });
+
+  it('run-in === "incognito-tabs" 在普通环境中跳过执行', async () => {
+    const runtime = setup({ inIncognitoContext: false });
+    await runtime.execScript(buildScript("incognito-tabs"));
+    expect(BgExecScriptWarpCtor).not.toHaveBeenCalled();
+  });
+
+  it('run-in === "incognito-tabs" 在隐身环境中执行', async () => {
+    const runtime = setup({ inIncognitoContext: true });
+    await runtime.execScript(buildScript("incognito-tabs"));
+    expect(BgExecScriptWarpCtor).toHaveBeenCalledTimes(1);
+  });
+
+  it("extensionEnv 为 undefined 时，过滤被跳过照常执行（fail-open）", async () => {
+    // 当前实现：拿不到 incognito 状态时不做过滤，避免静默丢失任务
+    const runtime = setup(undefined);
+    await runtime.execScript(buildScript("incognito-tabs"));
+    expect(BgExecScriptWarpCtor).toHaveBeenCalledTimes(1);
+  });
+});