/** * Copyright 2019 Google Inc. All rights reserved. * Modifications copyright (c) Microsoft Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ /* eslint-disable no-console */ import rimraf from 'rimraf'; import * as fs from 'fs'; import * as path from 'path'; import { promisify } from 'util'; import { Dispatcher, TestGroup } from './dispatcher'; import { createFileMatcher, createTitleMatcher, FilePatternFilter, monotonicTime } from './util'; import { TestCase, Suite } from './test'; import { Loader } from './loader'; import { Reporter } from '../types/testReporter'; import { Multiplexer } from './reporters/multiplexer'; import DotReporter from './reporters/dot'; import GitHubReporter from './reporters/github'; import LineReporter from './reporters/line'; import ListReporter from './reporters/list'; import JSONReporter from './reporters/json'; import JUnitReporter from './reporters/junit'; import EmptyReporter from './reporters/empty'; import HtmlReporter from './reporters/html'; import { ProjectImpl } from './project'; import { Minimatch } from 'minimatch'; import { FullConfig } from './types'; import { WebServer } from './webServer'; import { raceAgainstDeadline } from 'playwright-core/src/utils/async'; const removeFolderAsync = promisify(rimraf); const readDirAsync = promisify(fs.readdir); const readFileAsync = promisify(fs.readFile); type RunResultStatus = 'passed' | 'failed' | 'sigint' | 'forbid-only' | 'clashing-test-titles' | 'no-tests' | 'timedout'; type RunResult = { status: Exclude; } | { status: 'forbid-only', locations: string[] } | { status: 'clashing-test-titles', clashingTests: Map }; export class Runner { private _loader: Loader; private _reporter!: Reporter; private _didBegin = false; constructor(loader: Loader) { this._loader = loader; } private async _createReporter(list: boolean) { const defaultReporters: {[key in BuiltInReporter]: new(arg: any) => Reporter} = { dot: list ? ListModeReporter : DotReporter, line: list ? ListModeReporter : LineReporter, list: list ? ListModeReporter : ListReporter, github: GitHubReporter, json: JSONReporter, junit: JUnitReporter, null: EmptyReporter, html: HtmlReporter, }; const reporters: Reporter[] = []; for (const r of this._loader.fullConfig().reporter) { const [name, arg] = r; if (name in defaultReporters) { reporters.push(new defaultReporters[name as keyof typeof defaultReporters](arg)); } else { const reporterConstructor = await this._loader.loadReporter(name); reporters.push(new reporterConstructor(arg)); } } return new Multiplexer(reporters); } async run(list: boolean, filePatternFilters: FilePatternFilter[], projectNames?: string[]): Promise { this._reporter = await this._createReporter(list); const config = this._loader.fullConfig(); const globalDeadline = config.globalTimeout ? config.globalTimeout + monotonicTime() : 0; const { result, timedOut } = await raceAgainstDeadline(this._run(list, filePatternFilters, projectNames), globalDeadline); if (timedOut) { if (!this._didBegin) this._reporter.onBegin?.(config, new Suite('')); await this._reporter.onEnd?.({ status: 'timedout' }); await this._flushOutput(); return 'failed'; } if (result?.status === 'forbid-only') { console.error('====================================='); console.error(' --forbid-only found a focused test.'); for (const location of result?.locations) console.error(` - ${location}`); console.error('====================================='); } else if (result!.status === 'no-tests') { console.error('================='); console.error(' no tests found.'); console.error('================='); } else if (result?.status === 'clashing-test-titles') { console.error('================='); console.error(' duplicate test titles are not allowed.'); for (const [title, tests] of result?.clashingTests.entries()) { console.error(` - title: ${title}`); for (const test of tests) console.error(` - ${buildItemLocation(config.rootDir, test)}`); console.error('================='); } } await this._flushOutput(); return result!.status!; } async _flushOutput() { // Calling process.exit() might truncate large stdout/stderr output. // See https://github.com/nodejs/node/issues/6456. // See https://github.com/nodejs/node/issues/12921 await new Promise(resolve => process.stdout.write('', () => resolve())); await new Promise(resolve => process.stderr.write('', () => resolve())); } async _run(list: boolean, testFileReFilters: FilePatternFilter[], projectNames?: string[]): Promise { const testFileFilter = testFileReFilters.length ? createFileMatcher(testFileReFilters.map(e => e.re)) : () => true; const config = this._loader.fullConfig(); let projectsToFind: Set | undefined; let unknownProjects: Map | undefined; if (projectNames) { projectsToFind = new Set(); unknownProjects = new Map(); projectNames.forEach(n => { const name = n.toLocaleLowerCase(); projectsToFind!.add(name); unknownProjects!.set(name, n); }); } const projects = this._loader.projects().filter(project => { if (!projectsToFind) return true; const name = project.config.name.toLocaleLowerCase(); unknownProjects!.delete(name); return projectsToFind.has(name); }); if (unknownProjects && unknownProjects.size) { const names = this._loader.projects().map(p => p.config.name).filter(name => !!name); if (!names.length) throw new Error(`No named projects are specified in the configuration file`); const unknownProjectNames = Array.from(unknownProjects.values()).map(n => `"${n}"`).join(', '); throw new Error(`Project(s) ${unknownProjectNames} not found. Available named projects: ${names.map(name => `"${name}"`).join(', ')}`); } const files = new Map(); const allTestFiles = new Set(); for (const project of projects) { const testDir = project.config.testDir; if (!fs.existsSync(testDir)) throw new Error(`${testDir} does not exist`); if (!fs.statSync(testDir).isDirectory()) throw new Error(`${testDir} is not a directory`); const allFiles = await collectFiles(project.config.testDir); const testMatch = createFileMatcher(project.config.testMatch); const testIgnore = createFileMatcher(project.config.testIgnore); const testFileExtension = (file: string) => ['.js', '.ts', '.mjs'].includes(path.extname(file)); const testFiles = allFiles.filter(file => !testIgnore(file) && testMatch(file) && testFileFilter(file) && testFileExtension(file)); files.set(project, testFiles); testFiles.forEach(file => allTestFiles.add(file)); } const webServer = (!list && config.webServer) ? await WebServer.create(config.webServer) : undefined; let globalSetupResult: any; if (config.globalSetup && !list) globalSetupResult = await (await this._loader.loadGlobalHook(config.globalSetup, 'globalSetup'))(this._loader.fullConfig()); try { for (const file of allTestFiles) await this._loader.loadTestFile(file); const preprocessRoot = new Suite(''); for (const fileSuite of this._loader.fileSuites().values()) preprocessRoot._addSuite(fileSuite); if (config.forbidOnly) { const onlyTestsAndSuites = preprocessRoot._getOnlyItems(); if (onlyTestsAndSuites.length > 0) { const locations = onlyTestsAndSuites.map(testOrSuite => { // Skip root and file. const title = testOrSuite.titlePath().slice(2).join(' '); return `${buildItemLocation(config.rootDir, testOrSuite)} > ${title}`; }); return { status: 'forbid-only', locations }; } } const clashingTests = getClashingTestsPerSuite(preprocessRoot); if (clashingTests.size > 0) return { status: 'clashing-test-titles', clashingTests: clashingTests }; filterOnly(preprocessRoot); filterByFocusedLine(preprocessRoot, testFileReFilters); const fileSuites = new Map(); for (const fileSuite of preprocessRoot.suites) fileSuites.set(fileSuite._requireFile, fileSuite); const outputDirs = new Set(); const grepMatcher = createTitleMatcher(config.grep); const grepInvertMatcher = config.grepInvert ? createTitleMatcher(config.grepInvert) : null; const rootSuite = new Suite(''); for (const project of projects) { const projectSuite = new Suite(project.config.name); projectSuite._projectConfig = project.config; rootSuite._addSuite(projectSuite); for (const file of files.get(project)!) { const fileSuite = fileSuites.get(file); if (!fileSuite) continue; for (let repeatEachIndex = 0; repeatEachIndex < project.config.repeatEach; repeatEachIndex++) { const cloned = project.cloneFileSuite(fileSuite, repeatEachIndex, test => { const grepTitle = test.titlePath().join(' '); if (grepInvertMatcher?.(grepTitle)) return false; return grepMatcher(grepTitle); }); if (cloned) projectSuite._addSuite(cloned); } } outputDirs.add(project.config.outputDir); } let total = rootSuite.allTests().length; if (!total) return { status: 'no-tests' }; await Promise.all(Array.from(outputDirs).map(outputDir => removeFolderAsync(outputDir).catch(e => {}))); let testGroups = createTestGroups(rootSuite); const shard = config.shard; if (shard) { const shardGroups: TestGroup[] = []; const shardTests = new Set(); // Each shard gets some tests. const shardSize = Math.floor(total / shard.total); // First few shards get one more test each. const extraOne = total - shardSize * shard.total; const currentShard = shard.current - 1; // Make it zero-based for calculations. const from = shardSize * currentShard + Math.min(extraOne, currentShard); const to = from + shardSize + (currentShard < extraOne ? 1 : 0); let current = 0; for (const group of testGroups) { // Any test group goes to the shard that contains the first test of this group. // So, this shard gets any group that starts at [from; to) if (current >= from && current < to) { shardGroups.push(group); for (const test of group.tests) shardTests.add(test); } current += group.tests.length; } testGroups = shardGroups; filterSuite(rootSuite, () => false, test => shardTests.has(test)); total = rootSuite.allTests().length; } if (process.stdout.isTTY) { console.log(); const jobs = Math.min(config.workers, testGroups.length); const shardDetails = shard ? `, shard ${shard.current} of ${shard.total}` : ''; console.log(`Running ${total} test${total > 1 ? 's' : ''} using ${jobs} worker${jobs > 1 ? 's' : ''}${shardDetails}`); } let sigint = false; let sigintCallback: () => void; const sigIntPromise = new Promise(f => sigintCallback = f); const sigintHandler = () => { // We remove the handler so that second Ctrl+C immediately kills the runner // via the default sigint handler. This is handy in the case where our shutdown // takes a lot of time or is buggy. // // When running through NPM we might get multiple SIGINT signals // for a single Ctrl+C - this is an NPM bug present since at least NPM v6. // https://github.com/npm/cli/issues/1591 // https://github.com/npm/cli/issues/2124 // // Therefore, removing the handler too soon will just kill the process // with default handler without printing the results. // We work around this by giving NPM 1000ms to send us duplicate signals. // The side effect is that slow shutdown or bug in our runner will force // the user to hit Ctrl+C again after at least a second. setTimeout(() => process.off('SIGINT', sigintHandler), 1000); sigint = true; sigintCallback(); }; process.on('SIGINT', sigintHandler); this._reporter.onBegin?.(config, rootSuite); this._didBegin = true; let hasWorkerErrors = false; if (!list) { const dispatcher = new Dispatcher(this._loader, testGroups, this._reporter); await Promise.race([dispatcher.run(), sigIntPromise]); await dispatcher.stop(); hasWorkerErrors = dispatcher.hasWorkerErrors(); } if (sigint) { await this._reporter.onEnd?.({ status: 'interrupted' }); return { status: 'sigint' }; } const failed = hasWorkerErrors || rootSuite.allTests().some(test => !test.ok()); await this._reporter.onEnd?.({ status: failed ? 'failed' : 'passed' }); return { status: failed ? 'failed' : 'passed' }; } finally { if (globalSetupResult && typeof globalSetupResult === 'function') await globalSetupResult(this._loader.fullConfig()); if (config.globalTeardown && !list) await (await this._loader.loadGlobalHook(config.globalTeardown, 'globalTeardown'))(this._loader.fullConfig()); await webServer?.kill(); } } } function filterOnly(suite: Suite) { const suiteFilter = (suite: Suite) => suite._only; const testFilter = (test: TestCase) => test._only; return filterSuite(suite, suiteFilter, testFilter); } function filterByFocusedLine(suite: Suite, focusedTestFileLines: FilePatternFilter[]) { const testFileLineMatches = (testFileName: string, testLine: number) => focusedTestFileLines.some(({ re, line }) => { re.lastIndex = 0; return re.test(testFileName) && (line === testLine || line === null); }); const suiteFilter = (suite: Suite) => !!suite.location && testFileLineMatches(suite.location.file, suite.location.line); const testFilter = (test: TestCase) => testFileLineMatches(test.location.file, test.location.line); return filterSuite(suite, suiteFilter, testFilter); } function filterSuite(suite: Suite, suiteFilter: (suites: Suite) => boolean, testFilter: (test: TestCase) => boolean) { const onlySuites = suite.suites.filter(child => filterSuite(child, suiteFilter, testFilter) || suiteFilter(child)); const onlyTests = suite.tests.filter(testFilter); const onlyEntries = new Set([...onlySuites, ...onlyTests]); if (onlyEntries.size) { suite.suites = onlySuites; suite.tests = onlyTests; suite._entries = suite._entries.filter(e => onlyEntries.has(e)); // Preserve the order. return true; } return false; } async function collectFiles(testDir: string): Promise { type Rule = { dir: string; negate: boolean; match: (s: string, partial?: boolean) => boolean }; type IgnoreStatus = 'ignored' | 'included' | 'ignored-but-recurse'; const checkIgnores = (entryPath: string, rules: Rule[], isDirectory: boolean, parentStatus: IgnoreStatus) => { let status = parentStatus; for (const rule of rules) { const ruleIncludes = rule.negate; if ((status === 'included') === ruleIncludes) continue; const relative = path.relative(rule.dir, entryPath); if (rule.match('/' + relative) || rule.match(relative)) { // Matches "/dir/file" or "dir/file" status = ruleIncludes ? 'included' : 'ignored'; } else if (isDirectory && (rule.match('/' + relative + '/') || rule.match(relative + '/'))) { // Matches "/dir/subdir/" or "dir/subdir/" for directories. status = ruleIncludes ? 'included' : 'ignored'; } else if (isDirectory && ruleIncludes && (rule.match('/' + relative, true) || rule.match(relative, true))) { // Matches "/dir/donotskip/" when "/dir" is excluded, but "!/dir/donotskip/file" is included. status = 'ignored-but-recurse'; } } return status; }; const files: string[] = []; const visit = async (dir: string, rules: Rule[], status: IgnoreStatus) => { const entries = await readDirAsync(dir, { withFileTypes: true }); entries.sort((a, b) => a.name.localeCompare(b.name)); const gitignore = entries.find(e => e.isFile() && e.name === '.gitignore'); if (gitignore) { const content = await readFileAsync(path.join(dir, gitignore.name), 'utf8'); const newRules: Rule[] = content.split(/\r?\n/).map(s => { s = s.trim(); if (!s) return; // Use flipNegate, because we handle negation ourselves. const rule = new Minimatch(s, { matchBase: true, dot: true, flipNegate: true }) as any; if (rule.comment) return; rule.dir = dir; return rule; }).filter(rule => !!rule); rules = [...rules, ...newRules]; } for (const entry of entries) { if (entry === gitignore || entry.name === '.' || entry.name === '..') continue; if (entry.isDirectory() && entry.name === 'node_modules') continue; const entryPath = path.join(dir, entry.name); const entryStatus = checkIgnores(entryPath, rules, entry.isDirectory(), status); if (entry.isDirectory() && entryStatus !== 'ignored') await visit(entryPath, rules, entryStatus); else if (entry.isFile() && entryStatus === 'included') files.push(entryPath); } }; await visit(testDir, [], 'included'); return files; } function getClashingTestsPerSuite(rootSuite: Suite): Map { function visit(suite: Suite, clashingTests: Map) { for (const childSuite of suite.suites) visit(childSuite, clashingTests); for (const test of suite.tests) { const fullTitle = test.titlePath().slice(2).join(' '); if (!clashingTests.has(fullTitle)) clashingTests.set(fullTitle, []); clashingTests.set(fullTitle, clashingTests.get(fullTitle)!.concat(test)); } } const out = new Map(); for (const fileSuite of rootSuite.suites) { const clashingTests = new Map(); visit(fileSuite, clashingTests); for (const [title, tests] of clashingTests.entries()) { if (tests.length > 1) out.set(title, tests); } } return out; } function buildItemLocation(rootDir: string, testOrSuite: Suite | TestCase) { if (!testOrSuite.location) return ''; return `${path.relative(rootDir, testOrSuite.location.file)}:${testOrSuite.location.line}`; } function createTestGroups(rootSuite: Suite): TestGroup[] { // This function groups tests that can be run together. // Tests cannot be run together when: // - They belong to different projects - requires different workers. // - They have a different repeatEachIndex - requires different workers. // - They have a different set of worker fixtures in the pool - requires different workers. // - They have a different requireFile - reuses the worker, but runs each requireFile separately. // - They belong to a parallel suite. // Using the map "workerHash -> requireFile -> group" makes us preserve the natural order // of worker hashes and require files for the simple cases. const groups = new Map>(); const createGroup = (test: TestCase): TestGroup => { return { workerHash: test._workerHash, requireFile: test._requireFile, repeatEachIndex: test._repeatEachIndex, projectIndex: test._projectIndex, tests: [], }; }; for (const projectSuite of rootSuite.suites) { for (const test of projectSuite.allTests()) { let withWorkerHash = groups.get(test._workerHash); if (!withWorkerHash) { withWorkerHash = new Map(); groups.set(test._workerHash, withWorkerHash); } let withRequireFile = withWorkerHash.get(test._requireFile); if (!withRequireFile) { withRequireFile = { general: createGroup(test), parallel: [], }; withWorkerHash.set(test._requireFile, withRequireFile); } let insideParallel = false; for (let parent = test.parent; parent; parent = parent.parent) insideParallel = insideParallel || parent._parallelMode === 'parallel'; if (insideParallel) { const group = createGroup(test); group.tests.push(test); withRequireFile.parallel.push(group); } else { withRequireFile.general.tests.push(test); } } } const result: TestGroup[] = []; for (const withWorkerHash of groups.values()) { for (const withRequireFile of withWorkerHash.values()) { if (withRequireFile.general.tests.length) result.push(withRequireFile.general); result.push(...withRequireFile.parallel); } } return result; } class ListModeReporter implements Reporter { onBegin(config: FullConfig, suite: Suite): void { console.log(`Listing tests:`); const tests = suite.allTests(); const files = new Set(); for (const test of tests) { // root, project, file, ...describes, test const [, projectName, , ...titles] = test.titlePath(); const location = `${path.relative(config.rootDir, test.location.file)}:${test.location.line}:${test.location.column}`; const projectTitle = projectName ? `[${projectName}] › ` : ''; console.log(` ${projectTitle}${location} › ${titles.join(' ')}`); files.add(test.location.file); } console.log(`Total: ${tests.length} ${tests.length === 1 ? 'test' : 'tests'} in ${files.size} ${files.size === 1 ? 'file' : 'files'}`); } } export const builtInReporters = ['list', 'line', 'dot', 'json', 'junit', 'null', 'github', 'html'] as const; export type BuiltInReporter = typeof builtInReporters[number];