@wordpress/eslint-plugin/rules/no-wp-process-env.js

ESLint plugin for WordPress development.

const NAMES = new Set(
	/** @type {const} */ ( [
		'GUTENBERG_PHASE',
		'IS_GUTENBERG_PLUGIN',
		'IS_WORDPRESS_CORE',
		'SCRIPT_DEBUG',
	] )
);

/** @type {import('eslint').Rule.RuleModule} */
module.exports = {
	meta: {
		type: 'problem',
		schema: [],
		fixable: true,
		messages: {
			useGlobalThis:
				'`{{ name }}` should not be accessed from process.env. Use `globalThis.{{name}}`.',
			noGutenbergPhase:
				'The GUTENBERG_PHASE environement variable is no longer available. Use IS_GUTENBERG_PLUGIN (boolean).',
		},
	},
	create( context ) {
		return {
			MemberExpression( node ) {
				const propertyNameOrValue = memberProperty( node );
				if ( ! propertyNameOrValue ) {
					return;
				}
				if ( ! NAMES.has( propertyNameOrValue ) ) {
					return;
				}

				if ( node.object.type !== 'MemberExpression' ) {
					return;
				}

				const obj = node.object;
				const envCandidateProperty = memberProperty( obj );
				if ( envCandidateProperty !== 'env' ) {
					return;
				}

				if (
					obj.object.type !== 'Identifier' ||
					obj.object.name !== 'process'
				) {
					return;
				}

				if ( propertyNameOrValue === 'GUTENBERG_PHASE' ) {
					context.report( {
						node,
						messageId: 'noGutenbergPhase',
					} );
					return;
				}

				context.report( {
					node,
					messageId: 'useGlobalThis',
					data: { name: propertyNameOrValue },
					fix( fixer ) {
						return fixer.replaceText(
							node,
							`globalThis.${ propertyNameOrValue }`
						);
					},
				} );
			},
		};
	},
};

/**
 * @param {import('estree').MemberExpression} node
 */
function memberProperty( node ) {
	switch ( node.property.type ) {
		case 'Identifier':
			return node.property.name;
		case 'Literal':
			return node.property.value;
		case 'TemplateLiteral':
			if (
				! node.property.expressions.length &&
				node.property.quasis.length === 1
			) {
				return node.property.quasis[ 0 ].value.raw;
			}
	}
	return null;
}