Function resolveVerboseFlag

packages/vite/helpers/logging.ts:36–82

(options: ResolveOptions = {})

}

export function resolveVerboseFlag(options: ResolveOptions = {}): boolean {
	if (options.cache !== false && typeof cachedVerbose === 'boolean') {
		return cachedVerbose;
	}

	const { env = typeof process !== 'undefined' ? process.env : undefined, cliFlags } = options;
	let resolved: boolean | undefined;

	if (cliFlags && typeof cliFlags === 'object') {
		const cliVerbose = coerceBoolean(cliFlags.verbose ?? cliFlags.VERBOSE);
		if (typeof cliVerbose === 'boolean') {
			resolved = cliVerbose;
		}
	}

	if (resolved === undefined && options.useGlobalFlag !== false) {
		try {
			const globalVerbose = (globalThis as any)?.[GLOBAL_VERBOSE_FLAG];
			const coerced = coerceBoolean(globalVerbose);
			if (typeof coerced === 'boolean') {
				resolved = coerced;
			}
		} catch {}
	}

	if (resolved === undefined && env) {
		for (const key of ENV_VERBOSE_KEYS) {
			if (Object.prototype.hasOwnProperty.call(env, key)) {
				const envVerbose = coerceBoolean(env[key]);
				if (typeof envVerbose === 'boolean') {
					resolved = envVerbose;
					break;
				}
			}
		}
	}

	if (resolved === undefined) {
		resolved = options.defaultValue ?? false;
	}

	if (options.cache !== false) {
		cachedVerbose = resolved;
	}

	return resolved;
}

export function clearVerboseCache(): void {
	cachedVerbose = undefined;