في هذا الدرس 4تصفّح المواضيع
قبل ظهور واجهة السجل الحديثة في HTML5، كان تعديل مسار الرابط يفرض دائماً إعادة تحميل الصفحة بالكامل ومسح ذاكرة التطبيق؛ أما الدالة window.history.pushState(state, unused, url) فقد أحدثت نقلةً كبرى: إذ تحدّث الرابط الظاهر في شريط المتصفح وتضيف خطوة جديدة لمكدس الجلسة فوراً وبدون أي طلب شبكة أو إعادة تحميل!
انتبه لسلوكين دقيقين لحظة استدعاء pushState(): لا يرسل المتصفح حينها طلباً للخادم لجلب المسار الجديد، ولا يُطلق حدث popstate أثناء الاستدعاء البرمجي نفسه (بل يُطلق لاحقاً عند ضغط المستخدم زر الرجوع).
تستقبل الدالة history.pushState(state, unused, url) ثلاثة معاملات بالترتيب التالي:
state: كائن بيانات قابل للاستنساخ (مثل{ section: "pricing" }) أوnull، يُحفظ في المدخل الجديد ويُقرأ عبرhistory.state.unused: معامل تاريخي قديم تتجاهله جميع المتصفحات الحديثة؛ مرّر مكانه دائماً سلسلة نصية فارغة""، وحدّث عنوان التبويب صراحةً عبرdocument.title.url(اختياري): المسار النسبي أو معامل البحث الجديد (مثل"/courses/js"أو"?step=2")، ويُحسب نسبةً للرابط الحالي ضمن نفس الأصل.
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;
};
تخيل حقل بحث حي يحدث معامل الرابط ?q=... مع كل حرف يكتبه المستخدم؛ لو استدعيت pushState() عند كل حرف لاضطر الزائر للضغط على زر الرجوع عشر مرات للخروج من البحث! وهنا تبرز أهمية الدالة الشقيقة window.history.replaceState(state, "", url) التي تأخذ نفس المعاملات الثلاثة وتحدث الرابط والحالة في موضعهما الحالي دون زيادة طول السجل:
| الدالة البرمجية | الأثر على history.length | الحالة المثالية في تجربة المستخدم |
|---|---|---|
history.pushState(s, "", url) | تضيف خطوة رجوع جديدة (+1) | الانتقال الواضح بين شاشات أو أقسام رئيسية مستقلة |
history.replaceState(s, "", url) | تعدل المدخل الحالي في مكانه (+0) | تصفية البحث الفورية، وتغيير الترتيب، وتهيئة الحالة الأولية |
بما أن pushState() وreplaceState() تغيران النص المعروض في شريط عناوين المتصفح دون تحميل الصفحة من خادم جديد، فتخيل حجم الكارثة لو تمكن موقع خبيث من تغيير شريط العنوان ليظهر كأنه موقع مصرفك الحقيقي!
لمنع تزوير شريط العناوين نهائياً، يفرض المتصفح قيد نفس الأصل الصارم (Same-Origin Restriction): يجب أن يطابق الرابط الجديد في pushState() وreplaceState() البروتوكول واسم المضيف ورقم المنفذ للصفحة الحالية تطابقاً تاماً، ولا يُسمح إلا بتغيير المسار pathname والاستعلام search والمرساة hash؛ وأي محاولة لتمرير نطاق مغاير تفشل فوراً باستثناء SecurityError.
const out = document.getElementById('sec-ps');
try {
const badUrl = 'https://spoof-domain.example/login';
window.history.pushState({}, '', badUrl);
out.textContent = 'Unexpected success';
} catch (err) {
out.textContent = 'Blocked foreign URL: ' + err.name;
}
ملخص الدرس
حصاد الدرسمراجعة مركّزة لأهم المفاهيم والقواعد الهندسية التي أتقنتها في هذا الدرس قبل التطبيق العملي
ماذا تعلّمت في هذا الدرس؟
أتقنت في هذا الدرس تحديث الروابط بدون إعادة تحميل عبر history.pushState(state, "", url)، وفهمت معاملاته الثلاثة ومزامنة document.title، وقارنت بينه وبين التعديل الموضعي في replaceState()، وتحققت عملياً من منع تزوير النطاق عبر استثناء SecurityError. الخطوة التالية: انتقل الآن إلى درس «تطبيقات الصفحة الواحدة SPA في JavaScript» لجمع pushState وحدث popstate في بناء موجّه SPA متكامل.
سجّل الدخول لحفظ تقدمك
تابع إنجاز المواضيع والمصطلحات والمهام، وكمّل من آخر خطوة على أي جهاز.
المصطلحات3
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 history.pushState() دالة إضافة مدخل وتحديث الرابط pushState
- تضيف خطوة جديدة لمكدس سجل الجلسة وتحدث مسار الرابط ضمن نفس الأصل دون إعادة تحميل الصفحة.
- للمراجعة
- 02 history.replaceState() دالة تعديل المدخل الحالي replaceState
- تعدل كائن البيانات ومسار الرابط للمدخل الحالي في موضعه دون إضافة خطوة رجوع جديدة للسجل.
- للمراجعة
- 03 SecurityError استثناء مخالفة الأصل SecurityError
- خطأ أمني يرميه المتصفح فوراً إذا مُرّر إلى pushState أو replaceState رابط يختلف أصله عن الصفحة الحالية.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
الاختصارات2
راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.
- 01 HTML5 HTML5
- HyperText Markup Language 5
- الجيل القياسي الحديث للويب الذي قدّم دالتي pushState وreplaceState لدعم التوجيه بدون تحميل.
- للمراجعة
- 02 SOP SOP
- Same-Origin Policy
- سياسة نفس الأصل التي تمنع استخدام pushState لتزوير اسم نطاق موقع آخر في شريط العنوان.
- للمراجعة
لا توجد بطاقات تطابق البحث والتصفية.
اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.
مهامك قبل الاختبار
خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.
-
انقر زر الخطوة التالية عدة مرات في محرر التجربة وراقب تزايد رقم الخطوة المحفوظ في history.state.
-
شغّل مثال منع التزوير عبر الأصول وتأكد من إطلاق المتصفح لاستثناء SecurityError عند تمرير نطاق خارجي.
تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.
اختبر فهمك.
ووصلها للإتقان.
كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.
أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.
الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.