Function makeTestTextTree

src/test/helpers.ts:1448–1516

({ items, uriFilter, buffer = [], indent = 0, onlyFailures, onlyActive, sortByLabel }: { items?: vs.TestItemCollection, uriFilter?: vs.Uri, buffer?: string[]; indent?: number, onlyFailures?: boolean, onlyActive?: boolean, sortByLabel?: boolean } = {})

}

export function makeTestTextTree({ items, uriFilter, buffer = [], indent = 0, onlyFailures, onlyActive, sortByLabel }: { items?: vs.TestItemCollection, uriFilter?: vs.Uri, buffer?: string[]; indent?: number, onlyFailures?: boolean, onlyActive?: boolean, sortByLabel?: boolean } = {}): string[] {
	const controller = privateApi.testController!;
	const collection = items instanceof vs.Uri
		? controller.controller.items
		: items ?? controller.controller.items;

	const testItems: vs.TestItem[] = [];
	collection.forEach((item) => testItems.push(item));

	// Sort the items by their locations by default so we get stable results. Otherwise the order that items
	// are created would be used, which is usually source-order, but could be different if the user
	// selectively runs tests starting at the end of the file.
	// Allow overriding to sort by name for tests that are modifying files and running subsets of tests
	// and don't care about source order.
	sortBy(testItems, sortByLabel ? (item) => item.label : getSourceLine);

	for (const item of testItems) {
		const lastResult = controller.getLatestData(item);

		// Only include statuses on WF/Project nodes if we aren't filtering, otherwise
		// the status may look wrong (because it might be skewed by filtered out nodes).
		const isWorkspaceFolderOrProject = item.id.startsWith("WF:") || item.id.startsWith("PROJECT:");
		const includeStatus = !isWorkspaceFolderOrProject || !uriFilter;

		let nodeString = item.label;
		if (item.description)
			nodeString += ` [${item.description}]`;

		let includeNode = true;
		if (lastResult) {
			const status = "status" in lastResult ? lastResult?.status as TestStatus : undefined;
			if (includeStatus) {
				if (status)
					nodeString += ` ${TestStatus[status]}`;
				else if (lastResult.children.length)
					nodeString += ` ${TestStatus[lastResult.getHighestChildStatus(true)]}`;
			}

			// If this node has a different file to the parent, include that in the output.
			// Don't include it if it's already in the label though.
			if (lastResult.path && lastResult.parent?.path && lastResult.path !== lastResult.parent?.path && !item.label.endsWith(path.basename(lastResult.path)))
				nodeString += ` (${path.basename(lastResult.path)})`;

			const isStale = lastResult.isStale;
			const isFailure = status === TestStatus.Failed;
			if ((isStale && onlyActive) || (!isFailure && onlyFailures))
				includeNode = false;
		} else if (!isWorkspaceFolderOrProject) {
			nodeString += " (not found in model)";
		}

		// Stop filtering children at the point that we match the filter (eg. we match the suite, include all children).
		const nodeMatches = uriFilter && item.uri?.toString() === uriFilter.toString();
		const filterChildren = !nodeMatches;

		const childBuffer: string[] = [];
		makeTestTextTree({ items: item.children, uriFilter: filterChildren ? uriFilter : undefined, buffer: childBuffer, indent: indent + 1, onlyFailures, onlyActive, sortByLabel });