DOMNodeInserted is deprecated in the DOM Level 3 Events recommendation, along with all the other mutation events:<p><a href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeInserted" rel="nofollow">http://www.w3.org/TR/DOM-Level-3-Events/#event-type-DOMNodeI...</a><p>They have been deprecated because they perform poorly:<p>> Firefox, for example, when it realizes that a mutation event has been turned on, instantly goes into an incredibly-slow code path where it has to fire events at every single DOM modification. This means that doing something like .innerHTML = "foo" where it wipes out 1000 elements would fire, at least 1000 + 1 events (1000 removal events, 1 addition event).<p><a href="http://lists.w3.org/Archives/Public/www-dom/2009AprJun/0072.html" rel="nofollow">http://lists.w3.org/Archives/Public/www-dom/2009AprJun/0072....</a><p>> Mutation Events are widely acknowledged as “slow” in terms of the real performance degradation that occurs on websites that use them heavily for tracking changes to the DOM<p><a href="http://www.w3.org/2008/webapps/wiki/MutationReplacement" rel="nofollow">http://www.w3.org/2008/webapps/wiki/MutationReplacement</a>
Why are you comparing this to `jQuery(document).ready()`? Apples and oranges.<p>You say it’s faster, but fail to provide any numbers / a jsPerf test case. I’m sure it’s faster to execute `waituntilexists()` <i>initially</i>, but if you take into account it uses an 5ms interval in which it traverses the DOM for the same elements over and over again until they’re finally found, it seems it probably has a negative impact on performance overall.<p>What’s wrong with event delegation anyway?
The polling approach is already used in the YUI2' onAvailable method.
<a href="http://yui.yahooapis.com/2.9.0/build/event/event.js" rel="nofollow">http://yui.yahooapis.com/2.9.0/build/event/event.js</a><p>But your code should be faster -because you are polling at the 5ms interval!
I like the idea and it does seem that it could reduce the time that your JavaScript code has to wait before it can run. However, in reality most real JavaScript front end code frameworks require not just one element but multiple elements, and nested elements. I would be hesitant to start running JavaScript just because one element was ready unless I was sure that other elements that my code referenced or manipulated were also ready. I'm sure it would be possible to make a version that allowed you to specify a list of elements to wait for before running code, but then that creates a nightmare for code maintenance, keeping track of the entire list of elements that your JavaScript requires. For me the jQuery(document).ready() method seems easier and more reliable.
Quick remarks :<p>* I could test it myself, but I expected to have in the article detailed information on the different possible states the document can have when my callback is called. The questions I know the answer when waiting for the whole document to be loaded : Is it half loaded ? What is the DOM state ? Is completely loaded ? If not, have the document JavaScript code been entirely ran ? and so on. This kind of question left unanswered often lead to hard bites.<p>* why using "itself" ? I would have used a "sensible default" : when no context is given, use the waited DOM object instead of an arbitrary value (document), and use something else when it is explicitly given. The "itself" thing should be left as an internal flag IMHO.
Does someone have a really good example of where this would be useful? The description is basically, "When this element exists, do something" but what is the something you'd do? If it's styling, that should be done in CSS. If it's event handlers, that can be done with `.live()` or `.delegate()`.<p>I'd also like to see some benchmarks to back up the assertion that this is faster. The DOM modification events are generally accepted as slow and it seems like this is leaving a handler attached for the duration of the page's existence.
This script is amazing i use for load cufon i try<p>/<i>Cufon.DOM.ready(function() {</i>/
/<i>$(window).load(function () {</i>/
/<i>$(document).ready(function() {</i>/
/<i>Cufon.DOM.ready(function() {</i>/<p>And now is 40% faster