Содержание:
jQuery.get( url [, data ] [, success ] [, dataType ] )Возвращает: jqXHR
Описание: Загружает данные с сервера при помощи HTTP GET запроса
-
Добавлен в версии: 1.0jQuery.get( url [, data ] [, success ] [, dataType ] )
-
urlТип: StringСтрока содержащая URL-адрес куда будет отправлен запрос.
-
dataТип: PlainObject или StringПлоский объект или строка, которая будет отправлена на сервер с запросом.
-
successФункция обратного вызова, выполняемая если запрос успешен. Требуется если предоставлен
dataType
, но Вы можете использовать значениеnull
илиjQuery.noop
. -
dataTypeТип: StringТип данных ожидаемый с сервера. Используются по умолчанию: xml, json, script, text, html в зависимости от заданного URL-адреса.
-
-
Добавлен в версии: 1.12/2.2jQuery.get( [settings ] )
-
settingsТип: PlainObjectАссоциативный массив (ключ/значение) настраивающий Ajax. Все поля кроме
url
не обязательны и могут быть установлены по умолчанию припомощи метода $.ajaxSetup(). Полный список параметров смотрите в описании метода jQuery.ajax( settings ). Метод запроса автоматически будет установлен в значениеGET
.
-
Это сокращенная функция Ajax, эквивалентна коду:
1
2
3
4
5
6
|
|
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
|
|
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
|
|
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 thejqXHR
object returned by jQuery.get() is also available for error handling. - Script and JSONP requests are not subject to the same origin policy restrictions.