@react-native-harness/jest 1.4.0-rc.1 → 1.4.1

package/dist/__tests__/execute-run.test.js

@@ -1,393 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest';
-import { NativeCrashError, StartupStallError } from '../errors.js';
-import { AppBridgeDisconnectedError, DeviceNotRespondingError, } from '@react-native-harness/bridge/server';
-import { executeRun } from '../execute-run.js';
-const resolveUndefined = async () => undefined;
-// Mock the file-runner so we control what jestResult/harnessResult each test returns
-// without needing a real Jest config or Metro bundler.
-const mockRunHarnessTestFile = vi.hoisted(() => vi.fn());
-vi.mock('../run.js', () => ({
-    runHarnessTestFile: mockRunHarnessTestFile,
-}));
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-const makeJestResult = (overrides = {}) => ({
-    testFilePath: '/test/example.ts',
-    testResults: [],
-    failureMessage: null,
-    numFailingTests: 0,
-    numPassingTests: 1,
-    numPendingTests: 0,
-    numTodoTests: 0,
-    leaks: false,
-    openHandles: [],
-    skipped: false,
-    snapshot: {
-        added: 0, fileDeleted: false, matched: 0, unchecked: 0,
-        uncheckedKeys: [], unmatched: 0, updated: 0,
-    },
-    perfStats: { start: 0, end: 1, runtime: 1, slow: false,
-        loadTestEnvironmentStart: 0, loadTestEnvironmentEnd: 0,
-        setupAfterEnvStart: 0, setupAfterEnvEnd: 0,
-        setupFilesStart: 0, setupFilesEnd: 0 },
-    coverage: undefined,
-    ...overrides,
-});
-const makeHarnessResult = (status = 'passed') => ({
-    name: 'suite',
-    tests: [],
-    suites: [],
-    status,
-    duration: 50,
-});
-const makeFileRunResult = (overrides = {}) => ({
-    jestResult: makeJestResult(),
-    harnessResult: makeHarnessResult(),
-    relativeTestPath: 'example.ts',
-    duration: 50,
-    ...overrides,
-});
-const makeTest = (filePath = '/test/example.ts') => ({
-    path: filePath,
-    context: { config: {} },
-});
-const makeWatcher = (interrupted = false) => ({ isInterrupted: () => interrupted });
-const makeGlobalConfig = (overrides = {}) => ({
-    rootDir: '/project',
-    watch: false,
-    watchAll: false,
-    collectCoverage: false,
-    ...overrides,
-});
-const makeSession = (overrides = {}) => ({
-    config: {
-        metroPort: 8081,
-        host: undefined,
-        resetEnvironmentBetweenTestFiles: false,
-        detectNativeCrashes: true,
-        runners: [
-            { platformId: 'android', name: 'android' },
-            { platformId: 'ios', name: 'ios' },
-        ],
-    },
-    context: {
-        platform: {
-            platformId: 'android',
-            name: 'android',
-            runner: '/virtual/android-runner.js',
-            cli: '/virtual/android-cli.js',
-            config: {},
-        },
-    },
-    ensureAppReady: vi.fn(resolveUndefined),
-    runTestFile: vi.fn(async () => makeHarnessResult()),
-    restartApp: vi.fn(resolveUndefined),
-    resetCrashState: vi.fn(),
-    flushClientLogs: vi.fn(() => []),
-    callHook: vi.fn(resolveUndefined),
-    onTestRunnerEvent: vi.fn(() => () => undefined),
-    setRunState: vi.fn(),
-    dispose: vi.fn(resolveUndefined),
-    ...overrides,
-});
-const makeEmitEvent = () => {
-    const calls = [];
-    const emitEvent = (async (...eventData) => {
-        calls.push(eventData);
-    });
-    return { emitEvent, calls };
-};
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-beforeEach(() => {
-    vi.clearAllMocks();
-    mockRunHarnessTestFile.mockResolvedValue(makeFileRunResult());
-});
-describe('executeRun', () => {
-    describe('lifecycle hooks', () => {
-        it('emits run:started then run:finished in order', async () => {
-            const hookNames = [];
-            const session = makeSession({
-                callHook: vi.fn(async (name) => { hookNames.push(name); }),
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), makeEmitEvent().emitEvent, makeGlobalConfig());
-            expect(hookNames[0]).toBe('run:started');
-            expect(hookNames[hookNames.length - 1]).toBe('run:finished');
-        });
-        it('emits test-file:started and test-file:finished around each test', async () => {
-            const hookNames = [];
-            const session = makeSession({
-                callHook: vi.fn(async (name) => { hookNames.push(name); }),
-            });
-            await executeRun(session, [makeTest('/a.ts'), makeTest('/b.ts')], makeWatcher(), makeEmitEvent().emitEvent, makeGlobalConfig());
-            const fileHooks = hookNames.filter((n) => n === 'test-file:started' || n === 'test-file:finished');
-            expect(fileHooks).toEqual([
-                'test-file:started', 'test-file:finished',
-                'test-file:started', 'test-file:finished',
-            ]);
-        });
-        it('always emits run:finished even when a test throws', async () => {
-            const hookNames = [];
-            const session = makeSession({
-                callHook: vi.fn(async (name) => { hookNames.push(name); }),
-                ensureAppReady: vi.fn(async () => { throw new Error('unexpected'); }),
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), makeEmitEvent().emitEvent, makeGlobalConfig());
-            expect(hookNames).toContain('run:finished');
-        });
-    });
-    describe('happy path', () => {
-        it('emits file start, ensureAppReady, runTestFile, file success in order', async () => {
-            const order = [];
-            const session = makeSession({
-                ensureAppReady: vi.fn(async () => { order.push('ensureAppReady'); }),
-            });
-            const emitEvent = (async (eventName, ..._eventData) => {
-                if (eventName === 'test-file-start') {
-                    order.push('test-file-start');
-                }
-                if (eventName === 'test-file-success') {
-                    order.push('test-file-success');
-                }
-            });
-            mockRunHarnessTestFile.mockImplementation(async () => {
-                order.push('runTestFile');
-                return makeFileRunResult();
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), emitEvent, makeGlobalConfig());
-            expect(order).toEqual([
-                'test-file-start',
-                'ensureAppReady',
-                'runTestFile',
-                'test-file-success',
-            ]);
-        });
-        it('accumulates passing test counts in run:finished summary', async () => {
-            let finishedPayload;
-            const session = makeSession({
-                callHook: vi.fn(async (name, payload) => {
-                    if (name === 'run:finished')
-                        finishedPayload = payload;
-                }),
-            });
-            mockRunHarnessTestFile.mockResolvedValue(makeFileRunResult({ jestResult: makeJestResult({ numPassingTests: 3 }) }));
-            await executeRun(session, [makeTest(), makeTest('/b.ts')], makeWatcher(), makeEmitEvent().emitEvent, makeGlobalConfig());
-            const payload = finishedPayload;
-            expect(payload.summary.passed).toBe(6);
-            expect(payload.status).toBe('passed');
-        });
-        it('attaches buffered client logs to the Jest result', async () => {
-            const clientLogs = [{ message: 'Loaded screen', origin: '', type: 'warn' }];
-            const session = makeSession({
-                flushClientLogs: vi.fn()
-                    .mockReturnValueOnce([])
-                    .mockReturnValueOnce(clientLogs),
-            });
-            const { emitEvent, calls } = makeEmitEvent();
-            await executeRun(session, [makeTest()], makeWatcher(), emitEvent, makeGlobalConfig());
-            expect(session.flushClientLogs).toHaveBeenCalledTimes(2);
-            expect(calls).toContainEqual([
-                'test-file-success',
-                expect.anything(),
-                expect.objectContaining({ console: clientLogs }),
-            ]);
-        });
-        it('emits test-case events before file success', async () => {
-            let testRunnerListener;
-            const { emitEvent, calls: emittedEvents } = makeEmitEvent();
-            const session = makeSession({
-                onTestRunnerEvent: vi.fn((listener) => {
-                    testRunnerListener = listener;
-                    return () => undefined;
-                }),
-            });
-            mockRunHarnessTestFile.mockImplementation(async () => {
-                testRunnerListener?.({
-                    type: 'test-started',
-                    file: 'example.ts',
-                    suite: 'suite',
-                    name: 'works',
-                    ancestorTitles: ['suite'],
-                    fullName: 'suite works',
-                    startedAt: 10,
-                    declarationMode: 'only',
-                });
-                testRunnerListener?.({
-                    type: 'test-finished',
-                    file: 'example.ts',
-                    suite: 'suite',
-                    name: 'works',
-                    ancestorTitles: ['suite'],
-                    fullName: 'suite works',
-                    startedAt: 10,
-                    declarationMode: 'only',
-                    duration: 5,
-                    status: 'passed',
-                });
-                return makeFileRunResult();
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), emitEvent, makeGlobalConfig());
-            expect(emittedEvents).toEqual([
-                ['test-file-start', expect.anything()],
-                [
-                    'test-case-start',
-                    'example.ts',
-                    expect.objectContaining({
-                        ancestorTitles: ['suite'],
-                        fullName: 'suite works',
-                        mode: 'only',
-                        title: 'works',
-                        startedAt: 10,
-                    }),
-                ],
-                [
-                    'test-case-result',
-                    'example.ts',
-                    expect.objectContaining({
-                        ancestorTitles: ['suite'],
-                        fullName: 'suite works',
-                        numPassingAsserts: 1,
-                        startedAt: 10,
-                        status: 'passed',
-                        title: 'works',
-                    }),
-                ],
-                ['test-file-success', expect.anything(), expect.anything()],
-            ]);
-        });
-    });
-    describe('runtime failures', () => {
-        it('passes StartupStallError to onFailure with an empty stack', async () => {
-            const { emitEvent, calls } = makeEmitEvent();
-            const session = makeSession({
-                ensureAppReady: vi.fn().mockRejectedValue(new StartupStallError(1500, 3)),
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), emitEvent, makeGlobalConfig());
-            expect(calls).toContainEqual([
-                'test-file-failure',
-                expect.objectContaining({ path: '/test/example.ts' }),
-                expect.objectContaining({ message: expect.stringContaining('1500'), stack: '' }),
-            ]);
-        });
-        it('passes DeviceNotRespondingError to onFailure with an empty stack', async () => {
-            const { emitEvent, calls } = makeEmitEvent();
-            const session = makeSession({
-                ensureAppReady: vi.fn().mockRejectedValue(new DeviceNotRespondingError('runTests', [])),
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), emitEvent, makeGlobalConfig());
-            expect(calls).toContainEqual([
-                'test-file-failure',
-                expect.anything(),
-                expect.objectContaining({ stack: '' }),
-            ]);
-        });
-        it('passes AppBridgeDisconnectedError to onFailure with an empty stack', async () => {
-            const { emitEvent, calls } = makeEmitEvent();
-            const session = makeSession({
-                ensureAppReady: vi.fn().mockRejectedValue(new AppBridgeDisconnectedError('app-disconnected')),
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), emitEvent, makeGlobalConfig());
-            expect(calls).toContainEqual([
-                'test-file-failure',
-                expect.anything(),
-                expect.objectContaining({
-                    message: expect.stringContaining('The app bridge disconnected during test execution.'),
-                    stack: '',
-                }),
-            ]);
-        });
-        it('calls resetCrashState after a NativeCrashError', async () => {
-            const session = makeSession({
-                ensureAppReady: vi.fn().mockRejectedValue(new NativeCrashError('example.ts', { phase: 'execution', source: 'polling' })),
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), makeEmitEvent().emitEvent, makeGlobalConfig());
-            expect(session.resetCrashState).toHaveBeenCalled();
-        });
-        it('counts runtime failures in the summary', async () => {
-            let finishedPayload;
-            const session = makeSession({
-                callHook: vi.fn(async (name, payload) => {
-                    if (name === 'run:finished')
-                        finishedPayload = payload;
-                }),
-                ensureAppReady: vi.fn().mockRejectedValue(new StartupStallError(1000, 2)),
-            });
-            await executeRun(session, [makeTest()], makeWatcher(), makeEmitEvent().emitEvent, makeGlobalConfig());
-            const payload = finishedPayload;
-            expect(payload.summary.failed).toBe(1);
-            expect(payload.status).toBe('failed');
-        });
-    });
-    describe('watcher interrupt', () => {
-        it('stops processing tests and still emits run:finished', async () => {
-            const hookNames = [];
-            const session = makeSession({
-                callHook: vi.fn(async (name) => { hookNames.push(name); }),
-            });
-            const { emitEvent, calls } = makeEmitEvent();
-            await executeRun(session, [makeTest('/a.ts'), makeTest('/b.ts')], makeWatcher(true /* interrupted */), emitEvent, makeGlobalConfig());
-            // No test was started; watcher was already interrupted.
-            expect(calls).not.toContainEqual(['test-file-start', expect.anything()]);
-            expect(hookNames).toContain('run:finished');
-        });
-    });
-    describe('resetEnvironmentBetweenTestFiles', () => {
-        it('calls restartApp before the second test but not the first', async () => {
-            const session = makeSession({
-                config: {
-                    metroPort: 8081,
-                    resetEnvironmentBetweenTestFiles: true,
-                    detectNativeCrashes: false,
-                    runners: [
-                        { platformId: 'android', name: 'android' },
-                        { platformId: 'ios', name: 'ios' },
-                    ],
-                },
-            });
-            await executeRun(session, [makeTest('/a.ts'), makeTest('/b.ts'), makeTest('/c.ts')], makeWatcher(), makeEmitEvent().emitEvent, makeGlobalConfig());
-            // restartApp should be called for tests 2 and 3, not test 1.
-            expect(session.restartApp).toHaveBeenCalledTimes(2);
-        });
-    });
-    describe('platform-specific test files', () => {
-        it('skips files for other platforms without running them on the device', async () => {
-            const session = makeSession();
-            const { emitEvent, calls } = makeEmitEvent();
-            await executeRun(session, [
-                makeTest('/project/smoke.harness.ts'),
-                makeTest('/project/kotlin.android.harness.ts'),
-                makeTest('/project/swift.ios.harness.ts'),
-            ], makeWatcher(), emitEvent, makeGlobalConfig());
-            expect(mockRunHarnessTestFile).toHaveBeenCalledTimes(2);
-            expect(mockRunHarnessTestFile).toHaveBeenCalledWith(expect.objectContaining({ testPath: '/project/smoke.harness.ts' }));
-            expect(mockRunHarnessTestFile).toHaveBeenCalledWith(expect.objectContaining({ testPath: '/project/kotlin.android.harness.ts' }));
-            expect(session.ensureAppReady).toHaveBeenCalledTimes(2);
-            expect(calls).toContainEqual([
-                'test-file-success',
-                expect.objectContaining({ path: '/project/swift.ios.harness.ts' }),
-                expect.objectContaining({ skipped: true }),
-            ]);
-        });
-        it('does not restart the app for skipped platform-specific files', async () => {
-            const session = makeSession({
-                config: {
-                    metroPort: 8081,
-                    resetEnvironmentBetweenTestFiles: true,
-                    detectNativeCrashes: false,
-                    runners: [
-                        { platformId: 'android', name: 'android' },
-                        { platformId: 'ios', name: 'ios' },
-                    ],
-                },
-            });
-            await executeRun(session, [
-                makeTest('/project/swift.ios.harness.ts'),
-                makeTest('/project/kotlin.android.harness.ts'),
-            ], makeWatcher(), vi.fn(), makeGlobalConfig());
-            expect(session.restartApp).not.toHaveBeenCalled();
-            expect(mockRunHarnessTestFile).toHaveBeenCalledTimes(1);
-        });
-    });
-});

package/dist/__tests__/fixtures/mock-platform-runner.d.ts

@@ -1,7 +0,0 @@
-import type { HarnessPlatformInitOptions, HarnessPlatformRunner } from '@react-native-harness/platforms';
-import type { Config as HarnessConfig } from '@react-native-harness/config';
-declare global {
-    var __HARNESS_TEST_PLATFORM_RUNNER__: HarnessPlatformRunner | undefined;
-}
-export default function mockPlatformRunner(_platformConfig: Record<string, unknown>, _harnessConfig: HarnessConfig, _init: HarnessPlatformInitOptions): Promise<HarnessPlatformRunner>;
-//# sourceMappingURL=mock-platform-runner.d.ts.map

package/dist/__tests__/fixtures/mock-platform-runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock-platform-runner.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/mock-platform-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,gCAAgC,EAChC,qBAAqB,GACrB,SAAS,CAAC;CACf;AAED,wBAA8B,kBAAkB,CAC9C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,cAAc,EAAE,aAAa,EAC7B,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,qBAAqB,CAAC,CAMhC"}

package/dist/__tests__/fixtures/mock-platform-runner.js

@@ -1,6 +0,0 @@
-export default async function mockPlatformRunner(_platformConfig, _harnessConfig, _init) {
-    if (!globalThis.__HARNESS_TEST_PLATFORM_RUNNER__) {
-        throw new Error('Missing __HARNESS_TEST_PLATFORM_RUNNER__ test fixture');
-    }
-    return globalThis.__HARNESS_TEST_PLATFORM_RUNNER__;
-}

package/dist/__tests__/harness-cache.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=harness-cache.test.d.ts.map

package/dist/__tests__/harness-cache.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"harness-cache.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/harness-cache.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/harness-cache.test.js

@@ -1,51 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from 'vitest';
-const mocks = vi.hoisted(() => ({
-    isMetroCacheReusable: vi.fn(),
-    logMetroCacheReused: vi.fn(),
-    logMetroPrewarmCompleted: vi.fn(),
-}));
-vi.mock('@react-native-harness/bundler-metro', () => ({
-    isMetroCacheReusable: mocks.isMetroCacheReusable,
-}));
-vi.mock('../logs.js', () => ({
-    logMetroCacheReused: mocks.logMetroCacheReused,
-    logMetroPrewarmCompleted: mocks.logMetroPrewarmCompleted,
-}));
-import { maybeLogMetroCacheReuse } from '../harness.js';
-const platform = {
-    name: 'ios',
-    platformId: 'ios',
-    runner: '/virtual/platform-runner.js',
-    config: {},
-    getResourceLockKey: () => 'ios:simulator:iPhone 17 Pro:26.2',
-};
-const createHarnessConfig = (overrides = {}) => ({
-    appRegistryComponentName: 'App',
-    disableViewFlattening: false,
-    bridgeTimeout: 5000,
-    entryPoint: 'index.js',
-    unstable__enableMetroCache: true,
-    forwardClientLogs: false,
-    ...overrides,
-});
-describe('maybeLogMetroCacheReuse', () => {
-    beforeEach(() => {
-        vi.clearAllMocks();
-        mocks.isMetroCacheReusable.mockReturnValue(false);
-    });
-    it('logs when an existing metro cache will be reused', () => {
-        mocks.isMetroCacheReusable.mockReturnValue(true);
-        maybeLogMetroCacheReuse(createHarnessConfig(), platform, '/tmp/project');
-        expect(mocks.isMetroCacheReusable).toHaveBeenCalledWith('/tmp/project');
-        expect(mocks.logMetroCacheReused).toHaveBeenCalledWith(platform);
-    });
-    it('does not log when metro cache reuse is disabled', () => {
-        maybeLogMetroCacheReuse(createHarnessConfig({ unstable__enableMetroCache: false }), platform, '/tmp/project');
-        expect(mocks.isMetroCacheReusable).not.toHaveBeenCalled();
-        expect(mocks.logMetroCacheReused).not.toHaveBeenCalled();
-    });
-    it('does not log when the metro cache is absent', () => {
-        maybeLogMetroCacheReuse(createHarnessConfig(), platform, '/tmp/project');
-        expect(mocks.logMetroCacheReused).not.toHaveBeenCalled();
-    });
-});

package/dist/__tests__/harness-session.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=harness-session.test.d.ts.map

package/dist/__tests__/harness-session.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"harness-session.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/harness-session.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/harness-session.test.js

@@ -1,74 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { waitForBridgeDisconnectOrTimeout, waitForStartupCrash, } from '../harness-session.js';
-const createConnection = () => ({
-    device: {
-        platform: 'ios',
-        manufacturer: 'Apple',
-        model: 'iPhone',
-        osVersion: '18.0',
-    },
-    runTests: vi.fn(),
-});
-const createBridge = (connection) => {
-    let currentConnection = connection;
-    let disconnectedListener = null;
-    return {
-        get connection() {
-            return currentConnection;
-        },
-        on: vi.fn((event, listener) => {
-            if (event === 'disconnected') {
-                disconnectedListener = listener;
-            }
-        }),
-        off: vi.fn((event, listener) => {
-            if (event === 'disconnected' && disconnectedListener === listener) {
-                disconnectedListener = null;
-            }
-        }),
-        disconnect: () => {
-            currentConnection = null;
-            disconnectedListener?.();
-        },
-    };
-};
-describe('waitForBridgeDisconnectOrTimeout', () => {
-    it('returns true when the bridge disconnects before the timeout', async () => {
-        const connection = createConnection();
-        const bridge = createBridge(connection);
-        const waitPromise = waitForBridgeDisconnectOrTimeout({
-            bridge,
-            connection,
-            timeoutMs: 50,
-        });
-        bridge.disconnect();
-        await expect(waitPromise).resolves.toBe(true);
-    });
-    it('returns false when the bridge stays connected through the timeout', async () => {
-        const connection = createConnection();
-        const bridge = createBridge(connection);
-        await expect(waitForBridgeDisconnectOrTimeout({
-            bridge,
-            connection,
-            timeoutMs: 10,
-        })).resolves.toBe(false);
-    });
-});
-describe('waitForStartupCrash', () => {
-    it('does not install a startup crash watch when native crash detection is disabled', async () => {
-        const watch = vi.fn();
-        const crashMonitor = {
-            watch,
-        };
-        const controller = new AbortController();
-        const waitPromise = waitForStartupCrash({
-            crashMonitor,
-            detectNativeCrashes: false,
-            testFilePath: '/test.harness.ts',
-            signal: controller.signal,
-        });
-        controller.abort(new DOMException('Aborted', 'AbortError'));
-        await expect(waitPromise).rejects.toThrow('Aborted');
-        expect(watch).not.toHaveBeenCalled();
-    });
-});

package/dist/__tests__/harness.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=harness.test.d.ts.map

package/dist/__tests__/harness.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"harness.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/harness.test.ts"],"names":[],"mappings":""}