/** * Copyright (c) Meta Platforms, Inc. and affiliates. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. */ import type {AggregatedResult} from '@jest/test-result'; import type {Test} from '@jest/test-result'; import type {TestContext} from '@jest/test-result'; declare type Cache_2 = { [key: string]: [0 | 1, number] | undefined; }; export declare type ShardOptions = { shardIndex: number; shardCount: number; }; /** * The TestSequencer will ultimately decide which tests should run first. * It is responsible for storing and reading from a local cache * map that stores context information for a given test, such as how long it * took to run during the last run and if it has failed or not. * Such information is used on: * TestSequencer.sort(tests: Array) * to sort the order of the provided tests. * * After the results are collected, * TestSequencer.cacheResults(tests: Array, results: AggregatedResult) * is called to store/update this information on the cache map. */ declare class TestSequencer { private readonly _cache; _getCachePath(testContext: TestContext): string; _getCache(test: Test): Cache_2; private _shardPosition; /** * Select tests for shard requested via --shard=shardIndex/shardCount * Sharding is applied before sorting * * @param tests All tests * @param options shardIndex and shardIndex to select * * @example * ```typescript * class CustomSequencer extends Sequencer { * shard(tests, { shardIndex, shardCount }) { * const shardSize = Math.ceil(tests.length / options.shardCount); * const shardStart = shardSize * (options.shardIndex - 1); * const shardEnd = shardSize * options.shardIndex; * return [...tests] * .sort((a, b) => (a.path > b.path ? 1 : -1)) * .slice(shardStart, shardEnd); * } * } * ``` */ shard( tests: Array, options: ShardOptions, ): Array | Promise>; /** * Sort test to determine order of execution * Sorting is applied after sharding * @param tests * * ```typescript * class CustomSequencer extends Sequencer { * sort(tests) { * const copyTests = Array.from(tests); * return [...tests].sort((a, b) => (a.path > b.path ? 1 : -1)); * } * } * ``` */ sort(tests: Array): Array | Promise>; allFailedTests(tests: Array): Array | Promise>; cacheResults(tests: Array, results: AggregatedResult): void; private hasFailed; private time; } export default TestSequencer; export {};