Плагин jQuery Cookie

jQuery может управлять cookie через плагин jquery.cookie.js.

Официальный сайт:http://plugins.jquery.com/cookie/

Адрес GitHub:https://github.com/carhartl/jquery-cookie

Перед использованием jquery.cookie.js необходимо подключить jQuery:

<script src="/path/to/jquery.min.js"></script> <script src="/path/to/jquery.cookie.js"></script>

Мы можем использовать стороннюю библиотеку ресурсов, чтобы подключить эти два файла:

<script src="https://cdn.staticfile.org/jquery/3.4.0/jquery.min.js"></script> <script src="https://cdn.staticfile.org/jquery-cookie/1.4.1/jquery.cookie.min.js"></script>

Использование

Создайте cookie:

$.cookie('name', 'value');

Если срок действия не указан, cookie будет удален при закрытии браузера.

Создайте cookie и установите для него срок действия 7 дней:

$.cookie('name', 'value', { expires: 7 });

Создайте cookie и установите допустимый path cookie в корневой каталог сайта:

$.cookie('name', 'value', { expires: 7, path: '/' });

Примечание:По умолчанию только веб-страница, устанавливающая cookie, может читать этот cookie. Если вы хотите, чтобы одна страница могла читать cookie, установленный другой страницей, необходимо задать path cookie. path cookie используется для установки каталога верхнего уровня, который может читать cookie. Установка этого path в корневой каталог сайта позволяет всем веб-страницам читать cookie друг друга (обычно не следует устанавливать его так, чтобы избежать конфликтов).

Прочитайте cookie:

$.cookie('name'); // => "value"
$.cookie('nothing'); // => undefined

Прочитайте всю информацию о cookie:

$.cookie(); // => { "name": "value" }

Удалите cookie:

//Возвращает true, если удаление cookie прошло успешно, в противном случае возвращает false $.removeCookie('name'); // => true $.removeCookie('ничего'); // => false //Когда path используется для записи, те же атрибуты (path, domain) должны также использоваться для чтения. $.cookie('name', 'value', { path: '/' }); //Следующий код [не удаляет] $.removeCookie('name'); // => false //Следующий код [успешно удаляет] $.removeCookie('name', { path: '/' }); // => true

Примечание:При удалении cookie необходимо передать точно такие же path, domain и параметры безопасности, которые использовались при установке cookie.

Пример

$(document).ready(function(){ $.cookie('name', 'example'); //Создание cookie name = $.cookie('name'); //Чтение cookie $("#test").text(name); $.cookie('name2', 'example2', { expires: 7, path: '/' }); name2 = $.cookie('name2'); $("#test2").text(name2); });

Попробуйте сами »

После выполнения мы можем просмотреть информацию о cookie в браузере, как показано на рисунке ниже:


Описание параметра

raw

Значение по умолчанию: false.

По умолчанию кодирование и декодирование выполняются автоматически при чтении и записи файлов cookie (для кодирования используется encodeURIComponent, для декодирования — decodeURIComponent). Чтобы отключить эту функцию, установите raw: true:

$.cookie.raw = true;

json

Настройте хранение и чтение данных cookie с использованием JSON, чтобы вам не нужно было использовать JSON.stringify и JSON.parse.

$.cookie.json = true;

expires

expires: 365

Определяет срок действия cookie. Значением может быть число (в днях, отсчитываемых с момента создания cookie) или объект Date. Если параметр опущен, созданный cookie является сессионным и будет удалён при выходе пользователя из браузера.

path

path: '/'

По умолчанию: только веб-страница, установившая cookie, может читать этот cookie.

Определяет допустимый путь cookie. По умолчанию значением этого параметра является путь веб-страницы, создавшей cookie (стандартное поведение браузера).

Если вы хотите получить доступ к этому cookie на всём сайте, нужно задать допустимый путь так: path: '/'. Если вы хотите удалить cookie, для которого задан допустимый путь, нужно указать этот путь при вызове функции:

$.cookie('the_cookie', null,{ path: '/' });

domain

domain: 'example.com'

Значение по умолчанию: домен веб-страницы, создавшей cookie.

secure

secure: true

Значение по умолчанию: false. Если true, передача cookie требует защищённого протокола (HTTPS).

Другие расширения