HTML 5 — веб-хранилище

Чтобы избежать путаницы, HTML 5 Web Storage не является API базы данных индекса или Web SQL Database, которые также являются функциями, связанными с HTML 5, которые начали поддерживать некоторые браузеры.

// Check if the sessionStorage object exists
if (window.sessionStorage) { g_bBrowserSupportsSessionStorage = true; }

// Check if the localStorage object exists
if (window.localStorage) { g_bBrowserSupportsLocalStorage = true; }

• setItem (ключ, значение)
• GetItem (Key)
• RemoveItem (Key)
• Чисто()
• ключ (iIndex)
• длина

setItem добавляет пару ключ / значение в объект хранения, если ключ еще не существует в объекте хранения. Если ключ уже существует в объекте хранения, значение просто обновляется.

getItem возвращает значение из объекта хранения для указанного ключа. Если ключ не существует в объекте хранения, возвращается ноль.

removeItem удаляет элемент, указанный из объекта хранения.

clear удаляет все элементы из объекта хранения
.

Ключ возвращает имя элемента с указанным нулевым индексом. Возвращает ноль, если индекс не существует.

length возвращает число, указывающее, сколько пар ключ / значение находятся в объекте хранения
.

// The method outlined in the W3C spec
window.sessionStorage.setItem("OurKey", "Some Value");

// Using array notation
window.sessionStorage["OurKey"] = "Some Value";

// Using dot notation
window.sessionStorage.OurKey = "Some Value";

// The method outlined in the W3C spec
var sValue = window.sessionStorage.getItem("OurKey");

// Using array notation
var sValue = window.sessionStorage["OurKey"];

// Using dot notation
var sValue = window.sessionStorage.OurKey;

Ниже приведены примеры способов удаления элементов из объекта sessionStorage:

// Remove a single item using the method outlined in the W3C spec
window.sessionStorage.removeItem("OurKey");

// Remove a single item using the delete keyword
// (same as above, just with a different syntax)
delete window.sessionStorage["OurKey"];

// Remove all items
window.sessionStorage.clear();

// Add the event listener (W3C browsers, including IE 9,
// use addEventListener)
if (window.addEventListener)
{

    // Listen for the storage event (triggered when the
    // storage is modified - setItem, removeItem, clear)
    window.addEventListener("storage", OurStorageListener, true);

}
else if (window.attachEvent) // IE 8 and previous...
{

    // Listen for the storage event on the DOM object
    // (Hack since attachEvent is an IE 8 and previous
    // thing - might not be totally cross-browser if
    // other browsers also implement attachEvent)
    document.attachEvent("onstorage", OurStorageListener);

}

function OurStorageListener(e)
{

    // Take the event details and put it into a string
    var sValue = ("Key: " + e.key +
    " ...New Value: " + e.newValue +
    " ...Old Value: " + e.oldValue +
    " ...URL: " + e.url +
    " ...Storage Area: " + e.storageArea);

    // Display the event details to the screen
    document.getElementById("divResults2").innerHTML = sValue;

}

ключ — это ключ, который меняется. В наших примерах выше это будет «OurKey». Это будет нулевым, если событие было результатом вызова функции очистки для объекта хранения
.

newValue — это значение, указанное, если был сделан вызов setItem. Если был выполнен вызов removeItem, это значение будет нулевым. Это свойство также будет нулевым, если функция очистки была вызвана для объекта хранения.

oldValue — это старое значение, если ключ уже существовал при вызове setItem. Если был вызван setItem и элемент еще не существует, это значение будет нулевым. Это свойство также будет нулевым, если функция очистки была вызвана для объекта хранения.

url — это адрес документа, на который был затронут объект хранения
.

storageArea представляет объект хранилища, который был затронут (ссылка на объект хранилища, который был изменен, чтобы упростить вам доступ к значениям внутри объекта, а также возможность изменять элементы в случае необходимости). Таким образом, вам не нужно угадывать, был ли изменен сеанс или объект локального хранилища, поскольку у вас есть прямой доступ к измененному объекту.