Usage of join(…):
wait for the end of the elements' current animations for a given queue name

How to wait for the end of the elements' current animations for a given queue name?

Compact syntax with timing methods:

1
$('.some').join(queue).doSome().jQueryStuff();

The join() method also provides a parameter to wait for an empty queue instead of the current animations' end.

Compare this to the old way with more syntactic fluff:

1
2
3
4
5
6
7
8
9
10
11
var waiting = $('.some').length;
if (!waiting) {
	$('.some').doSome().jQueryStuff();
} else {
  $('.some').queue(queue, function(next){
    next();
    if (!--waiting) {
      $('.some').doSome().jQueryStuff();
    }
  });
}