O'Reilly

Limiting Variable Scope Using (function(){})();

By on  

Simply put, a scope limiter is a self-executing function that defines a variables, performs a task, and clears those variables so that their scope is limited to the function itself. Take the following JavaScript code, for example:

/* do task 1:   */
var lynx = $$('a');
var divs = $$('div');
//(do stuff with links and divs)

/* do task 2 */
var lynx = $$('a'); //error:  lynx already defined!
var lis = $$('li');
//(do stuff with links and list items)

Everything above works but the second task can "see" the variables used to complete task one. This is undesirable as those variables from the first task could cause problems with later tasks. The better way to complete the two tasks is to use scope limiters for each:

/* do task 1:   */
(function() {
	var lynx = $$('a');
	var divs = $$('div');
	//(do stuff with links and divs)
})();

/* do task 2 */
(function() {
	var lynx = $$('a');
	var lis = $$('li');
	//(do stuff with links and list items)
})();

Sweet! Now the variables from the first task have scope only within their executed function scope and cannot affect other JavaScript within the "parent" scope.

Clean code FTW! Keep these techniques in mind when you're writing code that will be repurposed!

O'Reilly Velocity Conference
Save 20% with discount code AFF20

Recent Features

  • fetch API

    One of the worst kept secrets about AJAX on the web is that the underlying API for it, XMLHttpRequest, wasn't really made for what we've been using it for.  We've done well to create elegant APIs around XHR but we know we can do better.  Our effort to...

  • 5 Awesome New Mozilla Technologies You’ve Never Heard Of

    My trip to Mozilla Summit 2013 was incredible.  I've spent so much time focusing on my project that I had lost sight of all of the great work Mozillians were putting out.  MozSummit provided the perfect reminder of how brilliant my colleagues are and how much...

Incredible Demos

  • Sliding Labels Using MooTools

    A week back I saw a great effect created by CSSKarma: input labels being animated horizontally. The idea is everything positive: elegant, practical, unobtrusive, and requires very little jQuery code. Luckily the effect doesn't require much MooTools code either! The HTML A...

  • Using Dotter for Form Submissions

    One of the plugins I'm most proud of is Dotter. Dotter allows you to create the typical "Loading..." text without using animated images. I'm often asked what a sample usage of Dotter would be; form submission create the perfect situation. The following...

Discussion

  1. Proper programming technique is to define variables before use, and to use as few (preferably no) global variables as possible. What you have done in the examples are a work-around.

    I love all your other articles though!

  2. In this case you could define $$('a') globally but my example was more trying to display the two closures working separately.

  3. Will

    Doesn’t this sort of miss the point of closures? I always thought that ‘closure’ meant it ‘closed’ over variables available to it when being declared, so those variables were available even when they went out of scope. It’s hard to explain, but this example might help:

      function makeClosure() {
        var t = "foo";
        return function() {
          alert(t + "bar");
        }
      }
    

    So, you’d call makeClosure, which would return a function. Whenever the returned function was called, the value of t (“foo”) would still be available to it (thus returning “foobar”) even though t’s scope had expired when makeClosure ended.

  4. TheBigBabou

    Sorry David, I don’t want to be offensive, but your code examples are no closures. What you are showing and describing is limiting variables to function scope.

    A closure is a function or codepointer which accesses variables outside its scope. Like here:

    (function () {
    
    var out = 1;
    
    window.setTimeout(function () {
      alert(out);
    }, 100);
    
    })()
    

    The closure here would be the function, which is the first parameter to setTimeout. It doesn’t declare a variable “out”, but is able to access “out” from its outer function scope. As long as a variable stores a reference to this function, “out” is not freed from memory as well.

  5. Ugh, updated my post as the terminology was off. This should make more sense and be more direct.

  6. Good post. Function scoping is a great way to keep your code clean. I often use a model like this:

    (function() {
        // all my private stuff (vars and funcs) go here
        var foo = 'I am scoped, no one else sees me';
    
        var apiMethods = {
            // publicly exposed methods here
            // these methods still have access to privately scoped members
            bar : function() { alert(foo); }
        };
    
        // expose api methods
        window.MyNameSpace = apiMethods;
    })();
    
    // alerts value of foo
    MyNameSpace.bar();
  7. hi David!

    i hope you can help me.
    is it possible to implement your “load more posts” widget (http://net.tutsplus.com/tutorials/javascript-ajax/create-a-twitter-like-load-more-widget/) on a blogger blog? i guess the problem is the php implementation..
    i like very much the script but i supose is not possible to implement it on a blogger thing…

    any idea on that, David? maybe a go around trick…
    thank you very much in advance
    antónio torres
    http://www.vaiumagasosa.com

  8. Devi

    Thanks David! Cleared up some stuff I never really understood in Javascript. This is a good page I came across on function scope in Javascript as well:

    http://www.programmerinterview.com/index.php/javascript/javascript-function-scope/

Wrap your code in <pre class="{language}"></pre> tags, link to a GitHub gist, JSFiddle fiddle, or CodePen pen to embed!

Recently on David Walsh Blog

  • Open Files from Command Line on OS X

    I'm as much of a fan of application UIs as anyone else but I'm finding myself working more and more from the command line lately.  Much of that is becoming obsessed with media manipulation but I'm forcing myself to use less UIs so that I...

  • Get Stock Quotes From Command Line

    When I conned my way into my first professional programming gig, I didn't really think much about money -- just that I was getting my foot in the door.  But as my career has gone on, I've been more aware of money, investing, and retirement.  I've recently...

  • Geolocation API

    One interesting aspect of web development is geolocation; where is your user viewing your website from? You can base your language locale on that data or show certain products in your store based on the user's location. Let's examine how you can...

  • Create an Image Preview from a Video

    Visuals are everything when it comes to media.  When I'm trying to decide whether to watch a video on Netflix, it would be awesome to see a trailer of some kind, but alas that isn't available.  When I'm looking to download a video on my computer,...

  • New:  Webdesigner News!

    A new and exciting website has recently been launched for web designers and developers. You likely spend hours every morning browsing through hundreds of posts on your RSS feeds, hoping to stumble across relevant stories. Webdesigner News was built to provide web designers and developers with...