기타 유틸리티 메소드

jQuery는 타입 검사 메소드뿐만 아니라 편리한 기능을 제공하는 다수의 유틸리티 메소드를 제공한다.

$.each() 메소드

$.each() 메소드는 객체나 배열에서 모두 사용할 수 있는 범용적인 반복 함수(iterator function)이다.

length 속성이 있는 배열이나 배열과 같은 객체를 전달받아, 그 길이만큼 반복해서 콜백함수를 실행한다. 객체의 경우에는 객체가 가지고 있는 프로퍼티의 개수만큼 반복해서 콜백함수를 실행한다.

다음 예제는 $.each() 메소드에 배열을 인수로 전달하여, 각 배열 요소를 출력하는 예제이다.

var arr = ["a", "b", "c"];
$.each(arr, function(index, value) {
  $("#text").append("index=" + index + ", value=" + value + "<br>");
});

코드 실행

다음 예제는 $.each() 메소드에 객체를 인수로 전달하여 객체의 각 프로퍼티를 출력하는 예제이다.

var site = {
  "name" : "devkuma",
  "url" : "www.devkuma.com"
};

$.each(site, function(key, value) {
       $("#text").append("key=" + key + ", value=" + value + "<br>");
});

코드 실행

$.extend() 메소드

$.extend() 메소드는 두 개 이상의 객체의 모든 프로퍼티를 하나의 객체로 병합한다.

이 메소드는 인수로 전달받은 첫 번째 객체에 두 번째 객체의 모든 프로퍼티를 추가한다.
그리고서 첫 번째 객체에 세 번째 객체의 모든 프로퍼티를 추가한다.
이와 같은 순서대로 인수로 전달받은 모든 객체의 프로퍼티를 첫 번째 객체에 모두 추가한다.

var obj1 = {
  "name" : "google",
};
    
var obj2 = {
  "url" : "www.google.com",
  "adc" : "def"
};
    
var obj3 = {
  "name" : "devkuma",
  "url" : "www.devkuma.com",
  "book" : "jQuery" 
};

$.extend(obj1, obj2, obj3);
$.each(obj1, function(key, value) {
  $("#text").append("key=" + key + ", value=" + value + "<br>");
});

코드 실행

위의 예제는 obj1 객체에 obj2 객체와 obj3 객체의 모든 프로퍼티를 순서대로 병합한다.
이때 중복되는 name 프로퍼티의 값은 가장 마지막으로 추가된 값이 설정된다.
따라서 name 프로퍼티의 값은 가장 마지막으로 병합한 obj3 객체의 devkuma 프로퍼티의 값으로 설정된다.

$.extend() 메소드에 인수로 전달되는 첫 번째 객체는 원본 객체 자체가 변형된다는 사실에 유의해야 한다.

$.trim() 메소드

$.trim() 메소드는 문자열의 시작과 끝에 위치한 공백 문자(whitespace)를 제거한다.

var text = "   안녕하세요. 데브쿠마입니다.   ";
$("#text").append("trim 전, '" + text + "'<br>");
$("#text").append("trim 후, '" + $.trim(text) + "'");

코드 실행

범용 유틸리티 메소드

메소드설명
$.contains()DOM 요소가 다른 DOM 요소의 자손(descendant) 요소인지 아닌지를 검사함.
$.unique()DOM 요소 배열을 정렬하고, 중복된 요소를 제거함.
$.each()객체나 배열에서 모두 사용할 수 있는 범용적인 반복 함수(iterator function)임.
$.data()선택한 요소와 관련된 데이터를 저장하거나, 저장된 데이터값을 읽어옴.
$.removeData()저장된 데이터를 제거함.
$.queue()선택한 요소의 실행될 함수 큐(queue)를 참조하거나 조작함.
$.dequeue()선택한 요소의 함수 큐에서 다음 함수를 실행함.
$.extend()두 개 이상의 객체의 콘텐츠를 하나의 객체로 병합함.
$.noop()빈 함수를 의미함.
$.proxy()함수를 전달받은 후, 특정 콘텍스트(context)를 가지는 새로운 함수를 반환함.
$.now()현재 시각을 나타내는 숫자를 반환함.
$.trim()문자열의 시작과 끝에 위치한 공백 문자(whitespace)를 제거함.

$.inArray() 메소드

$.inArray() 메소드는 전달받은 값을 배열에서 검색한 후, 값이 일치하는 요소의 인덱스를 반환한다. 만약 배열에 전달받은 값과 일치하는 요소가 없으면 -1을 반환한다.

예제

var arr = ["devkuma", 123, "abc"];
    
$("#text").append("devkuma : " + $.inArray("devkuma", arr) + "<br>");
$("#text").append("123 : " + $.inArray(123, arr) + "<br>");
$("#text").append("abc : " + $.inArray("abc", arr) + "<br>");
$("#text").append("def : " + $.inArray("def", arr));

코드 실행

배열에 관련된 메소드

메소드설명
$.makeArray()배열과 같은 객체(array-like object)를 자바스크립트 Array 객체로 변환함.
$.inArray()전달받은 값을 배열에서 검색한 후, 값이 일치하는 요소의 인덱스를 반환함. 만약 일치하는 요소가 없으면 -1을 반환함.
$.map()배열이나 객체의 모든 요소를 새로운 배열로 변환함.
$.merge()두 개의 배열의 콘텐츠를 하나의 배열로 병합함.
$.grep()배열에서 필터 함수를 만족하는 요소를 검색함. 원본 배열은 변경되지 않음.

파싱에 관련된 메소드

메소드설명
$.parseHTML()DOM 노드 배열을 문자열로 파싱함.
$.parseJSON()잘 구성된(well-formed) JSON 문자열을 전달받은 후, 자바스크립트 객체로 반환함.
$.parseXML()XML 문서를 문자열로 파싱함.

참조


유틸리티 메소드

jQuery는 프로그래밍을 하는 데 도움이 되는 다수의 유틸리티 메소드를 제공한다.

타입 검사 메소드

jQuery는 인수로 전달받은 값의 타입을 손쉽게 확인해 주는 다음과 같은 메소드를 제공한다.

메소드설명
$.type()전달받은 값을 자바스크립트의 내부 클래스와 비교하여, 더욱 정확한 타입 검사를 제공함.
$.isArray()전달받은 값이 배열인지 아닌지를 검사함.
$.isFunction()전달받은 값이 자바스크립트 함수 객체인지 아닌지를 검사함.
$.isNumeric()전달받은 값이 자바스크립트 Number 객체인지 아닌지를 검사함.
$.isEmptyObject()전달받은 값이 비어있는 객체(열거할 수 있는 프로퍼티를 가지고 있지 않은 객체)인지 아닌지를 검사함.
$.isPlainObject()전달받은 값이 기본 객체(plain object)인지 아닌지를 검사함.
$.isWindow()전달받은 값이 자바스크립트 Window 객체인지 아닌지를 검사함.
$.isXMLDoc()전달받은 DOM 노드가 XML 문서에 포함되어 있거나, XML 문서인지 아닌지를 검사함.

$.type() 메소드

자바스크립트의 typeof 연산자는 값에 따라 부정확하거나 모순된 타입 검사 결과를 반환한다.
하지만 jQuery는 전달받은 값을 자바스크립트의 내부 클래스와 비교하여, 더욱 정확한 타입 검사를 제공하는 $.type() 메소드를 제공한다.

예제

$("#text")
    .append($.type(undefined) +"<br>")          // undefined
    .append($.type() +"<br>")                   // undefined
    .append($.type(window.notDefined) +"<br>")  // undefined
    .append($.type(null) +"<br>")               // null       
    .append($.type(true) +"<br>")               // boolean
    .append($.type(new Boolean()) +"<br>")      // boolean
    .append($.type(3) +"<br>")                  // number
    .append($.type(new Number(3)) +"<br>")      // number
    .append($.type("test") +"<br>")             // string
    .append($.type(new String("test")) +"<br>") // string
    .append($.type(function(){}) +"<br>")       // function
    .append($.type([]) +"<br>")                 // array
    .append($.type(new Array()) +"<br>")        // array
    .append($.type(new Date()) +"<br>")         // date
    .append($.type(new Error()) +"<br>")        // error - as of jQuery 1.9
    .append($.type(Symbol()) +"<br>")           // symbol - as of jQuery 1.9
    .append($.type(Object(Symbol())) +"<br>")   // symbol - as of jQuery 1.12
    .append($.type(/test/) +"<br>");            // regexp

코드 실행

특정 타입 검사 메소드

jQuery는 $.type() 메소드뿐만 아니라 전달된 값이 특정 타입의 값인지 아닌지를 검사해 주는 다양한 메소드를 제공한다.

예제

$("#text")
    .append($.isArray([]) + "<br>")                      // true
    .append($.isArray(10) + "<br>")                      // false
    .append($.isFunction(new Function()) + "<br>")       // true
    .append($.isFunction("문자열") + "<br>")               // false
    .append($.isNumeric(10) + "<br>")                     // true
    .append($.isNumeric([10]) + "<br>")                   // false
    .append($.isEmptyObject({}) + "<br>")                 // true
    .append($.isEmptyObject({name: "text"}) + "<br>")     // false
    .append($.isPlainObject(new Object()) + "<br>")       // true
    .append($.isPlainObject(new Object("text")) + "<br>") // false
    .append($.isWindow(window) + "<br>")                  // true
    .append($.isXMLDoc(document) + "<br>");               // false

코드 실행

참조


Ajax와 Form 요소

Ajax에서는 서버와의 비동기식 통신을 위해 form 요소를 통해 입력받은 데이터를 직렬화(serialization)하여 전송한다.

이때 직렬화(serialization)란 입력받은 여러 데이터를 하나의 쿼리 문자열로 만드는 것을 의미한다.
이렇게 함으로써 form 요소를 통해 입력받은 데이터를 한 번에 서버로 보낼 수 있게 된다.

직렬화(serialization)

jQuery에서는 HTML form 요소를 통해 입력된 데이터의 직렬화 작업을 매우 간단하게 수행할 수 있다.
.serialize() 메소드와 .serializeArray() 메소드를 이용하여 손쉽게 데이터를 직렬화할 수 있다. .serialize() 메소드는 HTML form 요소를 통해 입력된 데이터를 쿼리 문자열로 변환한다.
.serializeArray() 메소드는 serialize() 메소드와는 달리 입력된 데이터를 문자열이 아닌 배열 객체로 변환한다.

다음 예제는 <form>요소에 .serialize()를 한 값을 표시한다.

function showValues() {
    $("#text").text($("form").serialize());
}
$("input[type='text']").on("keydown", showValues);
$("input[type='checkbox'], input[type='radio']").on("click", showValues);
$("select").on("change", showValues);

코드 실행

한글이 포함된 입력 데이터가 쿼리 문자열로 변환될 때는 퍼센트 인코딩(percent-encoding)을 통해 변환된다.
이때 모든 한글 문자는 퍼센트 기호(%)를 포함한 16진수 값으로 변환된다.

참조


Ajax 메소드

메소드설명
$.ajax()비동기식 Ajax를 이용하여 HTTP 요청을 전송함.
$.get()전달받은 주소로 GET 방식의 HTTP 요청을 전송함.
$.post()전달받은 주소로 POST 방식의 HTTP 요청을 전송함.
$.getScript()웹 페이지에 스크립트를 추가함.
$.getJSON()전달받은 주소로 GET 방식의 HTTP 요청을 전송하여, 응답으로 JSON 파일을 전송받음.
.load()서버에서 데이터를 읽은 후, 읽어 들인 HTML 코드를 선택한 요소에 배치함.

$.ajax() 메소드

jQuery는 Ajax와 관련된 다양하고 편리한 많은 메소드를 제공한다.

그중에서도 $.ajax() 메소드는 모든 jQuery Ajax 메소드의 핵심이 되는 통합적인 메소드이다 .
$.ajax() 메소드는 HTTP 요청을 만드는 강력하고도 직관적인 방법을 제공한다.

형식

jQuery.ajax( url [, settings] ) >> 1.5 이상버젼
jQuery.ajax( settings )  >> 1.0 이상버젼
  • url : 요청 URL (클라이언트가 HTTP 요청을 보낼 서버의 주소)
  • settings : key/value 쌍으로 된 Ajax 요청 Set ( optional )
    • url : 요청 URL (클라이언트가 HTTP 요청을 보낼 서버의 주소)
    • data : 요청과 함께 서버에 보내는 string 또는 json
    • success(data, textStatus, jqXHR) : 요청이 성공일때 실행되는 callback 함수
    • dataType : 서버에서 내려온 data 형식. ( default : xml, json, script, text, html )

메소드 체이닝(method chaining)

메소드명설명
doneHTTP 요청이 성공하면 요청한 데이터가 done() 메소드로 전달된다.
failHTTP 요청이 실패하면 오류와 상태에 관한 정보가 fail() 메소드로 전달된다.
alwaysHTTP 요청이 성공하거나 실패하는 것에 상관없이 언제나 always() 메소드가 실행된다.

예제

다음 예제는 $.ajax() 메소드에서 사용할 수 있는 대표적인 옵션을 설명한다.

$.ajax({
    url: "/rest/1/pages/245", // 클라이언트가 HTTP 요청을 보낼 서버의 URL 주소
    data: { name: "홍길동" },  // HTTP 요청과 함께 서버로 보낼 데이터
    method: "GET",   // HTTP 요청 메소드(GET, POST 등)
    dataType: "json" // 서버에서 보내줄 데이터의 타입
})
// HTTP 요청이 성공하면 요청한 데이터가 done() 메소드로 전달됨.
.done(function(json) {
    $("<h1>").text(json.title).appendTo("body");
    $("<div class=\"content\">").html(json.html).appendTo("body");
})
// HTTP 요청이 실패하면 오류와 상태에 관한 정보가 fail() 메소드로 전달됨.
.fail(function(xhr, status, errorThrown) {
    $("#text").html("오류가 발생했다.<br>")
    .append("오류명: " + errorThrown + "<br>")
    .append("상태: " + status);
})
// 
.always(function(xhr, status) {
    $("#text").html("요청이 완료되었습니다!");
});

다음 예제는 $.ajax() 메소드의 동작을 보여주는 간단한 예제이다.

var jqxhr = $.ajax("/rest/1/pages/245")
.done(function() {
  alert("성공");
})
.fail(function() {
  alert("실패");
 })
.always(function() {
  alert("완료");
});
      
jqxhr.always(function() {
  alert("두번째 성공");
});

코드 실행

$.ajaxSetup() 메소드

공통적인 기본 ajax 요청을 미리 설정하는데 사용한다.

형식

jQuery.ajaxSetup( options )
  • optional : default Ajax 요청의 설정값 ( key/value )

예제

아래 예제는 미리 $.ajaxSetup()에 기본사항들을 설정한 후 ajax 로 각각 호출한다.

$.ajaxSetup({  
  url: '/api/users',  
  global: false,   
  type: "POST"     
});  

$.ajax({  
  // url not set here; uses '/api/users'  
  data: {'name': 'Dan'}  
});

$.ajax({  
  // url not set here; uses '/api/users'  
  data: {'name': 'John'}  
}); 

$.get() 메소드

jQuery에서는 Ajax를 이용하여 GET 방식의 HTTP 요청을 구현한 $.get() 메소드를 제공한다.
이 메소드를 사용하면 서버에 GET 방식의 HTTP 요청을 보낼 수 있다.

형식

jQuery.get(  url [, data] [, success(data, textStatus, jqXHR)] [, dataType] )
  • url : 요청 URL (클라이언트가 HTTP 요청을 보낼 서버의 주소)
  • data : 요청과 함께 서버에 보내는 string 또는 map
  • success(data,textStatus,jqXHR) : 요청이 성공일때 실행되는 callback 함수
  • dataType : 서버에서 내려온 data 형식. ( default : xml,json,script,text,html )

$.ajax으로 표현

$.ajax({
  type: "GET",
  url: url,  
  data: data,  
  success: success,  
  dataType: dataType  
});  

다음 예제는 $.get() 메소드의 동작을 보여주는 간단한 예제이다.

// GET 방식으로 서버에 HTTP Request를 보냄.
$.get("/examples/media/request_ajax.php",
  { species: "고양이", name: "나비", age: 3, }, // 서버가 필요한 정보를 같이 보냄.
    function(data, status) {
      $("#text").html(data + "<br>" + status); // 전송받은 데이터와 전송 성공 여부를 보여줌.
    }
   );
});

$.post() 메소드

jQuery에서는 Ajax를 이용하여 POST 방식의 HTTP 요청을 구현한 $.post() 메소드를 제공한다.
이 메소드를 사용하면 서버에 POST 방식의 HTTP 요청을 보낼 수 있다.

형식

$.post() 메소드의 원형은 다음과 같다.

$.post(URL주소[,데이터][,콜백함수]);
  • URL 주소 : 클라이언트가 HTTP 요청을 보낼 서버의 주소이다.
  • 데이터 : HTTP 요청과 함께 서버로 보낼 데이터를 전달한다.
  • 콜백 함수 : HTTP 요청이 성공했을 때 실행할 함수를 정의한다.

$.ajax으로 표현

$.ajax({
  type: "POST",
  url: url,  
  data: data,  
  success: success,  
  dataType: dataType  
});  

예제

다음 예제는 $.post() 메소드의 동작을 보여주는 간단한 예제이다.

// POST 방식으로 서버에 HTTP Request를 보냄.
$.post("/examples/media/request_ajax.php",
  { name: "홍길동", grade: "A" },              // 서버가 필요한 정보를 같이 보냄.
  function(data, status) {
    $("#text").html(data + "<br>" + status); // 전송받은 데이터와 전송 성공 여부를 보여줌.
  }
);

$.getJSON() 메소드

서버에 데이터를 HTTP GET 방식으로 전송한 후 서버측 응답을 JSON 형식으로 받을때 사용한다.

형식

jQuery.getJSON( url [, data] [, success(data, textStatus, jqXHR)] )
  • url : 요청 Url
  • data : 요청과 함께 서버에 보내는 string 또는 map
  • success(data,textStatus,jqXHR) : 요청이 성공일때 실행되는 callback 함수

$.ajax 로 표현

$.ajax({  
  url: url,  
  dataType: 'json',  
  data: data,  
  success: callback  
});  

예제

$.getJSON("example?foo=1",   
    {   
        tags: "mount rainier",   
        tagmode: "any",   
        format: "json"   
    },   
    function(data) {   
        $.each(data.items, function(i,item) {   
          $("<img/>").attr("src", item.media.m).appendTo("#images");   
          if ( i == 3 )
              return false;   
        });   
    }); 

.load() 메소드

load() 메소드는 선택한 요소에서 호출하는 유일한 jQuery Ajax 메소드이다.

load() 메소드는 서버에서 데이터를 읽은 후, 읽어 들인 HTML 코드를 선택한 요소에 표시한다.
또한, 선택자를 URL 주소와 함께 전송하면, 읽어 들인 HTML 코드 중에서 선택자와 일치하는 요소만을 배치한다.

형식

.load( url [, data] [, complete(responseText, textStatus, XMLHttpRequest)] )
  • url : 요청 URL
  • data : 요청과 함께 서버에 보내는 string 또는 map
  • complete(responseText, textStatus, XMLHttpRequest) : 요청이 완료될때 실행되는 callback 함수

예제

다음 예제들 .load() 메소드의 다양한 형태를 보여주는 간단한 예제이다.

//  Html Content 로딩  
$('#result').load('ajax/test.html');  
  
//  Html Content 로딩 후 메시지  
$('#result').load('ajax/test.html', function() {  
  alert('Load was performed.');  
});  
  
//  Html Content #container Target 로딩  
$('#result').load('ajax/test.html #container');  
  
//  array parameter 전달 후 Html Content 로딩  
$("#objectID").load("test.asp", { 'choices[]': ["Jon", "Susan"] } );  

다음 예제는 .load() 메소드의 동작을 보여주는 간단한 예제이다.

$(function() {
    $("#btnRequest").on("click", function() {
        // URL 주소에 존재하는 HTML 코드에서 <li>요소를 읽은 후에 id가 "list"인 요소에 배치한다.
        $("#list").load("/examples.html li");
    });
});

참조


HTTP 요청 메소드(Method)

클라이언트인 브라우저가 서버에 HTTP 요청을 보낼 때는 다음 메소드 중 하나를 사용한다.

  1. GET 메소드
  2. POST 메소드
  3. PUT 메소드
  4. DELETE 메소드

이외에 HEAD, OPTIONS, TRACE, CONNECT가 있고, 주로 사용하는 것은 위에 4가지 이다.
특히, GET, POST가 2가지는 제일 많이 사용된다.

GET 메소드

GET 메소드은 주소에 데이터(data)를 추가하여 전달하는 방식이다.

GET 메소드의 HTTP 요청은 브라우저에 의해 캐시되어(cached) 저장된다. 또한, GET 방식은 보통 쿼리 문자열(query string)에 포함되어 전송되므로, 길이의 제한이 있다. 따라서 보안상 취약점이 존재하므로, 중요한 데이터는 POST 방식을 사용하여 요청하는 것이 좋다.

POST 메소드

POST 메소드는 데이터(data)를 별도로 첨부하여 전달하는 방식이다.

POST 방식의 HTTP 요청은 브라우저에 의해 캐시되지 않으므로, 브라우저 히스토리에도 남지 않는다. 또한, POST 방식의 HTTP 요청에 의한 데이터는 쿼리 문자열과는 별도로 전송된다. 따라서 데이터의 길이에 대한 제한도 없으며, GET 방식보다 보안성이 높다.

GET 메소드와 POST 메소드의 비교

특징GET 메소드POST 메소드
캐시화(cached)캐시될 수 있음.캐시되지 않음.
브라우저 히스토리히스토리에 쿼리 문자열이 기록됨.히스토리에 기록되지 않음.
데이터 길이데이터의 길이가 URL 주소의 길이 이내로 제한됨. (익스플로러에서 URL 주소가 가질 수 있는 최대 길이는 2,083자이며, 이 중에서 순수 경로 길이는 2,048자까지만 허용됨)제한 없음.
데이터 타입오직 ASCII 문자 타입의 데이터만 전송할 수 있음.제한 없음.
보안성데이터가 URL 주소에 포함되어 전송되므로, 아무나 볼 수 있어 보안에 매우 취약함.브라우저 히스토리에도 기록되지 않고, 데이터가 따로 전송되므로, GET 방식보다 보안성이 높음.

현재 주요 웹 브라우저에서 사용할 수 있는 URL 주소의 최대 길이는 익스플로러를 제외하면, 제한을 두지 않고 있다.

+ Recent posts