jQuery.ajaxPrefilter() $.ajax() 함수 호출 전 Ajax 옵션 수정
10년 전
개요 : Ajax 요청을 보내기 전이나 $.ajax() 함수에 의해 호출되기 전에 Ajax 옵션들을 수정하거나 조작합니다.
jQuery.ajaxPrefilter( [dataTypes], handler(options, originalOptions, jqXHR) )
dataTypes 공백 문자열로 구분된 dataType 문자열, 생략가능
handler(options, originalOptions, jqXHR) 향후 아약스 요청에 대해 기본값을 설정하는 핸들러.
$.ajaxPrefilter() 함수의 기본적인 사용법은 아래와 같습니다.
$.ajaxPrefilter( function( options, originalOptions, jqXHR ) {
// Modify options, control originalOptions, store jqXHR, etc
});
각 인자들을 설명하면 :
options : request 요청 옵션 값들
originalOptions : ajax 함수에 쓰일 수정되지 않은 옵션값들(흠, 정체가 궁금하군요;;;)
jqXHR : jqXHR 겍체 ( jquery XMLHttpRequest )
Prefilters 는 커스텀 옵션을 사용해야 할 때 알맞습니다. 예를 들어 설명하면, 아래 코드처럼 abortOnRetry 옵션이 true로 세팅되어 있다면 $.ajax() 함수는 URL에 대한 요청을 취소하게 되는 것입니다.
var currentRequests = {};
$.ajaxPrefilter(function( options, originalOptions, jqXHR ) {
if ( options.abortOnRetry ) {
if ( currentRequests[ options.url ] ) {
currentRequests[ options.url ].abort();
}
currentRequests[ options.url ] = jqXHR;
}
});
options 객체의 abortOnRetry 라는 속성은 사용자가 만든 것이고, 그 값이 true 라면 Ajax의 기본 속성인 url 에 대한 실행을 abort 하라는 예제인 것(?) 입니다. ㅎㅎ;;
또한 Prefilters 는 이미 작성된 옵션을 수정할 수도 있습니다. 이것도 예제가 있습니다.
$.ajaxPrefilter( function( options ) {
if ( options.crossDomain ) {
options.url = "http://mydomain.net/proxy/" + encodeURIComponent( options.url );
options.crossDomain = false;
}
});
옵션값인 dataTypes 인자를 사용하다면, prefilter는 dataType 형태로 요청을 진행합니다. 예제를 보시면, JSON 과 script 로 prefilter 를 하고 있는 모습입니다.
$.ajaxPrefilter( "json script", function( options, originalOptions, jqXHR ) {
// Modify options, control originalOptions, store jqXHR, etc
});
$.ajaxPrefilter() 함수는 아래처럼 isActuallyScript() 라는 사용자가 만든 함수의 어떤 특정한 결과에 의해서 "script" dataType 을 요청하 수도 있습니다.
$.ajaxPrefilter(function( options ) {
if ( isActuallyScript( options.url ) ) {
return "script";
}
});