HTML5의 LocalStorage의 기능과 동일하며 ie 하위 버전에서도 동일한 기능을 제공하고 있다. (세부 내용 및 스펙은 http://www.w3.org/TR/webstorage/#storage 참조.)
LocalStorage는 도메인(사이트별)로 브라우저에서 제공하는 임의의 영역에 data를 저장 할 수 있으며 저장 할 수 있는 데이터의 양은 브라우저에서의 설정에 따라 다른다.
cookie 기능과 비슷하지만 만료일 지정이 따로 없고 저장 할 수 있는 데이터의 양도 크다. 일반적으로 알려저 있는 최대 저장 크기는 약 5MB~10MB로 브라우저마다 다르다. 멀티브라우징을 위해서는 5MB 이하로 저장하는 것을 권장한다.

Type

engine

Property Summary

Event Summary

Method Summary

clear( )

동일한 도메인으로 localStorage에 저장 된 데이터를 삭제합니다

getAllItem( )

동일한 도메인으로 localStorage에 저장 된 모든 데이터를 key,value형태의 객체로 반환합니다

getItem( keyName )

LocalStorage에서 keyName에 해당하는 값을 반환한다

key( index )

index에 해당하는 키값을 가져옵니다

length( )

로컬 스토리지의 (key, value)쌍의 데이터의 개수를 나타내는 값

removeItem( key )

keyName에 해당하는 데이터(item)을 삭제한다.

setItem( keyName , value )

localStorage에 key와 value로 이루어진 데이터(item)를 저장합니다

clear( )

동일한 도메인으로 localStorage에 저장 된 데이터를 삭제합니다.

Sample

$w.local.clear();

getAllItem( )

동일한 도메인으로 localStorage에 저장 된 모든 데이터를 key,value형태의 객체로 반환합니다.

Return

type	description
JSON	key,value가 저장 된 JSON 객체.

Sample

var tmpData = $w.local.getAllItem(); //return 예시 ) { name:"WebSquare" , add:"서울시" }

getItem( keyName )

LocalStorage에서 keyName에 해당하는 값을 반환한다.

Parameter

name	type	required	description
keyName	String	Y	저장 한 key 값.

Return

type	description
String	keyName과 매칭 된 데이터가 있으면 value를 반환하며, 그렇지 않을 경우 null을 반환한다.

Sample

// name라는 key로 "WebSquare"가 저장되어 있는 경우 $w.local.getItem("name"); return 예시 ) "WebSquare"

key( index )

index에 해당하는 키값을 가져옵니다. 저장 된 key의 index(순서)는 브라우저에 정의 된 것에 따라 다르다. 즉, 브라우저마다 key의 index가 다를 수 있다.

Parameter

name	type	required	description
index	Number	Y	저장 된 key의 index.

Return

type	description
String	index에 해당하는 key값을 반환하며, 그렇지 않을 경우 null을 반환한다.

Sample

//대표적인 브라우저 중 chorme과 ie를 비교 했을 때 chrome은 마지막에 저장 한 값이 0번째로 나오며 ie의 경우 첫번째로 저장 한 값이 0번째로 나온다. ( 2014년 11월 비교. ) $w.local.key(0); return 예시 ) "name"

length( )

로컬 스토리지의 (key, value)쌍의 데이터의 개수를 나타내는 값.

Return

type	description
Number	로컬 스토리지에 저장 된 데이터(key/value)의 개수.

Sample

$w.local.length return 예시 ) 2

removeItem( key )

keyName에 해당하는 데이터(item)을 삭제한다.
모든 데이터를 삭제 할 경우 clear()함수를 호출한다.

Parameter

name	type	required	description
key	String	Y	삭제하고자 하는 데이터(item)의 key값

Sample

$w.local.removeItem("name"); // name에 해당하는 item을 삭제합니다.

setItem( keyName , value )

localStorage에 key와 value로 이루어진 데이터(item)를 저장합니다.

Parameter

name	type	required	description
keyName	String	Y	저장 할 key
value	String	Y	저장 할 value

Sample

// name라는 key로 WebSquare라는 값을 저장합니다. $w.local.setItem("name", "WebSquare");