disableError()

Author: enVolt

README.md

@@ -122,6 +122,30 @@ if (process.env.NODE_ENV === 'production') {
 }
 ```
 
+### env.disableErrors()
+
+`getenv` won't throw any error. If a fallback value is provided, that will be returned, else `undefined` is returned.
+
+```javascript
+getenv.disableErrors();
+console.log(getenv("RANDOM"));
+// undefined
+```
+
+### env.enableErrors()
+
+Revert the effect of `disableErrors()`.
+
+```javascript
+getenv.disableErrors();
+console.log(getenv("RANDOM"));
+// undefined
+
+getenv.enableErrors();
+console.log(getenv("RANDOM"));
+// Error: GetEnv.Nonexistent: RANDOM does not exist and no fallback value provided.
+```
+
 ## Changelog
 
 ### v0.6.0
@@ -149,6 +173,7 @@ if (process.env.NODE_ENV === 'production') {
 - Jonas Dohse <[email protected]>
 - Jan Lehnardt (@janl): `getenv.multi()` support.
 - Tim Ruffles <[email protected]>: `disableFallbacks()`, `url()`
+- Ashwani Agarwal <[email protected]>: `disableErrors()`, `enableErrors()`
 
 ## License
 

lib/getenv.js

@@ -2,10 +2,14 @@ var util = require("util");
 var url = require("url");
 
 var fallbacksDisabled = false;
+var throwError = true;
 
 function _value(varName, fallback) {
   var value = process.env[varName];
   if (value === undefined) {
+    if (fallback === undefined && !throwError) {
+      return value;
+    }
     if (fallback === undefined) {
       throw new Error('GetEnv.Nonexistent: ' + varName + ' does not exist ' +
                       'and no fallback value provided.');
@@ -127,4 +131,12 @@ getenv.enableFallbacks = function() {
   fallbacksDisabled = false;
 };
 
+getenv.disableErrors = function() {
+  throwError = false;
+};
+
+getenv.enableErrors = function() {
+  throwError = true;
+};
+
 module.exports = getenv;

package.json

@@ -6,7 +6,8 @@
     "Moritz von Hase",
     "Jonas Dohse <[email protected]>",
     "Jan Lehnardt",
-    "Tim Ruffles <[email protected]>"
+    "Tim Ruffles <[email protected]>",
+    "Ashwani Agarwal <[email protected]>"
   ],
   "version": "0.6.0",
   "homepage": "https://github.com/ctavan/node-getenv",

test/disableErrors.js

@@ -0,0 +1,24 @@
+var assert = require('assert');
+
+var getenv = require('../lib/getenv');
+
+var tests = {};
+
+tests['getenv.disableErrors() should disable any errors'] = function() {
+  getenv.disableErrors();
+  assert.strictEqual(getenv.string("url", "http://localhost"), 'http://localhost');
+  assert(getenv.string("url"), undefined);
+};
+
+tests['getenv.enableErrors() should enable errors'] = function () {
+  getenv.enableErrors();
+  assert.throws(function() {
+    getenv.string("url");
+  });
+  assert.strictEqual(getenv.string("url", "http://localhost"), 'http://localhost');
+}
+
+Object.keys(tests).forEach(function(key) {
+  console.log('Test: %s', key);
+  tests[key]();
+});

test/fallbacks.js

@@ -13,7 +13,6 @@ tests['getenv.disableFallbacks() makes relying on fallbacks an error'] = functio
   getenv.enableFallbacks();
 };
 
-
 Object.keys(tests).forEach(function(key) {
   console.log('Test: %s', key);
   tests[key]();