انتقل إلى محتوى الدرس

Three Parameters of pushState معاملات دالة pushState الثلاثة

أتقن تحديث شريط العنوان بدون إعادة تحميل الصفحة عبر history.pushState() وreplaceState() في JavaScript، وتعرّف على معاملاتهما الثلاثة وقيد نفس الأصل الأمني.
3 صفوف تعليمية
جافا سكريبت
3,331 مشاهدة

شرح صفوف ومحتوى الفقرة

الصف 1 شرح توضيحي

تستقبل الدالة history.pushState(state, unused, url) ثلاثة معاملات بالترتيب التالي:

  1. state: كائن بيانات قابل للاستنساخ (مثل { section: "pricing" }) أو null، يُحفظ في المدخل الجديد ويُقرأ عبر history.state.
  2. unused: معامل تاريخي قديم تتجاهله جميع المتصفحات الحديثة؛ مرّر مكانه دائماً سلسلة نصية فارغة ""، وحدّث عنوان التبويب صراحةً عبر document.title.
  3. url (اختياري): المسار النسبي أو معامل البحث الجديد (مثل "/courses/js" أو "?step=2")، ويُحسب نسبةً للرابط الحالي ضمن نفس الأصل.
الصف 2 كود برمجي
JavaScript
const log = document.getElementById('ps-out');
let stepNum = 1;
document.getElementById('next-step').onclick = function () {
  stepNum += 1;
  const data = { step: stepNum };
  try { history.pushState(data, '', '?step=' + stepNum); }
  catch (e) { history.pushState(data, ''); }
  document.title = 'Wizard — Step ' + stepNum;
  const s = history.state.step;
  log.textContent = 'Step ' + s + ' | len: ' + history.length;
};
الصف 3 ملاحظة هامة