## jQuery.get( url [, data ] [, success ] [, dataType ] )Returns: jqXHR

Description: Load data from the server using a HTTP GET request.

- #### version added: 1.0 jQuery.get( url [, data ] [, success ] [, dataType ] )

  - url
    Type: String
    A string containing the URL to which the request is sent.
  - data
    Type: PlainObject or String
    A plain object or string that is sent to the server with the request.
  - success
    Type: Function( PlainObject data, String textStatus, jqXHR jqXHR )
    A callback function that is executed if the request succeeds. Required if `dataType` is provided, but you can use `null` or `jQuery.noop` as a placeholder.
  - dataType
    Type: String
    The type of data expected from the server. Default: Intelligent Guess (xml, json, script, text, html).

- #### version added: 1.12/2.2 jQuery.get( [settings ] )

  - settings
    Type: PlainObject
    A set of key/value pairs that configure the Ajax request. All properties except for `url` are optional. A default can be set for any option with $.ajaxSetup(). See jQuery.ajax( settings ) for a complete list of all settings. The type option will automatically be set to `GET`.

This is a shorthand Ajax function, which is equivalent to:

1 2 3 4 5 6 |
    $.ajax({  url: url,  data: data,  success: success,  dataType: dataType});

The `success` callback function is passed the returned data, which will be an XML root element, text string, JavaScript file, or JSON object, depending on the MIME type of the response. It is also passed the text status of the response.

As of jQuery 1.5, the `success` callback function is also passed a "jqXHR" object (in jQuery 1.4, it was passed the `XMLHttpRequest` object). However, since JSONP and cross-domain GET requests do not use XHR, in those cases the `jqXHR` and `textStatus` parameters passed to the success callback are undefined.

Most implementations will specify a success handler:

1 2 3 4 |
    $.get( "ajax/test.html", function( data ) {  $( ".result" ).html( data );  alert( "Load was performed." );});

This example fetches the requested HTML snippet and inserts it on the page.

#### The jqXHR Object

As of jQuery 1.5, all of jQuery's Ajax methods return a superset of the `XMLHTTPRequest` object. This jQuery XHR object, or "jqXHR," returned by `$.get()` implements the Promise interface, giving it all the properties, methods, and behavior of a Promise (see Deferred object for more information). The `jqXHR.done()` (for success), `jqXHR.fail()` (for error), and `jqXHR.always()` (for completion, whether success or error; added in jQuery 1.6) methods take a function argument that is called when the request terminates. For information about the arguments this function receives, see the jqXHR Object section of the `$.ajax()` documentation.

The Promise interface also allows jQuery's Ajax methods, including `$.get()`, to chain multiple `.done()`, `.fail()`, and `.always()` callbacks on a single request, and even to assign these callbacks after the request may have completed. If the request is already complete, the callback is fired immediately.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
    // Assign handlers immediately after making the request,// and remember the jqxhr object for this requestvar jqxhr = $.get( "example.php", function() {  alert( "success" );})  .done(function() {    alert( "second success" );  })  .fail(function() {    alert( "error" );  })  .always(function() {    alert( "finished" );  }); // Perform other work here ... // Set another completion function for the request abovejqxhr.always(function() {  alert( "second finished" );});

#### Deprecation Notice

The `jqXHR.success()`, `jqXHR.error()`, and `jqXHR.complete()` callback methods are removed as of jQuery 3.0. You can use `jqXHR.done()`, `jqXHR.fail()`, and `jqXHR.always()` instead.

### Additional Notes:

- Due to browser security restrictions, most "Ajax" requests are subject to the same origin policy; the request can not successfully retrieve data from a different domain, subdomain, port, or protocol.
- If a request with jQuery.get() returns an error code, it will fail silently unless the script has also called the global .ajaxError() method. Alternatively, as of jQuery 1.5, the `.error()` method of the `jqXHR` object returned by jQuery.get() is also available for error handling.
- Script and JSONP requests are not subject to the same origin policy restrictions.

## Examples:

Request the test.php page, but ignore the return results.

1 |
    $.get( "test.php" );

Request the test.php page and send some additional data along (while still ignoring the return results).

1 |
    $.get( "test.php", { name: "John", time: "2pm" } );

Pass arrays of data to the server (while still ignoring the return results).

1 |
    $.get( "test.php", { "choices[]": ["Jon", "Susan"] } );

Alert the results from requesting test.php (HTML or XML, depending on what was returned).

1 2 3 |
    $.get( "test.php", function( data ) {  alert( "Data Loaded: " + data );});

Alert the results from requesting test.cgi with an additional payload of data (HTML or XML, depending on what was returned).

1 2 3 4 |
    $.get( "test.cgi", { name: "John", time: "2pm" } )  .done(function( data ) {    alert( "Data Loaded: " + data );  });

Get the test.php page contents, which has been returned in json format (<?php echo json_encode( array( "name"=>"John","time"=>"2pm" ) ); ?>), and add it to the page.

1 2 3 4 5 |
    $.get( "test.php", function( data ) {  $( "body" )    .append( "Name: " + data.name ) // John    .append( "Time: " + data.time ); //  2pm}, "json" );