Just Wait
Wait what? The server response.
Just Wait is a lightweight jQuery utility that allows you to specify a function to be executed after a specified amount of time from the start of the AJAX request. If the AJAX request ends before the specified amount of time, the function will never be executed.
Not clear? Try the TEST TOOL.
Quick start
- Add the
just-wait.min.js
file to your page.<script src="just-wait.min.js"></script>
- [Optional] Adjust the
waitFor
parameter usingJustWait.options.waitFor
(see Time adjusting). - Add a
wait
call back to the jqXHR object. Example:$.get('url') // or $.getJSON, $.post, $.getScript, $.load, $.ajax .wait(() => { // <======= Wait callback }) .done((data) => { ... }) .fail(() => { ... }) .always(() => { // The AJAX request ends. Hide the loader. $loader.hide(); });
- [Optional] Adjust the
waitFor
parameter only for a single request:$.get({ url: 'url', waitFor: 500 }) // or $.getJSON, $.post, $.getScript, $.load, $.ajax .wait(() => { }) .done((data) => { ... }) .fail(() => { ... }) .always(() => { // The AJAX request ends. Hide the loader. $loader.hide(); });
Explanation
Suppose you have to display a loader while doing an AJAX request. I'm sure you are using a code similar to
$loader.show(); // Show the loader before starting the AJAX request
$.get('url') // or $.post or $.ajax
.done((data) => { ... })
.fail(() => { ... })
.always(() => {
// The AJAX request ends. Hide the loader.
$loader.hide();
});
Of course, this is good: the user will see a loader while waiting for the server response. But, if the response is returned almost immediately the user will see a fast show/hide of the loader (aka flickering). You don't want that.
Just Wait solves this problem. It allows you to specify a function to be executed after a specified amount of time from the start of the AJAX request. If the AJAX request ends before the specified amount of time, the function will never be executed. So, the previous code could be written as:
$.get('url') // or $.post or $.ajax
.wait(() => {
// Show the loader after 100ms (default), if the request doesn't end before.
$loader.show();
})
.done((data) => { ... })
.fail(() => { ... })
.always(() => {
// The AJAX request ends. Hide the loader.
$loader.hide();
});
See the below timeline to better understand how it works.
Time adjusting
You can globally specify the amount of time to wait before the wait
callback is executed by using the following code. Ensure that the code below is executed before any use of the wait
callback.
JustWait.options.waitFor = 100; // Default 100ms
You can also specify the waitFor
option for every request:
$.ajax({
url: 'url',
...
waitFor: 500 // ms
})
...
or
$.get({
url: 'url',
...
waitFor: 500 // ms
})
...
or
$.post({
url: 'url',
data: { id: 5 }
...
waitFor: 500 // ms
})
...