5 Ways to Make Ajax Calls with jQuery

5 Ways to Make Ajax Calls with jQuery

on Aug 18th 2009 with 181 comments
Tutorial Details
  • Topic: jQuery
  • Difficulty: Beginner
  • Estimated Completion Time: 20 minutes

There are at least five ways to make AJAX calls with the jQuery library. For beginners, however, the differences between each can be a bit confusing. In this tutorial, we’ll line them up and make a comparison. Additionally. we’ll review how to inspect these AJAX calls with Firebug as well.


What is AJAX

This section is for those who have no idea what AJAX is. If you don’t fall into this category, feel free to skip to the next section.

AJAX stands for asynchronous JavaScript and XML. If you see another term XHR, which is shorthand for XML HTTP request, it’s the same thing. Don’t be afraid of this jargon; AJAX is not rocket science.

  • In Gmail, switch from inbox to draft. Part of the page is changed, but the page is not refreshed. You remain on the same page. Url has not changed (except for the #draft at the end of the url, but that’s still the same webpage).
  • In Google Reader, select a feed. The content changes, but you are not redirected to another url.
  • In Google Maps, zoom in or zoom out. The map has changed, but you remain on the same page.

The key to AJAX’s concept is “asynchronous”. This means something happens to the page after it’s loaded. Traditionally, when a page is loaded, the content remains the same until the user leaves the page. With AJAX, JavaScript grabs new content from the server and makes changes to the current page. This all happena within the lifetime of the page, no refresh or redirection is needed.

Caching AJAX

Now we should know what AJAX actually is. And we know that, when Gmail refreshes some content without redirection, an AJAX call is made behind the scenes. The requested content can either be static (remains exactly the same all the time, such as a contact form or a picture) or dynamic (requests to the same url get different responses, such as Gmail’s inbox where new mails may show up any time).

For static content, we may want the response cached. But for dynamic content, which can change in a second’s time, caching AJAX becomes a bug, right? It should be noted that Internet Explorer always caches AJAX calls, while other browsers behave differently. So we’d better tell the browser explicitly whether or not AJAX should be cached. With jQuery, we can accomplish this simply by typing:

  1. $.ajaxSetup ({
  2.     cache: false
  3. });

1. load(): Load HTML From a Remote URL and Inject it into the DOM

The most common use of AJAX is for loading HTML from a remote location and injecting it into the DOM. With jQuery’s load() function, this task is a piece of cake. Review this demo and we’ll go over some uses one by one.

Minimal Configuration

Click on the first button named “load().” A piece of HTML is injected into the page, exactly what we were talking about. Let’s see what’s going on behind the scenes.

Below is the JavaScript code for this effect:

  1.     $.ajaxSetup ({
  2.         cache: false
  3.     });
  4.     var ajax_load = “<img src=’img/load.gif’ alt=’loading…’ />”;
  5. //  load() functions
  6.     var loadUrl = “ajax/load.php”;
  7.     $(“#load_basic”).click(function(){
  8.         $(“#result”).html(ajax_load).load(loadUrl);
  9.     });
  1. $.ajaxSetup forces the browser NOT to cache AJAX calls.
  2. After the button is clicked, it takes a little while before the new HTML is loaded. During the loading time, it’s best to show an animation to provide the user with some feedback to ensure that the page is currently loading. The “ajax_load” variable contains the HTML of the loading sign.
  3. “ajax/load.php” is the url from which the HTML is grabbed.
  4. When the button is clicked, it makes an AJAX call to the url, receives the response HTML, and injects it into the DOM. The syntax is simply $(“#DOM”).load(url). Can’t be more straightforward, hah?

Now, let’s explore more details of the request with Firebug:

  1. Open Firebug.
  2. Switch to the “Net” tab. Enable it if it’s disabled. This is where all HTTP request in the browser window are displayed.
  3. Switch to “XHR” tab below “Net”. Remember the term “XHR?” It’s the request generated from an AJAX call. All requests are displayed here.
  4. Click on the “load()” button and you should see the following.

The request is displayed, right? Click on the little plus sign to the left of the request, more information is displayed.

Click on the “Params” tab. Here’s all parameters passed through the GET method. See the long number string passed under a “_” key? This is how jQuery makes sure the request is not cached. Every request has a different “_” parameter, so browsers consider each of them to be unique.

Click on the “Response” tab. Here’s the HTML response returned from the remote url.

Load Part of the Remote File

Click on “load() #DOM” button. We notice that only the Envato link is loaded this time. This is done with the following code:

  1. $(“#load_dom”).click(function(){
  2.     $(“#result”)
  3.         .html(ajax_load)
  4.         .load(loadUrl + ” #picture”);
  5. });

With load(url + “#DOM”), only the contents within #DOM are injected into current page.

Pass Parameters Through the GET Method

Click on the “load() GET” button and open firebug.

  1. $(“#load_get”).click(function(){
  2.     $(“#result”)
  3.         .html(ajax_load)
  4.         .load(loadUrl, “language=php&version=5”);
  5. });

By passing a string as the second param of load(), these parameters are passed to the remote url in the GET method. In Firebug, these params are shown as follows:

Pass Parameters Through the POST Method

Click on the “load() POST” button and open Firebug.

  1. $(“#load_post”).click(function(){
  2.     $(“#result”)
  3.         .html(ajax_load)
  4.         .load(loadUrl, {language: “php”, version: 5});
  5. });

If parameters are passed as an object (rather than string), they are passed to the remote url in the POST method.

Do Something on AJAX Success

Click on “load() callback” button.

  1. $(“#load_callback”).click(function(){
  2.     $(“#result”)
  3.         .html(ajax_load)
  4.         .load(loadUrl, null, function(responseText){
  5.             alert(“Response:\n” + responseText);
  6.         });
  7. });

A function can be passed to load() as a callback. This function will be executed as soon as the AJAX request is completed successfully.

2. $.getJSON(): Retrieve JSON from a Remote Location

Now we’ll review the second AJAX method in jQuery.

JSON (JavaScript Object Notation) is a lightweight data-interchange format. It’s very convenient when exchanging data programmatically with JSON.

Let’s review an example.

Find the $.getJSON() section in the demo page, type in some words in your native language, and click detect language.

  1. //  $.getJSON()
  2.     var jsonUrl = “ajax/json.php”;
  3.     $(“#getJSONForm”).submit(function(){
  4.         var q = $(“#q”).val();
  5.         if (q.length == 0) {
  6.             $(“#q”).focus();
  7.         } else {
  8.             $(“#result”).html(ajax_load);
  9.             $.getJSON(
  10.                 jsonUrl,
  11.                 {q: q},
  12.                 function(json) {
  13.                     var result = “Language code is \”<strong>” + json.responseData.language + “\””;
  14.                     $(“#result”).html(result);
  15.                 }
  16.             );
  17.         }
  18.         return false;
  19.     });

Let’s jump to Line 9:

  1. $.getJSON doesn’t load information directly to the DOM. So the function is $.getJSON, NOT $(“#result”).getJSON. (There are pairs of similar looking functions in jQuery such as $.each() and each(). Check out their respective documentation for more information.)
  2. $.getJSON accepts three parameters. A url, parameters passed to the url and a callback function.
  3. $.getJSON passes parameters in GET method. POSTing is not possible with $.getJSON.
  4. $.getJSON treats response as JSON.

$.getJSON’s function name is NOT camel-cased. All four letters of “JSON” are in uppercase.

Look at the response in JSON format in Firebug. It’s returned from Google Translate API. Check out ajax/json.php in source files to see how language detection works.

3. $.getScript(): Load JavaScript from a Remote Location

We can load JavaScript files with $.getScript method. Click on “Load a Remote Script” button in the demo page; let’s review the code for this action.

  1. //  $.getScript()
  2.     var scriptUrl = “ajax/script.php”;
  3.     $(“#getScript”).click(function(){
  4.         $(“#result”).html(ajax_load);
  5.         $.getScript(scriptUrl, function(){
  6.             $(“#result”).html(“”);
  7.         });
  8.     });
  1. $.getScript accepts only two parameters, a url, and a callback function.
  2. Neither the GET nor POST params can be passed to $.getScript. (Of course you can append GET params to the url.)
  3. JavaScript files don’t have to contain the “.js” extension. In this case, the remote url points to a PHP file. Let your imagination fly and you can dynamically generate JavaScript files with PHP.

See the response JavaScript in Firebug.

4. $.get(): Make GET Requests

$.get() is a more general-purpose way to make GET requests. It handles the response of many formats including xml, html, text, script, json, and jonsp. Click on the “$.get()” button in the demo page and see the code.

  1. //  $.get()
  2.     $(“#get”).click(function(){
  3.         $(“#result”).html(ajax_load);
  4.         $.get(
  5.             loadUrl,
  6.             {language: “php”, version: 5},
  7.             function(responseText){
  8.                 $(“#result”).html(responseText);
  9.             },
  10.             “html”
  11.         );
  12.     });
  1. $.get() is completely different, as compared to get(). The latter has nothing to do with AJAX at all.
  2. $.get accepts the response type as the last parameter, which makes it more powerful than the first functions we introduced today. Specify response type if it’s not html/text. Possible values are xml, html, text, script, json and jonsp.

5. $.post(): Make POST Requests

$.post() is a more general-purpose way to make POST requests. It does exactly the same job as $.get(), except for the fact that it makes a POST request instead.

  1. //  $.post()
  2.     $(“#post”).click(function(){
  3.         $(“#result”).html(ajax_load);
  4.         $.post(
  5.             loadUrl,
  6.             {language: “php”, version: 5},
  7.             function(responseText){
  8.                 $(“#result”).html(responseText);
  9.             },
  10.             “html”
  11.         );
  12.     });

The use of $.post() is the same as its brother, $.get(). Check the POST request in Firebug (shown in the following image).

Finally… $.ajax():

Up to this point, we’ve examined five commonly used jQuery AJAX functions. They bear different names but, behind the scenes, they generally do the exact same job with slightly different configurations. If you need maximum control over your requests, check out the $.ajax() function.

This is jQuery’s low-level AJAX implementation. See $.get, $.post etc. for higher-level abstractions that are often easier to understand and use, but don’t offer as much functionality (such as error callbacks). -jQuery’s official Documentation

In my opinion, the first five functions should satisfy most of our needs. But if you need to execute a function on AJAX error, $.ajax() is your only choice.


Today, we took an in-depth look of five ways to make AJAX calls with jQuery.

  • load(): Load a piece of html into a container DOM.
  • $.getJSON(): Load a JSON with GET method.
  • $.getScript(): Load a JavaScript.
  • $.get(): Use this if you want to make a GET call and play extensively with the response.
  • $.post(): Use this if you want to make a POST call and don’t want to load the response to some container DOM.
  • $.ajax(): Use this if you need to do something when XHR fails, or you need to specify ajax options (e.g. cache: true) on the fly.

Before we conclude, here’s a comparison table of these functions. I hope you enjoyed this lesson! Any thoughts?


21 comments on “5 Ways to Make Ajax Calls with jQuery

  1. I know this isn’t precisely on topic, however i have a website online utilizing the same program as properly and i am getting troubles with my feedback displaying. is there a setting i’m missing? it’s possible you might assist me out? thanx.

  2. Just wish to say your article is as amazing. The clarity in your post is just cool and i can think you are an expert on this subject. Fine along with your permission allow me to take hold of your RSS feed to keep updated with coming near near post. Thanks 1,000,000 and please continue the rewarding work.

  3. Hi there, simply changed into aware of your weblog thru Google, and located that it’s truly informative. I am gonna watch out for brussels. I’ll appreciate for those who continue this in future. Many other folks shall be benefited from your writing. Cheers!

  4. I’ll immediately clutch your rss feed as I can’t find your e-mail subscription hyperlink or e-newsletter service. Do you’ve any? Kindly permit me understand so that I may just subscribe. Thanks.

  5. Thanks for your suggestions. One thing we have noticed is always that banks along with financial institutions really know the spending practices of consumers plus understand that a lot of people max out there their own credit cards around the trips. They properly take advantage of this kind of fact and commence flooding the inbox along with snail-mail box having hundreds of Zero APR credit card offers immediately after the holiday season ends. Knowing that in case you are like 98% of American community, you’ll rush at the possiblity to consolidate consumer credit card debt and switch balances for 0 annual percentage rates credit cards.

  6. Thanks a bunch for sharing this with all of us you really recognise what you are talking approximately! Bookmarked. Please also discuss with my website =). We can have a hyperlink alternate arrangement between us!

  7. I believe that is among the so much significant information for me. And i’m glad studying your article. However wanna statement on few basic things, The website taste is perfect, the articles is really excellent : D. Excellent activity, cheers

  8. Hey there! This is kind of off topic but I need some advice from an established blog. Is it difficult to set up your own blog? I’m not very techincal but I can figure things out pretty quick. I’m thinking about making my own but I’m not sure where to begin. Do you have any points or suggestions? Thank you

  9. Thanks for your marvelous posting! I seriously enjoyed reading it,
    you are a great author. I will make sure to bookmark
    your blog and definitely will come back in the future.
    I want to encourage you to ultimately continue your great writing, have a nice

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s