Function applyWebpackOptionsInterception

lib/config/normalization.js:614–697

(options)

 * @returns {{ options: WebpackOptionsNormalized, interception?: WebpackOptionsInterception }} options and interception
 */
const applyWebpackOptionsInterception = (options) => {
	// Return origin options when backCompat is disabled
	if (options.experiments.futureDefaults) {
		return {
			options
		};
	}

	// TODO webpack 6 - remove compatibility logic and move `devtools` fully into `devtool` with multi-type support
	let _devtool = options.devtool;
	/** @type {WebpackOptionsNormalized["devtool"]} */
	let cached;

	const devtoolBackCompat = () => {
		if (Array.isArray(_devtool)) {
			if (cached) return cached;
			// Prefer `all`, then `javascript`, then `css`
			const match = ["all", "javascript", "css"]
				.map((type) =>
					/** @type {Extract<WebpackOptionsNormalized["devtool"], EXPECTED_ANY[]>} */ (
						_devtool
					).find((item) => item.type === type)
				)
				.find(Boolean);

			// If `devtool: []` is specified, return `false` here
			return (cached = match ? match.use : false);
		}
		return _devtool;
	};

	/** @type {ProxyHandler<WebpackOptionsNormalized>} */
	const handler = Object.create(null);
	handler.get = (target, prop, receiver) => {
		if (prop === "devtool") {
			return devtoolBackCompat();
		}
		return Reflect.get(target, prop, receiver);
	};
	handler.set = (target, prop, value, receiver) => {
		if (prop === "devtool") {
			_devtool = value;
			cached = undefined;
			return true;
		}
		return Reflect.set(target, prop, value, receiver);
	};
	handler.deleteProperty = (target, prop) => {
		if (prop === "devtool") {
			_devtool = undefined;
			cached = undefined;
			return true;
		}
		return Reflect.deleteProperty(target, prop);
	};
	handler.defineProperty = (target, prop, descriptor) => {
		if (prop === "devtool") {
			_devtool = descriptor.value;