Об'єкт: Cookie

Встановлює та отримує доступ до cookies.

Автори:

  • На основі функцій Пітера-Пола Коха QuirksMode.
  • domain - (рядок: за замовчуванням false) Домен, до якого належить Cookie.
  • path - (рядок: за замовчуванням false) Шлях, до якого належить Cookie.
  • duration - (число: за замовчуванням false) Тривалість життя Cookie до закінчення терміну дії, у днях. Якщо встановлено false або 0, cookie буде сесійним і закінчиться при закритті браузера.
  • secure - (булеве: за замовчуванням false) Збережена інформація cookie доступна лише з безпечного середовища.

Примітки:

  • Для спільного використання Cookie зі сторінками, розташованими за іншим шляхом, необхідно встановити значення Cookie.options.domain.

Метод Cookie: write

Записує cookie в браузері.

Синтаксис:

var myCookie = Cookie.write(key, value[, options]);

Аргументи:

  1. key - (рядок) Ключ (або назва) cookie.
  2. value - (рядок) Значення для встановлення. Не може містити крапки з комою.
  3. options - (mixed, опціонально) Див. Cookie.

Повертає:

  • (об'єкт) Об'єкт з параметрами, ключем та значенням. Ви можете передати його як перший параметр до Cookie.remove.

Приклади:

Зберігає Cookie на тривалість сесії:

var myCookie = Cookie.write('username', 'Harald');

Зберігає Cookie на день:

var myCookie  = Cookie.write('username', 'JackBauer', {duration: 1});

Метод Cookie: read

Зчитує значення Cookie.

Синтаксис:

var myCookie = Cookie.read(name);

Аргументи:

  1. name - (рядок) Назва Cookie для отримання.

Повертає:

  • (mixed) Рядкове значення cookie, або null, якщо не знайдено.

Приклади:

Cookie.read("username");

Метод Cookie: dispose

Видаляє cookie з браузера.

Синтаксис:

var oldCookie = Cookie.dispose(cookie[, options]);

Аргументи:

  1. name - (рядок) Назва cookie для видалення або попередньо збережений екземпляр Cookie.
  2. options - (об'єкт, опціонально) Див. Cookie.

Приклади:

Видалити Cookie:

Cookie.dispose('username'); //Bye-bye JackBauer! Seeya in 24 Hours.

Створення Cookie та його негайне видалення:

var myCookie = Cookie.write('username', 'Aaron', {domain: 'mootools.net'});
if (Cookie.read('username') == 'Aaron') { Cookie.dispose(myCookie); }


Эта документация распостраняется на правах Attribution-NonCommercial-ShareAlike 3.0 License.
Оригинал документации на английском.
© Linux.ria.com, 2008-2026