JavaScript Tutorial فصل ۴ — DOM و رویدادها درس آموزشی

JSON و ذخیره‌سازی محلی — localStorage

JSON فرمت متنی داده است که همه APIها با آن کار می‌کنند: JSON.stringify(obj) به متن و JSON.parse(text) به آبجکت. localStorage حافظه‌ی مرورگر برای داده کوچک پایدار: localStorage.setItem('theme', 'dark') و خواندن با getItem — همه‌چیز رشته است پس آبجکت را باید stringify/parse کنید. کاربردهای واقعی: ذخیره تم کاربر، سبد خرید موقت، تنظیمات ابزارها. محدودیت: حدود ۵MB، فقط رشته، و مخصوص دامنه سایت.

مراحل قدم‌به‌قدم

  1. ۱

    چرخه JSON

    const settings = { theme: 'dark', lang: 'fa' }؛ const text = JSON.stringify(settings)؛ const back = JSON.parse(text)؛ در کنسول هر سه را چاپ کنید تا تبدیل را ببینید.

  2. ۲

    ذخیره و خواندن

    localStorage.setItem('settings', JSON.stringify(settings))؛ خواندن با JSON.parse(localStorage.getItem('settings') ?? '{}')؛ حواستان به مقدار پیش‌فرض برای بار اول باشد.

  3. ۳

    ذخیره آرایه داده

    لیست علاقه‌مندی‌ها: favorites.push(id) و دوباره ذخیره؛ در لود صفحه بخوانید و UI را بر اساسش بسازید — پایه قابلیت بوکمارک بدون حساب کاربری.

  4. ۴

    پاک‌سازی و کلیدها

    localStorage.removeItem('key') و clear() برای همه؛ کلیدها را با پیش‌فکس (rw_theme) بنویسید تا با اسکریپت‌های دیگر تداخل نکنند.

نکات مهم

  • ◆ localStorage همگام (synchronous) است — داده خیلی بزرگ رندر را بلاک می‌کند؛ برای داده بزرگ IndexedDB.
  • ◆ JSON.parse روی متن خراب خطا می‌دهد؛ در try/catch بپیچید.
  • ◆ داده حساس (رمز، توکن) در localStorage نگذارید؛ هر اسکریپت صفحه به آن دسترسی دارد.

کد یا مسیر نمونه

const KEY = 'rw_settings';

function saveSettings(settings) {
  localStorage.setItem(KEY, JSON.stringify(settings));
}

function loadSettings() {
  try {
    return JSON.parse(localStorage.getItem(KEY)) ?? {};
  } catch {
    return {};
  }
}

saveSettings({ theme: 'dark' });
console.log(loadSettings().theme);