How to check for an undefined or null variable in JavaScript?

by

I think the most efficient way to test for “value is null or undefined” is

if ( some_variable == null ){
  // some_variable is either null or undefined
}

So these two lines are equivalent:

if ( typeof(some_variable) !== "undefined" && some_variable !== null ) {}
if ( some_variable != null ) {}

Note 1

As mentioned in the question, the short variant requires that some_variable has been declared, otherwise a ReferenceError will be thrown. However in many use cases you can assume that this is safe:

check for optional arguments:

function(foo){
    if( foo == null ) {...}

check for properties on an existing object

if(my_obj.foo == null) {...}

On the other hand typeof can deal with undeclared global variables (simply returns undefined). Yet these cases should be reduced to a minimum for good reasons, as Alsciende explained.

Note 2

This – even shorter – variant is not equivalent:

if ( !some_variable ) {
  // some_variable is either null, undefined, 0, NaN, false, or an empty string
}

so

if ( some_variable ) {
  // we don't get here if some_variable is null, undefined, 0, NaN, false, or ""
}

Note 3

In general it is recommended to use === instead of ==.
The proposed solution is an exception to this rule. The JSHint syntax checker even provides the eqnull option for this reason.

From the jQuery style guide:

Strict equality checks (===) should be used in favor of ==. The only
exception is when checking for undefined and null by way of null.

// Check for both undefined and null values, for some important reason. 
undefOrNull == null;

EDIT 2021-03:

Nowadays most browsers
support the Nullish coalescing operator (??)
and the Logical nullish assignment (??=), which allows a more concise way to
assign a default value if a variable is null or undefined, for example:

if (a.speed == null) {
  // Set default if null or undefined
  a.speed = 42;
}

can be written as any of these forms

a.speed ??= 42;
a.speed ?? a.speed = 42;
a.speed = a.speed ?? 42;

More Related Contents:

  1. Is there a standard function to check for null, undefined, or blank variables in JavaScript?
  2. What is the difference between null and undefined in JavaScript?
  3. How can I determine if a variable is ‘undefined’ or ‘null’?
  4. Why is null an object and what’s the difference between null and undefined?
  5. JavaScript checking for null vs. undefined and difference between == and ===
  6. Why is there a `null` value in JavaScript?
  7. How to resolve TypeError: Cannot convert undefined or null to object
  8. What reason is there to use null instead of undefined in JavaScript?
  9. JavaScript String concatenation behavior with null or undefined values
  10. When is null or undefined used in JavaScript? [duplicate]
  11. Is it better to return `undefined` or `null` from a javascript function? [closed]
  12. Should JSON include null values [closed]
  13. How can I check for an empty/undefined/null string in JavaScript?
  14. How can I check for “undefined” in JavaScript? [duplicate]
  15. How can I unset a JavaScript variable?
  16. variable === undefined vs. typeof variable === “undefined”
  17. How do I check for null values in JavaScript?
  18. Why does this JavaScript code print “undefined” on the console?
  19. Why `null >= 0 && null
  20. forEach on array of undefined created by Array constructor
  21. JavaScript “cannot read property “bar” of undefined [duplicate]
  22. Undefined values in Array(len) initializer
  23. How dangerous is it in JavaScript, really, to assume undefined is not overwritten?
  24. this is undefined inside arrow function
  25. Javascript – removing undefined fields from an object [duplicate]
  26. Undefined return value from the function call Javascritpt
  27. console.log(myFunction()) returns undefined
  28. JS checking deep object property existence [duplicate]
  29. How to check null objects in jQuery
  30. JSLint: was used before it was defined

Leave a Comment