All files / core/blong-browser/src/components/TestRun testRunCatalogHandler.ts

100% Statements 4/4
87.5% Branches 7/8
100% Functions 3/3
100% Lines 4/4

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35                                                  4x 4x 4x 4x            
/**
 * The catalog handler a host realm registers for the TestRun page.
 *
 * The handler only describes scenarios; it never dispatches one. A host binds it in a browser
 * layer whose activation is `test-ui`, supplies the catalog (or lets its component config supply
 * it), and the page then refuses any method outside that list.
 */
import {handler} from '@feasibleone/blong';
import type {ITestRunCatalogEntry} from './TestRunPage.js';
 
export interface ITestRunCatalogSettings {
    /** The scenarios the host allows; defaults to the list passed to the factory. */
    tests?: ITestRunCatalogEntry[];
    /** Set false in an environment where the page must exist but run nothing. */
    enabled?: boolean;
}
 
/**
 * Build a catalog handler definition a host layer can export. The host file is named `catalogGet.ts`
 * to match this function's name; place it in a handler group the host realm activates.
 */
export function createTestRunCatalogHandler(
    fallback: ITestRunCatalogEntry[] = [],
    method = 'test.run.catalogGet',
) {
    return handler(function catalogGet({config}) {
        const settings = (config ?? {}) as ITestRunCatalogSettings;
        return {
            [method]: async () => ({
                tests: settings.enabled === false ? [] : (settings.tests ?? fallback),
            }),
        };
    });
}