ویژگی cookie HTML DOM Document

تعریف و استفاده

کوکی تنظیمات یا بازگشت ویژگی‌ها با نقطه و کلمه‌ی جداکننده کلید=مقدار لیست (کوکی‌های مستند).

مثال ایجاد کوکی:

document.cookie="username=Bill Gates; expires=Thu, 18 Dec 2013 12:00:00 UTC; path=/";

توجه:کوکی نمی‌تواند شامل کاما، نقطه و کلمه‌ی خالی باشد.مетод encodeURIComponent() مطمئن می‌شوند که این‌ها نیستند.

لطفاً به: مراجعه کنید

آموزش کوکی‌های JavaScript

پیشنهاد:

گاهی Storage API ابزار بهتری است:

ویژگی localStorage

ویژگی sessionStorage

مثال

همه کوکی‌های مرتبط با این مستند را دریافت کنید:

let allCookies = document.cookie;

تست کنید

منطق

کوکی را بازگردانید:

document.cookie

کوکی را تنظیم کنید:

document.cookie = newCookie

پارامتر

با جداکننده‌ی موازی name=مقدار برای لیست، پس از هر گزینه انتخابی:

expires=date
تاریخ به فرمت GMT (با استفاده از روش Date.toUTCString).
مقدار پیش‌فرض: حذف کوکی در بستن مرورگر.
max-age=seconds
سناری کوکی حداکثر قبل از حذف. اگر 0 یا تاریخ گذشته باشد، کوکی حذف شود.
path=path
مسیر کوکی متعلق به دایرکتوری ('/dir'). مقدار پیش‌فرض: دایرکتوری فعلی.
domain=domainname
دامنه وب‌سایت ('example.com'). مقدار پیش‌فرض: دامنه مستند.
secure
کوکی‌ها را با استفاده از پروتکل امن (https) به سرور ارسال کنید.

مقدار بازگشتی

نوع توضیحات
زبان با جداکننده‌ی موازی کلید=مقدار برای لیست (کوکی‌های مستند).

کوکی‌ها با ذخیره‌سازی محلی

کوکی‌ها برای برنامه‌های کاربری-سرور (مرورگر-سرور) استفاده می‌شوند.

ذخیره‌سازی محلی (Local Storage) برای برنامه‌های کاربری (مرورگر) استفاده می‌شود.

کوکی‌ها با وب‌سایت مرتبط هستند. ارسال کوکی در هر سربرگ HTTP هنگامی که داده‌ها برای استفاده توسط کاربر سرور ارسال می‌شود، ضایعات باندwidth است.

معمولاً مرورگر برخی کاربران کوکی‌ها را غیرفعال می‌کند.

حداکثر اندازه کوکی 4 کیلوبایت است. برای هر دامنه ذخیره‌سازی محلی، حداکثر 5 مگابایت است.

کوکی‌ها دارای تاریخ انقضا هستند. ذخیره‌سازی محلی اینطور نیست.

پشتیبانی مرورگر

document.cookie یک ویژگی DOM Level 2 (2001) است.

همه مرورگرها از آن پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی 9-11 پشتیبانی پشتیبانی پشتیبانی پشتیبانی