کتابخانه
js-cookie یه کتابخانه جاوااسکریپت ساده و خیلی سبکه که کار با کوکی های مرورگر رو راحت می کنه. با چند تا متد کوتاه می تونی کوکی بسازی، بخونی و پاک کنی و لازم نیست با رشته خام document.cookie سروکله بزنی. مجوزش MIT هست و به کتابخانه دیگه ای وابسته نیست.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.
۱۴ کیلوبایت· ۷ فایل· انتشار
SHA-256: 506834dde81524c74ba93c40c73ac0316fb8d4f860f816353a5562b2f8118c12
اگه تا حالا مستقیم با document.cookie کار کرده باشی، می دونی چقدر اذیت می کنه. همه کوکی ها توی یه رشته بلند جمع شدن. برای خوندن یه مقدار باید رشته رو خودت تیکه تیکه کنی، تاریخ انقضا باید با فرمت خاصی نوشته بشه و کاراکترهای خاص هم باید درست کدگذاری بشن. js-cookie این دردسرها رو توی یه API کوچیک و خوانا جمع کرده: با Cookies.set مقدار می ذاری، با Cookies.get می خونی و با Cookies.remove پاکش می کنی.
کاربردهاش توی سایت های معمولی زیاده. مثلا می تونی یادت بمونه کاربر بنر تخفیف شب یلدا رو بسته و دوباره نشونش ندی. زبان انتخابی، حالت تیره سایت و پارامتر کمپین تبلیغاتی رو هم می شه با کوکی نگه داشت. اگه سایت وردپرسی داری و قالب یا افزونه خودت رو می نویسی، js-cookie یه فایل جاوااسکریپت مستقله و به jQuery نیازی نداره. فقط همون رو توی صفحه لود می کنی و سایت سنگین نمی شه.
چند جا هم انتخاب درستی نیست. اطلاعات حساس مثل توکن ورود یا نشانه نشست کاربر رو با جاوااسکریپت توی کوکی نذار. کوکی های HttpOnly از سمت جاوااسکریپت نه خونده می شن و نه نوشته، پس برای ورود کاربر باید خود سرور کوکی رو بسازه. اندازه هر کوکی هم محدوده، حدود چهار کیلوبایت، و کوکی ها با هر درخواست به سرور فرستاده می شن. داده حجیم رو اونجا ذخیره نکن. برای اون کارها localStorage یا یه راه حل سمت سرور بهتره.
موقع استفاده چند نکته رو یادت باشه. گزینه expires بر حسب روز حساب می شه و اگه ندی، کوکی تا بسته شدن مرورگر می مونه. گزینه های path، domain، secure و sameSite هم هست. مهم ترینش اینه که برای پاک کردن کوکی باید همون path و domain زمان ساخت رو بدی. وگرنه مرورگر یه کوکی دیگه رو هدف می گیره و کوکی اصلی سر جاش می مونه. اگه مقدار ذخیره شده شیء یا آرایه باشه، بهتره خودت قبلش با JSON.stringify تبدیلش کنی و موقع خوندن با JSON.parse برگردونیش.
نسخه های رسمی و بدون تغییر js-cookie رو توی مخزن داخلی ما هم نگه داشتیم. وقتی دسترسی به npm یا CDN های خارجی قطعه، می تونی فایل رو از همین صفحه برداری و روی هاست خودت بذاری.
استفاده ازش خیلی ساده است و لازم نیست ابزار ساخت یا npm روی سرور داشته باشی. مراحل کلی اینه:
بعد از نوشتن کد، بخش Application یا Storage ابزار توسعه دهنده مرورگر رو باز کن و ببین کوکی با مقدار و انقضای درست ساخته شده یا نه.
js-cookie یه کتابخانه کوچیک جاوااسکریپت برای ساختن، خوندن و پاک کردن کوکی های مرورگره. به جای کار با رشته خام document.cookie چند تا متد ساده بهت می ده. برای یادآوری بسته شدن بنر، ذخیره زبان یا تم سایت و نگه داشتن پارامتر کمپین خیلی به درد می خوره.
کوکی ها با هر درخواست به سرور فرستاده می شن و می تونن تاریخ انقضا، دامنه و مسیر داشته باشن، ولی ظرفیتشون کمه. localStorage ظرفیت بیشتری داره و به سرور فرستاده نمی شه. اگه سرور باید مقدار رو ببینه، کوکی بهتره. اگه فقط مرورگر بهش نیاز داره، localStorage معمولا راحت تره.
معمولا دلیلش اینه که path یا domain موقع حذف با زمان ساخت فرق داره. مرورگر کوکی ها رو با اسم، دامنه و مسیر از هم تشخیص می ده. همون گزینه هایی که به Cookies.set دادی رو به Cookies.remove هم بده. بعدش توی ابزار توسعه دهنده مرورگر هم چک کن که پاک شده باشه.
آره، js-cookie به jQuery وابسته نیست و یه فایل مستقله. کافیه با wp_enqueue_script توی قالب یا افزونه لودش کنی و کد خودت رو وابسته بهش ثبت کنی. اگه یه افزونه دیگه قبلا همین کتابخانه رو لود کرده، دوباره لودش نکن تا تداخل پیش نیاد.
نه. کوکی HttpOnly عمدا از دید جاوااسکریپت پنهان می شه تا امنیت بیشتری داشته باشه، و js-cookie هم یه کتابخانه جاوااسکریپته. برای کوکی هایی مثل نشست ورود کاربر، خود سرور باید کوکی رو تنظیم کنه، نه کد سمت مرورگر.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.