jQuery.ajax()

 

설명 : 비동기 HTTP (Ajax) 요청을 수행하십시오.

이 $.ajax()함수는 jQuery가 보낸 모든 Ajax 요청의 기초가된다. 바로 같은 몇 가지 높은 수준의 대안으로,이 함수를 호출하는 것이 종종 불필요 $.get()하고 .load()사용할 수 있으며, 사용하기 쉽다. 그러나 공통 옵션이 덜 필요한 경우 $.ajax()더 유연하게 사용할 수 있습니다.

가장 단순한 $.ajax()함수는 인수없이 호출 할 수 있습니다.

$.ajax();
참고 : 이 $.ajaxSetup()기능 을 사용하여 기본 설정을 전역 적으로 설정할 수 있습니다 .

이 예제는 옵션을 사용하지 않고 현재 페이지의 내용을로드하지만 결과에는 아무런 영향을주지 않습니다. 결과를 사용하려면 콜백 함수 중 하나를 구현할 수 있습니다.

jqXHR 오브젝트

$.ajax() jQuery 1.5에서 반환 된 jQuery XMLHttpRequest (jqXHR) 객체 는 브라우저의 기본 XMLHttpRequest 객체의 상위 집합입니다. 예를 들어, 메소드 responseText와 responseXML속성을 포함 getResponseHeader()합니다. 전송 메커니즘이 XMLHttpRequest가 아닌 경우 (예 : JSONP 요청의 스크립트 태그) jqXHR개체는 가능한 경우 기본 XHR 기능을 시뮬레이션합니다.

jQuery 1.5.1 부터 jqXHR객체에는 overrideMimeType()메소드 가 포함되어 있습니다 (jQuery 1.4.x에서도 사용할 수 있었지만 jQuery 1.5에서는 일시적으로 제거되었습니다). 이 .overrideMimeType()메소드는 beforeSend()콜백 함수 에서 사용할 수 있습니다 ( 예 : 응답 내용 유형 헤더를 수정하는 경우).

$.ajax({
  url: "http://fiddle.jshell.net/favicon.png",
  beforeSend: function( xhr ) {
    xhr.overrideMimeType( "text/plain; charset=x-user-defined" );
  }
})
  .done(function( data ) {
    if ( console && console.log ) {
      console.log( "Sample of data:", data.slice( 0, 100 ) );
    }
  });
$.ajax()jQuery 1.5에서 반환 된 jqXHR 객체 는 Promise 인터페이스를 구현하여 Promise의 모든 속성, 메서드 및 동작을 제공합니다 ( 자세한 내용 은 Deferred 객체 참조 ). 이 메소드는 $.ajax()요청이 종료 될 때 호출되는 하나 이상의 함수 인수를 취 합니다. 이렇게하면 단일 요청에 여러 콜백을 할당 할 수 있으며 요청 완료 후 콜백을 할당 할 수도 있습니다. 요청이 이미 완료되면 콜백이 즉시 시작됩니다. jqXHR 객체의 사용 가능한 Promise 메소드에는 다음이 포함됩니다.

jqXHR.done (function (data, textStatus, jqXHR) {});
성공 콜백 옵션에 대한 대안 구성 deferred.done()은 구현 세부 정보를 참조 하십시오.

jqXHR.fail (function (jqXHR, textStatus, errorThrown) {});
오류 콜백 옵션에 대한 대안 구성 .fail()으로이 .error()메소드 는 사용되지 않는 메소드를 대체합니다 . deferred.fail()구현 세부 정보는 을 ( 를) 참조 하십시오.

jqXHR.always (function (data | jqXHR, textStatus, jqXHR | errorThrown) {}); (jQuery 1.6에 추가됨)
완전한 콜백 옵션에 대한 대안 구성 .always()으로이 .complete()메소드 는 사용되지 않는 메소드를 대체합니다 .

성공적인 요청에 대한 응답으로 함수의 인수는 .done()data, textStatus 및 jqXHR 객체 의 인수와 동일 합니다. 실패한 요청의 경우 인수는 .fail()jqXHR 객체, textStatus 및 errorThrown과 동일합니다. deferred.always()구현 세부 정보는 을 ( 를) 참조 하십시오.

jqXHR.then (function (data, textStatus, jqXHR) {}, function (jqXHR, textStatus, errorThrown) {});
.done()및 .fail()메소드 의 기능을 통합하여 기본 Promise를 조작 할 수 있습니다 (jQuery 1.8 기준). deferred.then()구현 세부 정보는 을 ( 를) 참조 하십시오.