# jQuery.dequeue()

Categories: Data | Utilities

## jQuery.dequeue( element [, queueName] ) Returns: jQuery

Description: Execute the next function on the queue for the matched element.

- #### version added: 1.3jQuery.dequeue( element [, queueName] )

  elementA DOM element from which to remove and execute a queued function.

  queueNameA string containing the name of the queue. Defaults to `fx`, the standard effects queue.

Note: This is a low-level method, you should probably use `.dequeue()` instead.

When `jQuery.dequeue()` is called, the next function on the queue is removed from the queue, and then executed. This function should in turn (directly or indirectly) cause `jQuery.dequeue()` to be called, so that the sequence can continue.

### Example:

#### Use dequeue to end a custom queue function which allows the queue to keep going.

    <!DOCTYPE html>
    <html>
    <head>
      <style>div { margin:3px; width:50px; position:absolute;
            height:50px; left:10px; top:30px;
            background-color:yellow; }
      div.red { background-color:red; }  </style>
      <script src="http://code.jquery.com/jquery-1.7rc2.js"></script>
    </head>
    <body>
      <button>Start</button>  <div></div>
    <script>$("button").click(function () {
          $("div").animate({left:'+=200px'}, 2000);
          $("div").animate({top:'0px'}, 600);
          $("div").queue(function () {
            $(this).toggleClass("red");
             $.dequeue( this );
                  });
          $("div").animate({left:'10px', top:'30px'}, 700);
        });</script>

    </body>
    </html>

#### Demo: