Exposes globalConfig to custom test sequencers

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Fixes
 
 - `[jest-leak-detector]` Make leak-detector more aggressive when running GC ([#14526](https://github.com/jestjs/jest/pull/14526))
+- `[jest-test-sequencer, jest-core]` Exposes globalConfig & contexts to TestSequencer ([#14535](https://github.com/jestjs/jest/pull/14535))
 
 ### Performance
 

e2e/__tests__/customTestSequencers.test.ts

@@ -79,3 +79,56 @@ test('run failed tests async', () => {
     .split('\n');
   expect(sequence).toEqual(['./c.test.js', './d.test.js']);
 });
+
+test('run tests based on even seed', () => {
+  const result = runJest(
+    dir,
+    [
+      '-i',
+      '--config',
+      JSON.stringify({
+        testSequencer: '<rootDir>/testSequencerWithSeed.js',
+      }),
+      '--seed=2',
+    ],
+    {},
+  );
+  console.log({result});
+  expect(result.exitCode).toBe(0);
+  const sequence = extractSummary(result.stderr)
+    .rest.replace(/PASS /g, '')
+    .split('\n');
+  expect(sequence).toEqual([
+    './a.test.js',
+    './b.test.js',
+    './c.test.js',
+    './d.test.js',
+    './e.test.js',
+  ]);
+});
+
+test('run tests based on odd seed', () => {
+  const result = runJest(
+    dir,
+    [
+      '-i',
+      '--config',
+      JSON.stringify({
+        testSequencer: '<rootDir>/testSequencerWithSeed.js',
+      }),
+      '--seed=1',
+    ],
+    {},
+  );
+  expect(result.exitCode).toBe(0);
+  const sequence = extractSummary(result.stderr)
+    .rest.replace(/PASS /g, '')
+    .split('\n');
+  expect(sequence).toEqual([
+    './e.test.js',
+    './d.test.js',
+    './c.test.js',
+    './b.test.js',
+    './a.test.js',
+  ]);
+});

e2e/custom-test-sequencer/testSequencerWithSeed.js

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+
+const Sequencer = require('@jest/test-sequencer').default;
+
+class CustomSequencer extends Sequencer {
+  sort(tests) {
+    const copyTests = Array.from(tests);
+    const seed = this.globalConfig.seed;
+    const sortedTests = copyTests.sort((testA, testB) =>
+      testA.path > testB.path ? 1 : -1,
+    );
+
+    if (seed % 2 === 0) {
+      return sortedTests;
+    } else {
+      return sortedTests.reverse();
+    }
+  }
+}
+
+module.exports = CustomSequencer;

packages/jest-core/src/runJest.ts

@@ -159,7 +159,7 @@ export default async function runJest({
   const Sequencer: typeof TestSequencer = await requireOrImportModule(
     globalConfig.testSequencer,
   );
-  const sequencer = new Sequencer();
+  const sequencer = new Sequencer({contexts, globalConfig});
   let allTests: Array<Test> = [];
 
   if (changedFilesPromise && globalConfig.watch) {

packages/jest-test-sequencer/src/__tests__/test_sequencer.test.ts

@@ -9,6 +9,7 @@ import * as path from 'path';
 import * as mockedFs from 'graceful-fs';
 import type {AggregatedResult, Test, TestContext} from '@jest/test-result';
 import {makeProjectConfig} from '@jest/test-utils';
+import type {Config} from '@jest/types';
 import TestSequencer from '../index';
 
 jest.mock('graceful-fs', () => ({
@@ -56,7 +57,10 @@ const toTests = (paths: Array<string>) =>
 
 beforeEach(() => {
   jest.clearAllMocks();
-  sequencer = new TestSequencer();
+  sequencer = new TestSequencer({
+    contexts: [],
+    globalConfig: {} as Config.GlobalConfig,
+  });
 });
 
 test('sorts by file size if there is no timing information', () => {

packages/jest-test-sequencer/src/index.ts

@@ -10,11 +10,17 @@ import * as path from 'path';
 import * as fs from 'graceful-fs';
 import slash = require('slash');
 import type {AggregatedResult, Test, TestContext} from '@jest/test-result';
+import type {Config} from '@jest/types';
 import HasteMap from 'jest-haste-map';
 
 const FAIL = 0;
 const SUCCESS = 1;
 
+export type TestSequencerOptions = {
+  contexts: Array<TestContext>;
+  globalConfig: Config.GlobalConfig;
+};
+
 type Cache = {
   [key: string]:
     | [testStatus: typeof FAIL | typeof SUCCESS, testDuration: number]
@@ -46,6 +52,14 @@ type ShardPositionOptions = ShardOptions & {
 export default class TestSequencer {
   private readonly _cache = new Map<TestContext, Cache>();
 
+  protected readonly globalConfig: Config.GlobalConfig;
+  protected readonly contexts: Array<TestContext>;
+
+  constructor({contexts, globalConfig}: TestSequencerOptions) {
+    this.globalConfig = globalConfig;
+    this.contexts = contexts;
+  }
+
   _getCachePath(testContext: TestContext): string {
     const {config} = testContext;
     const HasteMapClass = HasteMap.getStatic(config);