Function createProviderTests

browser/_test-utils/src/factory.ts:194–325

(factory: BrowserFactory)

 * Call this from each provider's test file.
 */
export function createProviderTests(factory: BrowserFactory) {
  const configs = getActiveConfigs();

  describe(`${factory.name} profile lifecycle`, () => {
    afterEach(() => sleep(500));

    for (const config of configs) {
      describe(configLabel(config), () => {
        it('programmatic close — process exits, cleans up', async () => {
          const profileDir = config.profile ? mkdtempSync(join(tmpdir(), 'browser-test-')) : undefined;
          let browser: MastraBrowser | undefined;

          try {
            // Seed a Preferences file with exit_type: Crashed.
            // Chrome only creates this after extended use (e.g. logging in),
            // so short-lived test sessions never trigger it organically.
            // Seeding it lets us verify that close() patches it to Normal.
            if (profileDir) {
              seedCrashedPreferences(profileDir);
            }

            browser = factory.create({
              profile: profileDir,
              scope: config.scope,
              headless: config.headless,
            });

            if (config.scope === 'thread') {
              browser.setCurrentThread(THREAD_ID);
            }

            await browser.ensureReady();
            await factory.navigate(browser, TEST_URL, config.scope === 'thread' ? THREAD_ID : undefined);

            // Get the PID we spawned
            const pid = await factory.getPid(browser, config.scope === 'thread' ? THREAD_ID : undefined);
            expect(pid).toBeDefined();
            expect(isProcessRunning(pid!)).toBe(true);

            // Close
            if (config.scope === 'thread') {
              await browser.closeThreadSession(THREAD_ID);
            } else {
              await browser.close();
            }

            // Verify our process exited
            const exited = await waitForProcessExit(pid!, 5000);
            expect(exited).toBe(true);

            // Verify profile cleanup
            if (profileDir) {
              expect(hasLockFiles(profileDir)).toBe(false);
              // We seeded exit_type: Crashed before launch.
              // Providers that patch exit_type (Stagehand) must set it to Normal.
              if (factory.patchesExitType) {
                expect(getExitType(profileDir)).toBe('Normal');
              }