انتقل إلى محتوى الدرس
الدرس 87
تاريخ النشر: تاريخ التحديث:
دورة جافا سكريبت

تحديث الرابط عبر history pushState في JavaScriptJavaScript History pushState Method طريقة تحديث الرابط بدون تحميل، وتعديل المدخل عبر replaceState، ومعاملات دالة pushState الثلاثة

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

قبل ظهور واجهة السجل الحديثة في HTML5، كان تعديل مسار الرابط يفرض دائماً إعادة تحميل الصفحة بالكامل ومسح ذاكرة التطبيق؛ أما الدالة window.history.pushState(state, unused, url) فقد أحدثت نقلةً كبرى: إذ تحدّث الرابط الظاهر في شريط المتصفح وتضيف خطوة جديدة لمكدس الجلسة فوراً وبدون أي طلب شبكة أو إعادة تحميل!

انتبه لسلوكين دقيقين لحظة استدعاء pushState(): لا يرسل المتصفح حينها طلباً للخادم لجلب المسار الجديد، ولا يُطلق حدث popstate أثناء الاستدعاء البرمجي نفسه (بل يُطلق لاحقاً عند ضغط المستخدم زر الرجوع).

مخطط مقارنة دالتي history.pushState وhistory.replaceState ومعاملاتهما الثلاثة وقيد نفس الأصل الأمني

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

  1. state: كائن بيانات قابل للاستنساخ (مثل { section: "pricing" }) أو null، يُحفظ في المدخل الجديد ويُقرأ عبر history.state.
  2. unused: معامل تاريخي قديم تتجاهله جميع المتصفحات الحديثة؛ مرّر مكانه دائماً سلسلة نصية فارغة ""، وحدّث عنوان التبويب صراحةً عبر document.title.
  3. url (اختياري): المسار النسبي أو معامل البحث الجديد (مثل "/courses/js" أو "?step=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;
};

تخيل حقل بحث حي يحدث معامل الرابط ?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.

JavaScript
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

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 3 مفهومةأول بطاقة، أول خطوة
01 history.pushState() دالة إضافة مدخل وتحديث الرابط pushState
تضيف خطوة جديدة لمكدس سجل الجلسة وتحدث مسار الرابط ضمن نفس الأصل دون إعادة تحميل الصفحة.
للمراجعة
02 history.replaceState() دالة تعديل المدخل الحالي replaceState
تعدل كائن البيانات ومسار الرابط للمدخل الحالي في موضعه دون إضافة خطوة رجوع جديدة للسجل.
للمراجعة
03 SecurityError استثناء مخالفة الأصل SecurityError
خطأ أمني يرميه المتصفح فوراً إذا مُرّر إلى pushState أو replaceState رابط يختلف أصله عن الصفحة الحالية.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

حروف قليلة. معنى كامل.

الاختصارات2

راجع المعنى، اشرحه لنفسك، ثم علّم البطاقة كمفهومة.

0 / 2 مفهومةأول بطاقة، أول خطوة
01 HTML5 HTML5
HyperText Markup Language 5
الجيل القياسي الحديث للويب الذي قدّم دالتي pushState وreplaceState لدعم التوجيه بدون تحميل.
للمراجعة
02 SOP SOP
Same-Origin Policy
سياسة نفس الأصل التي تمنع استخدام pushState لتزوير اسم نطاق موقع آخر في شريط العنوان.
للمراجعة

اقرأ البطاقات بحرية. سجّل الدخول لحفظ تقدم مراجعتك.

من الفهم للتطبيق

مهامك قبل الاختبار

خطوة صغيرة كل مرة. وإنجاز تقدر ترجع له.

0/2مهام منجزة
  1. انقر زر الخطوة التالية عدة مرات في محرر التجربة وراقب تزايد رقم الخطوة المحفوظ في history.state.

  2. شغّل مثال منع التزوير عبر الأصول وتأكد من إطلاق المتصفح لاستثناء SecurityError عند تمرير نطاق خارجي.

تأشير المهمة إقرار منك بإتمامها، وليس تصحيحًا آليًا للكود. يُحفظ تقدمك في حسابك.

مساحة التحدي

اختبر فهمك.
ووصلها للإتقان.

كل سؤال خطوة لقدّام. اختار، اكتب كود، وشوف نتيجتك فورًا.

10أسئلة 2أنواع تحديات 100%هدف الإتقان
تصحيح تلقائي. فرص بلا حدود.

أكمل المهام، واجمع كل الإجابات الصحيحة. أقل من 100%؟ راجع وأعد المحاولة.

الأسئلة متاحة للاطلاع. سجّل الدخول للتفاعل وحفظ تقدمك.

لمحة عن التحدي10 أسئلة تنتظرك
01

ماذا يحدث على مستوى الشبكة لحظة استدعاء history.pushState({ tab: 2 }, "", "/courses")؟

02

ما القيمة القياسية الموصى بتمريرها في المعامل الثاني (unused) للدالة history.pushState؟

03

أي دالة ينبغي استخدامها لمزامنة حقل بحث فوري مع كل حرف يُكتب دون إغراق زر الرجوع بعشرات الخطوات؟

04

ماذا يحدث إذا حاول كود يعمل على https://shop.example استدعاء history.pushState({}, "", "https://bank.example/login")؟

05

استدعاء الدالة history.pushState() يُطلق حدث popstate تلقائياً في اللحظة نفسها.

06

استدعاء الدالة history.replaceState() يبقي قيمة window.history.length ثابتة دون زيادة.

07

لماذا يجب إعداد خادم الويب بمسار احتياطي عندما يدفع تطبيق الواجهة مسارات نظيفة مثل "/courses/bom" عبر pushState()؟

08

ما الأجزاء المسموح بتغييرها من الرابط عند استدعاء الدالة history.pushState()؟

09

المعامل الثالث (url) في دالة history.pushState اختياري؛ وحذفه يضيف حالة جديدة للسجل مع الإبقاء على عنوان الصفحة الحالي.

10

كيف تحدّث نص عنوان علامة التبويب في المتصفح بعد استدعاء history.pushState()؟