API‌های کارگر وب

API Web Storage یک نحوه ساده برای ذخیره‌سازی و بازیابی داده‌ها در مرورگر است. این بسیار آسان است:

مثال

localStorage.setItem("name", "Bill Gates");
localStorage.getItem("name");

آزمایش کنید

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

Chrome IE Firefox Safari Opera
Chrome IE/Edge Firefox Safari Opera
پشتیبانی می‌کند پشتیبانی می‌کند پشتیبانی می‌کند پشتیبانی می‌کند پشتیبانی می‌کند

شیء localStorage

شیء localStorage دسترسی به ذخیره‌سازی محلی یک وب‌سایت خاص را فراهم می‌کند. این به شما اجازه می‌دهد داده‌های موجود در دامنه را ذخیره، خواندن، اضافه کردن، تغییر و حذف کنید.

داده‌های ذخیره‌سازی شده دارای تاریخ انقضا نیستند و در صورت بسته شدن مرورگر حذف نمی‌شوند.

این داده‌ها در چند روز، چند هفته و چند سال قابل استفاده خواهند بود.

روش setItem()

روش localStorage.setItem() داده‌های موجود را در storage ذخیره می‌کند.

این یک نام و یک مقدار به عنوان پارامتر می‌پذیرد:

مثال

localStorage.setItem("name", "Bill Gates");

روش getItem()

روش localStorage.getItem() داده‌های موجود در ذخیره‌سازی (storage) را بازیابی می‌کند.

این یک نام به عنوان پارامتر می‌پذیرد:

مثال

localStorage.getItem("name");

شیء sessionStorage

شیء sessionStorage با شیء localStorage مشابه است.

تفاوت اصلی این است که شیء sessionStorage داده‌های نشست را ذخیره می‌کند.

وقتی مرورگر بسته می‌شود، داده‌ها حذف می‌شوند.

مثال

sessionStorage.getItem("name");

آزمایش کنید

روش setItem()

روش sessionStorage.setItem() داده‌های موجود را در ذخیره‌سازی (storage) ذخیره می‌کند.

این یک نام و یک مقدار به عنوان پارامتر می‌پذیرد:

مثال

sessionStorage.setItem("name", "Bill Gates");

روش getItem()

روش sessionStorage.getItem() داده‌های موجود در ذخیره‌سازی (storage) را بازیابی می‌کند.

این یک نام به عنوان پارامتر می‌پذیرد:

مثال

sessionStorage.getItem("name");

ویژگی‌ها و روش‌های شیء Storage

ویژگی/روش توضیح
key(n) نام کلید n-ام را از ذخیره‌سازی برمی‌گرداند.
length تعداد داده‌هایی که در Storage شیء ذخیره شده‌اند را برمی‌گرداند.
getItem(keyname) مقدار مشخص شده برای کلید را برمی‌گرداند.
setItem(keyname, value) این کلید را به ذخیره‌سازی اضافه می‌کند، یا اگر این کلید قبلاً وجود دارد، مقدار آن را به‌روزرسانی می‌کند.
removeItem(keyname) این کلید را از ذخیره‌سازی حذف می‌کند.
clear() تمام کلیدها را خالی می‌کند.

صفحات مرتبط با Web Storage API

خصوصیات توضیح
window.localStorage اجازه می‌دهد تا کلید/مقدار در مرورگر وب ذخیره شود. داده‌هایی که تاریخ انقضا ندارند را ذخیره می‌کند.
window.sessionStorage اجازه می‌دهد تا کلید/مقدار در مرورگر وب ذخیره شود. داده‌های یک جلسه را ذخیره می‌کند.