Basic jquery tutorial-deferred object usage _ jquery

Basic jquery tutorial-deferred object usage 1. What is a deferred object?

During website development, we often encounter some javascript operations that take a long time. Both asynchronous operations (for example, ajax reading server data) and synchronous operations (for example, traversing a large array) do not result immediately.

The usual practice is to specify the callback function for them ). Which functions should be called once they are finished.

However, jQuery has very weak functions in callback functions. To change this, the jQuery development team designed the deferred object.

Put simply, the deferred object is jQuery's callback function solution. In English, defer means "delay", so the deferred object means "delay" to a certain point in the future.

It solves the problem of time-consuming operations, provides better control over those operations, and unified programming interfaces. Its main functions can be summarized as four points. Next we will learn through the sample code step by step.

Ii. Link Writing of ajax operations

First, let's review the traditional jQuery ajax operations:

The Code is as follows:

$. Ajax ({
Url: "test.html ",
Success: function (){
Alert ("Haha, success! ");

},
Error: function (){
Alert ("error! ");
}

});

In the code above, $. ajax () accepts an object parameter. This object contains two methods: The success method specifies the callback function after the operation is successful, and the error method specifies the callback function after the operation fails.

$. After ajax () is completed, if jQuery of version 1.5.0 or earlier is used, the returned XHR object cannot be chained. If jQuery of version 1.5.0 or later is returned, the deferred object is returned, you can perform chained operations.

Now, the new method is as follows:

The Code is as follows:

$. Ajax ("test.html ")

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

As you can see, done () is equivalent to the success method, and fail () is equivalent to the error method. After the code is chained, the code readability is greatly improved.

3. Specify multiple callback functions for the same operation

A major benefit of the deferred object is that it allows you to add multiple callback functions freely.

The above code is used as an example. If I want to run another callback function after the ajax operation is successful, what should I do?

It's easy. Just add it to the back.

The Code is as follows:

$. Ajax ("test.html ")
. Done (function () {alert ("Haha, success! ");})
. Fail (function () {alert ("error! ");})
. Done (function () {alert ("Second callback function! ");});

Multiple callback functions can be added, which are executed in the order of addition.

4. Specify the callback function for multiple operations

Another major benefit of the deferred object is that it allows you to specify a callback function for multiple events, which is not traditionally written.

See the following code. It uses a new method $. when ():

The Code is as follows:

$. When ($. ajax ("test1.html"), $. ajax ("test2.html "))
. Done (function () {alert ("Haha, success! ");})
. Fail (function () {alert ("error! ");});

This Code indicates that two operations are performed first $. ajax ("test1.html") and $. ajax ("test2.html"). If all functions are successful, run the callback function specified by done (). if one or both fails, run fail () the specified callback function.

5. Callback Function interfaces for common operations (I)

The biggest advantage of the deferred object is that it extends this callback function interface from ajax operations to all operations. That is to say, any operation, whether ajax or local, asynchronous or synchronous, can use various methods of the deferred object to specify the callback function.

Let's look at a specific example. Assume that there is a very time-consuming wait operation:

The Code is as follows:

Var wait = function (){

Var tasks = function (){

Alert ("execution completed! ");

};

SetTimeout (tasks, 5000 );

};

What should we do if we specify a callback function for it?

Naturally, you will think that you can use $. when ():

The Code is as follows:

$. When (wait ())

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

However, in this case, the done () method will be executed immediately and will not function as a callback function. The reason is that the $. when () parameter can only be a deferred object, so you must rewrite wait:

The Code is as follows:

Var dtd = $. Deferred (); // create a new deferred object

Var wait = function (dtd ){

Var tasks = function (){

Alert ("execution completed! ");

Dtd. resolve (); // Changes the execution status of the deferred object

};

SetTimeout (tasks, 5000 );

Return dtd;

};

Now, the wait () function returns the deferred object, which can be added with a chain operation.

The Code is as follows:

$. When (wait (dtd ))

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

After the wait () function is run, the callback function specified by the done () method is automatically run.

6. deferred. resolve () method and deferred. reject () method

If you look at it carefully, you will find that there is another area in the above wait () function that I have not explained. What is the role of dtd. resolve?

To clarify this problem, we need to introduce a new concept "execution status ". JQuery requires that the deferred object has three execution states: incomplete, completed, and failed. If the execution status is "completed" (resolved), the deferred object immediately calls the callback function specified by the done () method. If the execution status is "failed", call fail () the callback function specified by the method. If the execution status is "incomplete", the system continues to wait, or calls the callback function specified by the progress () method (added in jQuery1.7 ).

In the preceding ajax operations, the deferred object automatically changes its execution status based on the returned results. However, in the wait () function, the execution status must be manually specified by the programmer. Dtd. resolve () indicates that the done () method is triggered by changing the execution status of the dtd object from "unfinished" to "completed.

Similarly, a deferred. reject () method also exists to change the execution status of the dtd object from "incomplete" to "failed", thus triggering the fail () method.

The Code is as follows:

Var dtd = $. Deferred (); // create a new Deferred object

Var wait = function (dtd ){

Var tasks = function (){

Alert ("execution completed! ");

Dtd. reject (); // Changes the execution status of the Deferred object.

};

SetTimeout (tasks, 5000 );

Return dtd;

};

$. When (wait (dtd ))

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

7. deferred. promise () method

There is still a problem with the above method. That is, dtd is a global object, so its execution status can be changed from the external.

See the following code:

The Code is as follows:

Var dtd = $. Deferred (); // create a new Deferred object

Var wait = function (dtd ){

Var tasks = function (){

Alert ("execution completed! ");

Dtd. resolve (); // Changes the execution status of the Deferred object

};

SetTimeout (tasks, 5000 );

Return dtd;

};

$. When (wait (dtd ))

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

Dtd. resolve ();

I added a line of dtd. resolve () at the end of the Code, which changed the execution status of the dtd object. As a result, the done () method was executed immediately and jumped out of "Haha, succeeded! "Prompt box, wait 5 seconds and then jump out." The execution is complete! "Prompt box.

To avoid this, jQuery provides the deferred. promise () method. The function is to return another deferred object on the original deferred object, which only opens Methods unrelated to the change of execution status (such as the done () method and fail () method ), shielding methods (such as the resolve () method and reject () method) related to changing the execution status so that the execution status cannot be changed.

See the following code:

The Code is as follows:

Var dtd = $. Deferred (); // create a new Deferred object

Var wait = function (dtd ){

Var tasks = function (){

Alert ("execution completed! ");

Dtd. resolve (); // Changes the execution status of the Deferred object

};

SetTimeout (tasks, 5000 );

Return dtd. promise (); // return the promise object

};

Var d = wait (dtd); // create a new d object and perform operations on this object.

$. When (d)

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

D. resolve (); // at this time, this statement is invalid

In the above Code, the wait () function returns the promise object. Then, we bind the callback function to this object instead of the original deferred object. The advantage is that the execution status of this object cannot be changed. To change the execution status, you can only operate on the original deferred object.

However, a better way is to change the dtd object to the internal object of the wait () function, as stated by allenm.

The Code is as follows:

Var wait = function (dtd ){

Var dtd = $. Deferred (); // inside the function, create a new Deferred object.

Var tasks = function (){

Alert ("execution completed! ");

Dtd. resolve (); // Changes the execution status of the Deferred object

};

SetTimeout (tasks, 5000 );

Return dtd. promise (); // return the promise object

};

$. When (wait ())

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

8. callback function interface for common operations (medium)

Another method to prevent external changes in execution status is to use the deferred Object Construction Function $. Deferred ().

At this time, the wait function remains unchanged, and we pass it directly to $. Deferred ():

The Code is as follows:

$. Deferred (wait)

. Done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

JQuery rules, $. deferred () can accept a function name (Note: The function name) as the parameter, $. the Deferred object generated by deferred () is used as the default parameter of this function.

9. Callback Function interfaces for common operations (below)

In addition to the above two methods, we can also directly deploy the deferred interface on the wait object.

The Code is as follows:

Var dtd = $. Deferred (); // generate a Deferred object

Var wait = function (dtd ){

Var tasks = function (){

Alert ("execution completed! ");

Dtd. resolve (); // Changes the execution status of the Deferred object

};

SetTimeout (tasks, 5000 );

};

Dtd. promise (wait );

Wait. done (function () {alert ("Haha, success! ");})

. Fail (function () {alert ("error! ");});

Wait (dtd );

The key here is the dtd. promise (wait) line. Its function is to deploy the Deferred interface on the wait object. Only with this line can done () and fail () be called directly on wait ().

10. Conclusion: deferred object Method

We have discussed several methods for the deferred object. The following is a summary:

(1) $. Deferred () generates a deferred object.

(2) deferred. done () specifies the callback function when the operation is successful.

(3) deferred. fail () specifies the callback function when the operation fails.

(4) deferred. when promise () does not have a parameter, a new deferred object is returned, and its running status cannot be changed. When a parameter is accepted, the deferred interface is deployed on the parameter object.

(5) deferred. resolve () manually changes the running status of the deferred object to "completed", and immediately triggers the done () method.

(6) deferred. reject () This method is similar to deferred. the opposite is true for resolve (). After the call, the running status of the deferred object is changed to "failed", and the fail () method is triggered immediately.

(7) $. when () specifies the callback function for multiple operations.

In addition to these methods, the deferred object has two important methods, which are not covered in the previous tutorial.

(8) deferred. then ()

Sometimes, you can combine done () and fail () to save trouble. This is the then () method.

$. When ($. ajax ("/main. php "))

. Then (successFunc, failureFunc );

If then () has two parameters, the first parameter is the callback function of the done () method, and the second parameter is the callback method of the fail () method. If then () has only one parameter, it is equivalent to done ().

(9) deferred. always ()

This method is also used to specify the callback function. Its function is to always execute whether deferred. resolve () or deferred. reject () is called.

The Code is as follows:

$. Ajax ("test.html ")

. Always (function () {alert ("executed! ");});