@react-native-harness/jest 1.2.0-rc.1 → 1.2.0

package/dist/execute-run.js

@@ -0,0 +1,151 @@
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { runHarnessTestFile } from './run.js';
+import { NativeCrashError, StartupStallError, } from './errors.js';
+import { DeviceNotRespondingError } from '@react-native-harness/bridge/server';
+const createRunSummary = () => ({ passed: 0, failed: 0, skipped: 0, todo: 0 });
+const applyJestResultToSummary = (summary, result) => {
+    summary.passed += result.numPassingTests;
+    summary.failed += result.numFailingTests;
+    summary.skipped += result.numPendingTests;
+    summary.todo += result.numTodoTests;
+};
+class CancelRun extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CancelRun';
+    }
+}
+const buildTestFailure = (err) => {
+    if (err instanceof NativeCrashError ||
+        err instanceof StartupStallError ||
+        err instanceof DeviceNotRespondingError) {
+        return { message: err.message, stack: '' };
+    }
+    return err;
+};
+export const executeRun = async (session, tests, watcher, onStart, onResult, onFailure, globalConfig) => {
+    const runId = randomUUID();
+    const startTime = Date.now();
+    const watchMode = globalConfig.watch || globalConfig.watchAll;
+    const rootDir = globalConfig.rootDir ?? process.cwd();
+    const testFiles = tests.map((t) => path.relative(rootDir, t.path));
+    const summary = createRunSummary();
+    const updateRunState = (overrides = {}) => {
+        const state = {
+            runId,
+            startTime,
+            testFiles,
+            watchMode,
+            coverageEnabled: globalConfig.collectCoverage,
+            summary,
+            status: summary.failed > 0 ? 'failed' : 'passed',
+            ...overrides,
+        };
+        session.setRunState(state);
+        return state;
+    };
+    updateRunState();
+    await session.callHook('run:started', {
+        runId,
+        startTime,
+        testFiles,
+        watchMode,
+        coverageEnabled: globalConfig.collectCoverage,
+    });
+    await session.callHook('metro:initialized', {
+        runId,
+        port: session.config.metroPort,
+        host: session.config.host?.trim() || undefined,
+    });
+    const shouldResetEnv = session.config.resetEnvironmentBetweenTestFiles;
+    let isFirstTest = true;
+    let runError;
+    try {
+        for (const test of tests) {
+            if (watcher.isInterrupted())
+                throw new CancelRun();
+            const relativeTestPath = path.relative(rootDir, test.path);
+            const fileStartedAt = Date.now();
+            let emittedTestFileFinished = false;
+            const emitTestFileFinished = async (options) => {
+                emittedTestFileFinished = true;
+                await session.callHook('test-file:finished', {
+                    runId,
+                    file: relativeTestPath,
+                    duration: options.duration,
+                    status: options.status,
+                    result: options.result,
+                });
+            };
+            await session.callHook('test-file:started', { runId, file: relativeTestPath });
+            try {
+                if (shouldResetEnv && !isFirstTest) {
+                    await session.restartApp(test.path);
+                }
+                isFirstTest = false;
+                session.flushClientLogs();
+                await onStart(test);
+                await session.ensureAppReady(test.path);
+                // Crash detection is handled inside session.runTestFile; NativeCrashError
+                // propagates here if a crash wins the race.
+                const result = await runHarnessTestFile({
+                    testPath: test.path,
+                    session,
+                    globalConfig,
+                    projectConfig: test.context.config,
+                });
+                applyJestResultToSummary(summary, result.jestResult);
+                const clientLogs = session.flushClientLogs();
+                if (clientLogs.length > 0) {
+                    result.jestResult.console = clientLogs;
+                }
+                updateRunState();
+                await emitTestFileFinished({
+                    status: result.harnessResult.status,
+                    duration: result.duration,
+                    result: result.harnessResult,
+                });
+                await onResult(test, result.jestResult);
+            }
+            catch (err) {
+                if (!emittedTestFileFinished) {
+                    await emitTestFileFinished({
+                        status: 'failed',
+                        duration: Date.now() - fileStartedAt,
+                        result: null,
+                    });
+                }
+                const isRuntimeFailure = err instanceof NativeCrashError ||
+                    err instanceof StartupStallError ||
+                    err instanceof DeviceNotRespondingError;
+                if (isRuntimeFailure) {
+                    summary.failed += 1;
+                    updateRunState();
+                }
+                if (err instanceof NativeCrashError) {
+                    session.resetCrashState();
+                }
+                updateRunState({ error: isRuntimeFailure ? undefined : err });
+                onFailure(test, buildTestFailure(err));
+            }
+        }
+    }
+    catch (err) {
+        runError = err;
+        if (!(err instanceof CancelRun))
+            throw err;
+    }
+    finally {
+        const runState = updateRunState(runError != null ? { error: runError, status: 'failed' } : {});
+        await session.callHook('run:finished', {
+            runId,
+            startTime,
+            duration: Date.now() - startTime,
+            testFiles,
+            summary,
+            status: runState.status ?? (runError != null ? 'failed' : 'passed'),
+            ...(runError != null ? { error: runError } : {}),
+        });
+    }
+};

package/dist/harness-session.d.ts

@@ -0,0 +1,34 @@
+import { type HarnessContext, type TestExecutionOptions, type TestSuiteResult } from '@react-native-harness/bridge';
+import { type HarnessPlatform } from '@react-native-harness/platforms';
+import { type HarnessPluginManager, type HarnessRunStatus, type HarnessRunSummary } from '@react-native-harness/plugins';
+import { type Config as HarnessConfig } from '@react-native-harness/config';
+import type { Config as JestConfig } from 'jest-runner';
+import { type ClientLogBuffer } from './client-log-handler.js';
+import { type ResourceLockManager } from './resource-lock.js';
+export type HarnessRunState = {
+    readonly runId: string;
+    readonly startTime: number;
+    readonly testFiles: string[];
+    readonly watchMode: boolean;
+    readonly coverageEnabled: boolean;
+    readonly summary?: HarnessRunSummary;
+    readonly status?: HarnessRunStatus;
+    readonly error?: unknown;
+};
+export type HarnessRunTestsOptions = Exclude<TestExecutionOptions, 'platform'>;
+export type HarnessSession = {
+    readonly config: HarnessConfig;
+    readonly context: HarnessContext;
+    runTestFile: (path: string, options: HarnessRunTestsOptions) => Promise<TestSuiteResult>;
+    ensureAppReady: (testFilePath: string) => Promise<void>;
+    restartApp: (testFilePath?: string) => Promise<void>;
+    resetCrashState: () => void;
+    flushClientLogs: () => ClientLogBuffer;
+    callHook: HarnessPluginManager<HarnessConfig, HarnessPlatform>['callHook'];
+    setRunState: (state: HarnessRunState | null) => void;
+    dispose: (reason?: 'normal' | 'abort' | 'error') => Promise<void>;
+};
+export declare const createHarnessSession: (globalConfig: JestConfig.GlobalConfig, { lockManager }?: {
+    lockManager?: ResourceLockManager;
+}) => Promise<HarnessSession>;
+//# sourceMappingURL=harness-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness-session.d.ts","sourceRoot":"","sources":["../src/harness-session.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,eAAe,EAGrB,MAAM,iCAAiC,CAAC;AASzC,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAEL,KAAK,MAAM,IAAI,aAAa,EAE7B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAMxD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,oBAAoB,CAAC;AAkB5B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAE/E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACzF,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,UAAU,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,eAAe,CAAC;IACvC,QAAQ,EAAE,oBAAoB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,UAAU,CAAC,CAAC;IAC3E,WAAW,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,CAAC;AAuOF,eAAO,MAAM,oBAAoB,GAC/B,cAAc,UAAU,CAAC,YAAY,EACrC,kBAA8C;IAAE,WAAW,CAAC,EAAE,mBAAmB,CAAA;CAAO,KACvF,OAAO,CAAC,cAAc,CA6YxB,CAAC"}