Disallow the use of process.env

This rule was deprecated in ESLint v7.0.0. Please use the corresponding rule in eslint-plugin-n.

The process.env object in Node.js is used to store deployment/configuration parameters. Littering it through out a project could lead to maintenance issues as it’s another kind of global dependency. As such, it could lead to merge conflicts in a multi-user setup and deployment issues in a multi-server setup. Instead, one of the best practices is to define all those parameters in a single configuration/settings file which could be accessed throughout the project.

Rule Details

This rule is aimed at discouraging use of process.env to avoid global dependencies. As such, it will warn whenever process.env is used.

Examples of incorrect code for this rule:

Open in Playground
/*eslint no-process-env: "error"*/

if(process.env.NODE_ENV === "development") {

Examples of correct code for this rule:

Open in Playground
/*eslint no-process-env: "error"*/

var config = require("./config");

if(config.env === "development") {

When Not To Use It

If you prefer to use process.env throughout your project to retrieve values from environment variables, then you can safely disable this rule.


This rule was introduced in ESLint v0.9.0.

Further Reading


Change Language