tags:

views:

354

answers:

3

I've seen some code where they just do this:

$().ready(function()
{
    ...
});

This is shorter than doing a document selector but is it the same thing?

+20  A: 

Slight change:

$(document).ready(function() {});

Is equal to:

$(function() {});

As of jQuery 1.4: $().ready(function() { }); no longer works correctly in all cases. From the release notes:

As of jQuery 1.4, if you pass no arguments in to the jQuery() method, an empty jQuery set will be returned. In previous versions of jQuery, a set containing the document node would be returned.

Nick Craver
According to http://jquery14.com/day-01/jquery-14 it actually still works in 1.4 but has been deprecated.
Justin Ethier
@Justin Ethier - There are cases it fails to work, best to avoid it all together since it doesn't behave the same. For example if you tried to chain it with bind or trigger...works in 1.3, doesn't in 1.4. Anything deprecated, just pretend it doesn't exist if you want to be safer later. I updated the answer to be a bit clearer on this, it is a valid distinction in case someone's using it now
Nick Craver
+7  A: 

According to the jQuery API docs, all three of the following syntaxes are equivalent:

  • $(document).ready(handler)
  • $().ready(handler) (but this is not recommended)
  • $(handler)

So apparently that syntax will work, but is not the recommended syntax.

According to the jQuery 1.4 Release Notes:

In jQuery 1.3, jQuery() returned a jQuery set containing just the document. in jQuery 1.4, it returns an empty jQuery set. This can be useful for creating an empty set and adding elements to it dynamically. Note: The jQuery().ready() technique still works in 1.4 but it has been deprecated. Please use either jQuery(document).ready() or jQuery(function(){}).

Justin Ethier
+4  A: 

Nick and Justin have got the right answers here, but since we're on the topic, I would recommend for portability to never use $ in the global scope. A few too many libraries use it for their own purposes, and you could run into compatibility problems if you need to mix them up. Instead, you can use the optional first parameter to the jQuery ready handler:

jQuery(function($) {

});

This sets $ to be a reference to jQuery in that function scope.

nickf
In a project that's explicitly jQuery-based, there's absolutely no problem with using $ in the global scope.
Pointy
yeah, until it's not explicitly jQuery based. It's 6 extra characters to type and it future-proofs your code. Also, it may actually make the code run marginally faster, since the `$` reference is in local scope.
nickf
I agree in function scope this is true, out inside document.ready and such though I have to disagree that all that extra typing now replaces a find/replace of `$(` and `$.` later, I've had to de-scope jQuery before and a Ctrl+Shift+H was able to take care of it in about 20 seconds. +1, inside plugins and all it's especially important.
Nick Craver