Function run

e2e/desktop-vm/artifact-external-link.test.ts:97–152

(runDir: string)

};

const run = async (runDir: string) => {
  const cdp = await CdpPage.connect(await pageWsUrl(Number(cdpPort)));
  try {
    await cdp.command("Runtime.enable");
    await cdp.command("Page.enable");

    // Film the guest while we drive it, so the recording shows the browser
    // coming to the front when the link opens.
    const recording = recordGuestScreen(
      guestIp as string,
      recSeconds,
      join(runDir, "session.mp4"),
      os,
    );

    // Wait for the console to load before we do anything with it.
    await cdp.waitForText("Integrations", 60_000).catch(() => cdp.waitForText("Settings", 60_000));

    const hostAddress = await hostAddressFromGuest(guestIp as string);
    expect(hostAddress, "the guest reported the host address it routes through").toMatch(
      /^\d+\.\d+\.\d+\.\d+$/,
    );

    const probe = await listenForOpen(hostAddress);
    try {
      const pagesBefore = await pageTargetCount();

      // The same call the console makes when a `target="_blank"` link is
      // clicked (see packages/react/src/api/shell-host.ts). We run it directly
      // here — the click-to-open path is already covered by the cloud e2e, and
      // what we care about on desktop is what Electron does with this call.
      await cdp.command("Runtime.evaluate", {
        expression: `window.open(${JSON.stringify(probe.url)}, "_blank", "noopener,noreferrer")`,
      });

      const fetcherUserAgent = await probe.waitForOpen(15_000);
      await sleep(1500);
      const pagesAfter = await pageTargetCount();

      writeFileSync(join(runDir, "01-link-opened-externally.png"), await cdp.screenshot());

      expect(fetcherUserAgent, "the desktop handed the link to the system browser").not.toBeNull();
      expect(
        fetcherUserAgent ?? "",
        "the OS browser fetched the link, not an in-app Electron window",
      ).not.toContain("Electron");
      expect(pagesAfter, "the app opened no in-app browser window for the link").toBe(pagesBefore);
    } finally {
      probe.close();
    }

    await recording;
  } finally {
    cdp.close();
  }
};

if (!cdpPort || !guestIp || os === "windows") {