JavaScript Tutorial فصل ۵ — جاوااسکریپت مدرن درس آموزشی

الگوی پروژه واقعی — ترکیب همه درس‌ها

در این درس همه مفاهیم را در یک کامپوننت واقعی جمع می‌کنید: ابزار جستجوی زنده با داده محلی — state در آبجکت، رندر تابعی، تفویض رویداد، debounce، localStorage برای تاریخچه و try/catch در لود داده. این ساختار پایه همه کامپوننت‌های JS (و مینی‌کپی الگوی فریمورک‌ها) است: state → render → events → effects. همین الگو را بفهمید و در هر پروژه کوچک تا متوسط، بدون فریمورک حرفه‌ای کد می‌زنید.

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

  1. ۱

    ساختار کامپوننت

    کامپوننت با تابع init(container) شروع می‌شود: انتخاب المان‌ها، state اولیه، بستن listenerها و رندر اولیه — همه در یک تابع بسته‌شده (encapsulated) بدون آلودگی global.

  2. ۲

    state و render

    const state = { query: '', history: [] }؛ render() فقط از state می‌خواند؛ تغییر همیشه با تابع setQuery(q) که state را عوض و render را صدا می‌زند — یک مسیر تغییر، دیباگ ساده.

  3. ۳

    رویداد و debounce

    input با debounce ۲۰۰ms → setQuery؛ کلیک نتیجه → addToHistory با ذخیره در localStorage و رندر دوباره — جریان کامل داده-UI.

  4. ۴

    تست دستی و پولیش

    سناریوها را تست کنید: جستجوی خالی، نتایج صفر، تاریخچه تکراری، رفرش صفحه با تاریخچه‌ی ذخیره‌شده — هر باگ، یک try/catch یا شرط guard اضافه می‌کند.

نکات مهم

  • ◆ نام توابع کامپوننت را با پیش‌فکس بگذارید یا همه را داخل یک آبجکت — بدون تداخل global.
  • ◆ قبل از افزودن فریمورک، ببینید کامپوننت واقعاً به اندازه کافی پیچیده است یا نه.
  • ◆ کد را در فایل جدا و با defer لود کنید؛ اسکریپت inline در پنل‌های مدیریت مشکل امنیتی و نگهداری می‌سازد.

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

function initSearch(container) {
  const input = container.querySelector('input');
  const list = container.querySelector('.results');
  const state = { query: '', history: JSON.parse(localStorage.getItem('rw_hist') ?? '[]') };

  function render() {
    const q = state.query.trim().toLowerCase();
    const items = TOOLS.filter(t => !q || t.name.includes(q));
    list.innerHTML = items.map(t => `<li>${t.name}</li>`).join('')
      || '<li class="empty">نتیجه‌ای نیست</li>';
  }

  let timer;
  input.addEventListener('input', () => {
    clearTimeout(timer);
    timer = setTimeout(() => {
      state.query = input.value;
      render();
    }, 200);
  });

  render();
}

initSearch(document.querySelector('#tool-search'));