JS: var Declaration Order

By Xah Lee. Date: . Last updated: .

Note: The use of var is deprecated since ES2015, due to its name hoisting complexity and name scope complexity [see JS: var Name Scope] , you should never use var. Use let instead. [see JS: let Declaration]

Variable declared with var has a behavior that is effectively equivalent to as if the declaration is moved to the top of the function block the var appears in, or top of source code file.

This is called name hoisting.

For example, the following:

console.log(x);
var x = 5;

is equivalent to:

var x;
console.log(x);
x = 5;

Here's a example showing the effect of name hoisting:

// example showing name hoisting

// accessing undeclared and unassigned var is a reference error
console.log(x);   // ReferenceError: x is not defined

// but accessing variable that's declared later is ok
console.log(n === undefined); // true

var n; // un-initiated var has value “undefined”

No Change to Assignment Order

Name hoisting moves the name to the top, but it does not move the assignment with it.

// example showing that assignment order matters. Name hoisting is about name only, not assignment
console.log(x === undefined); // true
var x = 5;

var Name Hoisting Inside Function

Name hoisting applies inside a function body too.

Inside a function body, var declaration is moved to the top in the function block.

// example showing variable name hoisting, inside a function body

var n = 3;

function f ()  {
    return n;
    var n;
};

console.log(f() === undefined); // true
// Because, the “var n” inside the function is moved to the top of function body

Here's another example. A typical loop inside a function:

function f ()  {

    // console.log(x); // ReferenceError: x is not defined

    console.log(i); // print “undefined”, but this is not an error

    for (var i = 1; i <= 3; i++) {
        console.log(i);
    }
}

f();

// prints
// undefined
// 1
// 2
// 3

Above is equivalent to:

function f ()  {
    var i;
    for (i = 1; i <= 3; i++) {
        console.log(i);
    }
}

f();

JS Variable

  1. Value Types
  2. let
  3. const
  4. var
  5. var Order
  6. var Scope
  7. Global Variable
  8. Destructuring Assignment
Like it? Help me by telling your friends. Or, Put $5 at patreon.

Or, Buy JavaScript in Depth

If you have a question, put $5 at patreon and message me.

Web Dev Tutorials