jQuery 1.2.2: 2nd Birthday Present

Posted on by

On the 2nd anniversary of jQuery’s release we’re proud to bring you a brand new release of jQuery. This is primarily a bug fix release for jQuery 1.2. You can view the full list of what was fixed on the bug tracker.


jQuery 1.2.2:

If you wish to checkout the full release from the Subversion repository, you can do so by following the following instructions and checking out the source from the following location:

svn co http://jqueryjs.googlecode.com/svn/tags/1.2.2

Important Changes

A lot of hard work was put into this release by Brandon Aaron and David Serduke. David is a new addition to the jQuery core development team and has been making significant contributions – please help us in welcoming him!

Primarily, this has been a bug fix and optimization release. We landed over 120 bug fixes and our test suite now has over 1157 tests in it – which we are quire proud of.

300% Speed Improvements to $(DOMElement)

Once again, we’ve taken a step at micro-improving the most-used features in jQuery. Specifically, the use of passing a DOM element into the jQuery function. (Most frequently used when you see stuff like $(this) in your code.)

Here’s a quick peak at some of the speed jumps that you can expect in all the major browsers:

Browser 1.2.1 (ms) 1.2.2 (ms)
Firefox 2 0.041 0.015
Firefox 3 0.033 0.01
Safari 3 0.017 0.005
Opera 9 0.023 0.004
Internet Explorer 6 0.04 0.03

.ready() Overhaul

The document ready function has been long due for some extra love. We’ve made a number of specific changes.

* Internet Explorer document ready drastically improved. We use a new technique inspired by Diego Perini. It allows us to not have to do a document.write() anymore, which is really fantastic.
* All browsers now wait for CSS to be ready, in addition to just the DOM. In reality, it’s not just a vanilla document ready anymore – but we found that users, overwhelmingly, needed to wait for document styling to be active (such as knowing if an element is visible, or what its height is). Specifically we’ve added improvements to Safari and Opera to make this possible.
* $(document).bind("ready", fn); – You can now watch for the document ready event via the traditional .bind() function. Of course, .ready() still works as you would expect it to.

.bind(“mouseenter”) / .bind(“mouseleave”)

The functionality that was the core of the .hover() function has been split out into two new cross-browser events: mouseenter and mouseleave. These are different from mouseover and mouseout as those events will fire as you move in and out of child elements (which is generally not desired). For example, the following are both valid and work perfectly in jQuery 1.2.2:

}, function(){
$("li").bind("mouseenter", function(){
}).bind("mouseleave", function(){


We have a new plugin, written by Brandon Aaron, based on the new Event API which adds mousewheel event support to jQuery core. This will allow you to write things like:

$("div").bind("mousewheel", function(event, delta){
  if ( delta < 0 )

Complex :not()

Even though it's not part of the CSS 3 specification it's been a common feature request - so you can now do complex expressions in your :not() selectors. For example, the following now work:


Accept Headers

For normal jQuery Ajax operations we now send an extra Accept header to let the server know what kind of content we're looking for. If you specify a dataType argument then we'll take care of all the header setting for you. We currently send the following headers for each dataType.

  • xml "application/xml, text/xml"
  • html "text/html"
  • script "text/javascript, application/javascript"
  • json "application/json, text/javascript"
  • text "text/plain"
  • Everything else: "*/*"

Bug Fixes

Here's a sampling of some of the functionality that's seen some important overhauling.

* .clone() overhaul
* Script evaluation overhaul
* height() / width() overhaul
* Cross-frame DOM manipulation
* A few memory leaks have been resolved

Event API

There's a new API for dealing with events. You can now create your own custom event types (with custom ways of being set up and torn down). Effectively, it allows you to go beyond simple event triggering and create a full scheme for attaching, handling, and tearing down events on an element. A demonstration plugin was created by Brandon Aaron that you can use to learn the powerful new API.

51 thoughts on “jQuery 1.2.2: 2nd Birthday Present

  1. Wooohoo! Fantastic changelog, thank you jQuery team, happy birthday! This library relieves me on a daily basis from nearly all JS pain I used to have. :) Keep rockin’!

  2. The new Event API and speed improvements to $() are both very good news. We were waiting for a even faster elm selector, now we got that.

    from Brazil, Marco Gomes

  3. Pingback: jQuery 1.2.2 ha visto la luz | aNieto2K

  4. Happy Birthday!

    Can the DOM element passing also gain speed in IE7 (not a major browser?)?

    Isn’t birthday donation day :)

  5. Michaël on said:

    Wow, each of your ‘bug fix release’ is always full of new features, not only fixes! :-D
    Thanks a lot for this amazing work! Happy Birthday jQuery!

  6. Pingback: Bram.us » jQuery 1.2.2 Released

  7. Bohdan Ganicky on said:

    Clap, clap again. I think this is good time to add “paypal subscribe” button next to the “donate” one. Instead of $10 from time to time, $10 every month. jQuery really deserves it, doesn’t it?

  8. Hooray! Another great release, and it looks like another winner :) John, between working on FF3, jQuery and Writing books I don’t know where you get the time :) Congrats to the whole jQuery core team too :)

  9. Pingback: Happy Birthday jQuery! Version 1.2.2 released « Rip’s Domain

  10. Pingback: jQuery 1.2.2: 2nd Birthday Present « outaTiME

  11. Pingback: jQuery Minuteâ„¢ » jQuery 1.2.2 Released

  12. Pingback: Publicado jQuery 1.2.2 « Origen Abierto Weblog

  13. Pingback: Fusioncube » Blog Archive » jQuery 1.2.2 Released

  14. Thanks for continuing to work on the best javascript toolkit out there.
    I’ve been using it for awhile and it just keeps getting better.
    It’s helped me reduce so much js code. I’m still on the tip of an iceberg when it comes to knowing all this can do.

    I’ll wait for for any small “opps” bug fixes before I roll it out.

  15. I love you man!!! You just saved me from hours of IE JavaScript debugging HELL! Thanks so, so much. The jQuery team is top notch!

  16. Pingback: Infovore » links for 2008-01-15

  17. Pingback: links for 2008-01-16 « Gevã Schaefer

  18. Pingback: a work on process » links for 2008-01-16

  19. Pingback: links for 2008-01-16 « Mandarine

  20. Pingback: jQuery 1.2.2 » Code Candies

  21. Pingback: [anniversaire] JQuery 1.2.2 pour les 2 ans de JQuery! « Antoine Guiral : apprenti du web 2.0

  22. Hi, i cant found a printable documentation of the 1.2.x version of jQuery. This is very usefull for a fast reference. Also y try to build one but i cant found a updated jquery-docs-xml.xml

    There’s a plan to update o release a print friendly version?

    Thanks for you work and this awesome library


  23. Alec Munro on said:


    Our main use of JQuery(a test results application) is now 2.5X faster when building result pages (which is basically all it does). Awesome.

    Thanks very much for your work on this, and I look forward to seeing it progress.

  24. ethodaddy on said:

    hey guys, great job and thanks for all the work you have done with jquery. I have found that some plugins stop working with this release an example being Sam Collett’s Select box manipulation. all seems fine but the addAjaxOption doesn’t work. I’m working on fixing the issue and will report a bug if need be.

    thanks again for the great job on this release….

  25. Pingback: VCL for PHP development blog » jQuery 1.2.2