Encapsulation in JavaScript
A long time ago, I saw someone encapsulate their entire JavaScript block with code something like the code below:
(function() {
// ...
})(this);
Questions:
- Is the code above correct?
- What benefit is there to encapsulating the entire JavaScript block like denoted above?
Solution 1:
Yes, that's correct. It's called a self invoking anonymous function expression.
JavaScript variables have either function scope, or global scope. There is no block scope. Enclosing your code in a self invoking function like the one in your example creates a temporary local scope for single-use, immediately-run code, without polluting the global namespace.
Consider the following:
<html>
<body>
...
<script>
(function() {
var x = '';
function myFunction () {
alert('Hello: ' + x);
}
x = 'Bob';
myFunction();
alert(typeof x); // string
alert(typeof myFunction); // function
})();
alert(typeof x); // undefined
alert(typeof myFunction); // undefined
</script>
<script src="other-javascript.js"></script>
</body>
</html>
Whatever you declare in that self invoking function is held in a separate scope. The variable x and the function myFunction() cannot be accessed from anywhere else. The code in other-javascript.js won't see them, for example, and it would be free to declare another function myFunction() without conflicts.
Solution 2:
Also addition to the @Daniel's answer, passing this to the function is a common pattern to have a reference to the global object, for example:
(function(window){
})(this);
In browser scripting the global object has a property named window which refers to the global object itself, in other environments there is no window property.
Also, another thing that can be done is to specify an argument named undefined, because the undefined property is not described on the ECMAScript 3rd. Edition Standard (there is no guarantee that exist or not), and in some implementations the property is mutable, for example:
(function(window, undefined){
})(this);
In the above example, we have two local identifiers (which are a bit faster to resolve), window and undefined, only the first one is passed (this, which always refers to the global object in Global code (code that is outside of any function)), and the second, will contain the primitive undefined value, because we are not passing any value to it.
That pattern is used by some libraries like jQuery.