Class: Hash.Cookie

Зберігає та завантажує Hash як Cookie у форматі JSON.

Розширює:

• Hash

Синтаксис:

var myHashCookie = new Hash.Cookie(name[, options]);

Аргументи:

1. name - (string) Ключ (назва) для cookie
2. options - (object) Усі Cookie параметри плюс параметр autoSave.

Параметри:

1. autoSave - (boolean: за замовчуванням true) Параметр для збереження cookie при кожній операції.

Повертає:

• (object) Новий екземпляр Hash.Cookie.

Приклади:

var fruits = new Hash.Cookie('myCookieName', {duration: 3600});
fruits.extend({

    'lemon': 'yellow',
    'apple': 'red'
});
fruits.set('melon', 'green');
fruits.get('lemon'); // yellow

 
// ... on another page ... values load automatically
 
var fruits = new Hash.Cookie('myCookieName', {duration: 365});
fruits.get('melon'); // green

 
fruits.erase(); // delete cookie

Примітки:

• Усі методи Hash доступні в вашому екземплярі Hash.Cookie. Якщо параметр autoSave встановлено, кожен виклик методу призведе до збереження вашого Cookie.
• Cookies мають обмеження 4 Кб (4096 байт). Тому будьте обережні з розміром вашого Hash.
• Усі методи Hash, використані на Hash.Cookie, повертають значення, що повертає метод Hash, якщо ви не перевищили ліміт розміру Cookie. У цьому випадку результат буде false.
• Якщо ви плануєте використовувати великі Cookies, розгляньте можливість вимкнення autoSave, і перевіряйте статус .save() щоразу.
• Створення нового екземпляра автоматично завантажує дані з Cookie в Hash. Зручно, чи не так?

Див. також:

• Hash

Hash.Cookie Method: save

Зберігає Hash у cookie. Якщо Hash порожній, видаляє cookie.

Синтаксис:

myHashCookie.save();

Повертає:

• (boolean) Повертає false, коли рядок JSON cookie занадто довгий (4 Кб), інакше true.

Приклади:

var login = new Hash.Cookie('userstatus', {autoSave: false});

 
login.extend({
    'username': 'John',
    'credentials': [4, 7, 9]

});
login.set('last_message', 'User logged in!');
 
login.save(); // finally save the Hash

Hash.Cookie Method: load

Завантажує cookie і призначає його Hash.

Синтаксис:

myHashCookie.load();

Повертає:

• (object) Цей екземпляр Hash.Cookie.

Приклади:

var myHashCookie = new Hash.Cookie('myCookie');

 
(function(){
    myHashCookie.load();
    if(!myHashCookie.length) alert('Cookie Monster must of eaten it!');

}).periodical(5000);

Примітки:

• Корисно при опитуванні (polling).