chrome.webNavigation

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.webNavigation لتلقّي إشعارات بشأن حالة طلبات التنقّل قيد التنفيذ.

الأذونات

webNavigation

البيان

تتطلّب جميع طرق chrome.webNavigation وأحداثها الإفصاح عن إذن "webNavigation" في بيان الإضافة. على سبيل المثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "webNavigation"
  ],
  ...
}

ترتيب الأحداث

بالنسبة إلى عملية التنقّل التي يتم إكمالها بنجاح، يتم تنشيط الأحداث بالترتيب التالي:

onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted

يؤدي أي خطأ يحدث أثناء العملية إلى حدث onErrorOccurred. بالنسبة إلى عملية تنقّل معيّنة، لن يتم تنشيط أي أحداث أخرى بعد onErrorOccurred.

إذا كان إطار التنقّل يحتوي على إطارات فرعية، يتم تشغيل onCommitted قبل أي onBeforeNavigate من الإطارات الفرعية، بينما يتم تشغيل onCompleted بعد تشغيل جميع onCompleted من الإطارات الفرعية.

في حال تغيير الجزء المرجعي من الإطار، يتم تنشيط الحدث onReferenceFragmentUpdated. يمكن أن يتم تشغيل هذا الحدث في أي وقت بعد onDOMContentLoaded، حتى بعد onCompleted.

إذا تم استخدام History API لتعديل حالة إطار (على سبيل المثال، باستخدام history.pushState())، سيتم تشغيل حدث onHistoryStateUpdated. يمكن أن يتم تنشيط هذا الحدث في أي وقت بعد onDOMContentLoaded.

إذا أدّى التنقّل إلى استعادة صفحة من ذاكرة التخزين المؤقت للصفحات، لن يتم تنشيط الحدث onDOMContentLoaded. لا يتم تشغيل الحدث لأنّه سبق أن تم تحميل المحتوى عند زيارة الصفحة للمرة الأولى.

إذا تم بدء عملية تنقّل من خلال البحث الفوري من Chrome أو الصفحات الفورية، يتم استبدال علامة التبويب الحالية بصفحة تم تحميلها بالكامل. في هذه الحالة، يتم تنشيط حدث onTabReplaced.

العلاقة بأحداث webRequest

ليس هناك ترتيب محدّد بين أحداث webRequest API وأحداث webNavigation API. من المحتمل أن يتم تلقّي أحداث webRequest حتى بالنسبة إلى الإطارات التي بدأت عملية تنقّل جديدة، أو ألا تتم عملية التنقّل إلا بعد تحميل موارد الشبكة بالكامل.

بشكل عام، ترتبط أحداث webNavigation ارتباطًا وثيقًا بحالة التنقّل المعروضة في واجهة المستخدم، بينما تتوافق أحداث webRequest مع حالة حزمة الشبكة التي تكون غير شفافة للمستخدم بشكل عام.

أرقام تعريف علامات التبويب

لا تتطابق جميع علامات التبويب التي يتم الانتقال إليها مع علامات التبويب الفعلية في واجهة مستخدم Chrome، مثل علامة التبويب التي يتم عرضها مسبقًا. لا يمكن الوصول إلى علامات التبويب هذه من خلال واجهة برمجة التطبيقات الخاصة بعلامات التبويب، كما لا يمكنك طلب معلومات عنها من خلال webNavigation.getFrame أو webNavigation.getAllFrames. وبعد تبديل علامة التبويب هذه، يتم تنشيط الحدث onTabReplaced، ويمكن الوصول إلى علامات التبويب من خلال واجهات برمجة التطبيقات هذه.

الطوابع الزمنية

يُرجى العِلم أنّ بعض المشاكل الفنية في طريقة تعامل نظام التشغيل مع عمليات Chrome المنفصلة يمكن أن تؤدي إلى اختلاف التوقيت بين المتصفح نفسه وعمليات الإضافة. وهذا يعني أنّ سمة timeStamp في أحداث WebNavigation لا يمكن ضمان أن تكون متسقة إلا داخليًا. ستمنحك مقارنة حدث بحدث آخر الإزاحة الصحيحة بينهما، ولكن مقارنتهما بالوقت الحالي داخل الإضافة (من خلال (new Date()).getTime()، على سبيل المثال) قد تؤدي إلى نتائج غير متوقعة.

معرّفات الإطارات

يمكن تحديد الإطارات داخل علامة تبويب من خلال معرّف إطار. يكون رقم تعريف الإطار الرئيسي دائمًا 0، بينما يكون رقم تعريف الإطارات الفرعية عددًا موجبًا. بعد إنشاء مستند في إطار، يظلّ معرّف الإطار ثابتًا طوال مدة بقاء المستند. اعتبارًا من الإصدار 49 من Chrome، يكون رقم التعريف هذا ثابتًا أيضًا طوال مدة بقاء الإطار (خلال عمليات التنقّل المتعددة).

بسبب طبيعة Chrome المتعددة العمليات، قد تستخدم علامة التبويب عمليات مختلفة لعرض المصدر والوجهة لصفحة ويب. لذلك، إذا تم التنقّل في عملية جديدة، قد تتلقّى أحداثًا من الصفحة الجديدة والصفحة القديمة إلى أن يتم إكمال عملية التنقّل الجديدة (أي يتم إرسال الحدث onCommitted للإطار الرئيسي الجديد). بعبارة أخرى، من الممكن أن يكون هناك أكثر من تسلسل واحد معلّق لأحداث webNavigation يحمل frameId نفسه. ويمكن التمييز بين التسلسلات باستخدام المفتاح processId.

يُرجى العِلم أيضًا أنّه أثناء التحميل المؤقت، قد يتم التبديل بين العمليتين عدة مرات. ويحدث ذلك عندما تتم إعادة توجيه عملية التحميل إلى موقع إلكتروني آخر. في هذه الحالة، ستتلقّى أحداثًا متكرّرة من النوع onBeforeNavigate وonErrorOccurred إلى أن تتلقّى الحدث النهائي onCommitted.

هناك مفهوم آخر يسبّب مشاكل في الإضافات وهو دورة حياة الإطار. يستضيف الإطار مستندًا (مرتبطًا بعنوان URL تم إثبات صحته). يمكن أن يتغيّر المستند (مثلاً من خلال التنقّل)، ولكن لن يتغيّر frameId، وبالتالي يصعب ربط حدث معيّن وقع في مستند محدّد باستخدام frameIds فقط. نقدّم مفهوم documentId وهو معرّف فريد لكل مستند. إذا تم الانتقال إلى إطار وفتح مستند جديد، سيتغير المعرّف. ويفيد هذا الحقل في تحديد وقت تغيير الصفحات لحالة دورة حياتها (بين العرض المسبق/النشط/المخزّن مؤقتًا) لأنّه يظل كما هو.

أنواع الانتقالات ومؤهلاتها

يحتوي الحدث onCommitted في واجهة برمجة التطبيقات webNavigation على السمتَين transitionType وtransitionQualifiers. نوع الانتقال هو نفسه المستخدَم في History API الذي يوضّح كيفية انتقال المتصفّح إلى عنوان URL هذا. بالإضافة إلى ذلك، يمكن عرض العديد من مؤهلات الانتقال التي تحدّد التنقّل بشكل أكبر.

تتوفّر مؤهلات الانتقال التالية:

مؤهّل الانتقالالوصف
"client_redirect"حدثت عملية إعادة توجيه واحدة أو أكثر بسبب علامات JavaScript أو علامات التحديث الوصفي على الصفحة أثناء التنقّل.
"server_redirect"حدثت عملية إعادة توجيه واحدة أو أكثر بسبب عناوين HTTP التي تم إرسالها من الخادم أثناء التنقّل.
"forward_back"استخدم المستخدِم زرّ "التالي" أو "زر الرجوع" لبدء عملية التنقّل.
"from_address_bar"بدأ المستخدم التنقّل من شريط العناوين (المعروف أيضًا باسم المربّع المتعدد الاستخدامات).

أمثلة

لتجربة واجهة برمجة التطبيقات هذه، ثبِّت مثال webNavigation API من مستودع chrome-extension-samples.

الأنواع

TransitionQualifier

Chrome 44 والإصدارات الأحدث

تعداد

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 والإصدارات الأحدث

سبب التنقّل يتم استخدام أنواع الانتقال نفسها المحدّدة في واجهة برمجة تطبيقات السجلّ. هذه هي أنواع الانتقال نفسها المحدّدة في History API باستثناء استخدام "start_page" بدلاً من "auto_toplevel" (للتوافق مع الإصدارات القديمة).

تعداد

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"generated"

"start_page"

"form_submit"

"reload"

"keyword"

"keyword_generated"

الطُرق

getAllFrames()

وعد 
chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
): Promise<object[] | undefined>

تستردّ هذه الطريقة معلومات عن جميع إطارات علامة تبويب معيّنة.

المعلمات

  • التفاصيل

    عنصر

    معلومات عن علامة التبويب التي سيتم استرداد جميع الإطارات منها

    • tabId

      الرقم

      معرّف علامة التبويب

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (details?: object[]) => void

    • التفاصيل

      object[] اختياري

      قائمة بالإطارات في علامة التبويب المحدّدة، أو قيمة فارغة إذا كان معرّف علامة التبويب المحدّد غير صالح

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • errorOccurred

        قيمة منطقية

        صحيح إذا تمّت مقاطعة آخر عملية تنقّل في هذا الإطار بسبب حدوث خطأ، أي تمّ تنشيط الحدث onErrorOccurred.

      • frameId

        الرقم

        معرّف الإطار تشير القيمة 0 إلى أنّ هذا هو الإطار الرئيسي، وتشير القيمة الموجبة إلى رقم تعريف إطار فرعي.

      • frameType

        FrameType

        Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        تمثّل هذه السمة معرّف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        رقم تعريف العملية التي تشغّل أداة العرض لهذه اللقطة.

      • url

        سلسلة

        تمثّل هذه السمة عنوان URL المرتبط حاليًا بهذا الإطار.

المرتجعات

  • Promise<object[] | undefined>

    الإصدار 93 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getFrame()

وعد 
chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
): Promise<object | undefined>

تستردّ هذه الطريقة معلومات عن الإطار المحدّد. يشير الإطار إلى <iframe> أو <frame> في صفحة ويب، ويتم تحديدهما من خلال رقم تعريف علامة التبويب ورقم تعريف الإطار.

المعلمات

  • التفاصيل

    عنصر

    معلومات حول الإطار الذي سيتم استرداد المعلومات عنه

    • documentId

      سلسلة اختيارية

      Chrome 106 والإصدارات الأحدث

      المعرّف الفريد العالمي (UUID) للمستند في حال توفير frameId و/أو tabId، سيتم التحقّق من صحتهما للتأكّد من تطابقهما مع المستند الذي تم العثور عليه باستخدام رقم تعريف المستند المقدَّم.

    • frameId

      number اختياري

      معرّف الإطار في علامة التبويب المحدّدة

    • processId

      number اختياري

      تم إيقافها نهائيًا منذ الإصدار 49 من Chrome

      يتم الآن تحديد الإطارات بشكل فريد من خلال رقم تعريف علامة التبويب ورقم تعريف الإطار، ولم يعُد رقم تعريف العملية مطلوبًا، وبالتالي يتم تجاهله.

      تمثّل هذه السمة رقم تعريف العملية التي تشغّل أداة العرض لعلامة التبويب هذه.

    • tabId

      number اختياري

      رقم تعريف علامة التبويب التي يظهر فيها الإطار

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (details?: object) => void

    • التفاصيل

      كائن اختياري

      معلومات عن الإطار المطلوب، أو قيمة فارغة إذا كان رقم تعريف الإطار و/أو رقم تعريف علامة التبويب المحدّدين غير صالحَين

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • errorOccurred

        قيمة منطقية

        صحيح إذا تمّت مقاطعة آخر عملية تنقّل في هذا الإطار بسبب حدوث خطأ، أي تمّ تنشيط الحدث onErrorOccurred.

      • frameType

        FrameType

        Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        تمثّل هذه السمة معرّف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • url

        سلسلة

        تمثّل هذه السمة عنوان URL المرتبط حاليًا بهذا الإطار، إذا كان الإطار الذي تم تحديده بواسطة frameId متوفّرًا في وقت ما في علامة التبويب المحدّدة. إنّ ارتباط عنوان URL بمعرّف frameId معيّن لا يعني أنّ الإطار المقابل لا يزال موجودًا.

المرتجعات

  • Promise<object | undefined>

    الإصدار 93 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

الفعاليات

onBeforeNavigate

chrome.webNavigation.onBeforeNavigate.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عندما يكون على وشك حدوث عملية تنقّل.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • frameId

        الرقم

        يشير الرقم 0 إلى أنّ التنقّل يحدث في نافذة محتوى علامة التبويب، وتشير القيمة الموجبة إلى التنقّل في إطار فرعي. تكون معرّفات الإطارات فريدة لعلامة تبويب وعملية معيّنتَين.

      • Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        تمثّل هذه السمة معرّف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        تم إيقافها نهائيًا منذ الإصدار 50 من Chrome

        لم يعُد يتم ضبط processId لهذا الحدث، لأنّ العملية التي ستعرض المستند الناتج لا تكون معروفة إلا عند تنفيذ onCommit.

        قيمة -1

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي سيحدث فيها التنقّل.

      • timeStamp

        الرقم

        الوقت الذي كان فيه المتصفّح على وشك بدء عملية التنقّل، بالملّي ثانية منذ بدء الحقبة

      • url

        سلسلة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onCommitted

chrome.webNavigation.onCommitted.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عند إتمام عملية تنقّل. قد يكون المستند (والموارد التي يشير إليها، مثل الصور والإطارات الفرعية) لا يزال قيد التنزيل، ولكن تم استلام جزء منه على الأقل من الخادم وقرّر المتصفّح التبديل إلى المستند الجديد.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • frameId

        الرقم

        يشير الرقم 0 إلى أنّ التنقّل يحدث في نافذة محتوى علامة التبويب، وتشير القيمة الموجبة إلى التنقّل في إطار فرعي. تكون معرّفات الإطارات فريدة داخل علامة تبويب.

      • Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        الإصدار 74 من Chrome أو إصدار أحدث

        تمثّل هذه السمة معرّف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        رقم تعريف العملية التي تشغّل أداة العرض لهذه اللقطة.

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي يتم فيها التنقّل

      • timeStamp

        الرقم

        الوقت الذي تم فيه إكمال عملية التنقّل، بالمللي ثانية منذ بدء حساب الفترة

      • transitionQualifiers

        TransitionQualifier[]

        قائمة بمؤهلات الانتقال.

      • transitionType

        TransitionType

        سبب التنقّل

      • url

        سلسلة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onCompleted

chrome.webNavigation.onCompleted.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عندما يتم تحميل مستند بالكامل، بما في ذلك الموارد التي يشير إليها، وتهيئته.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • frameId

        الرقم

        يشير الرقم 0 إلى أنّ التنقّل يحدث في نافذة محتوى علامة التبويب، وتشير القيمة الموجبة إلى التنقّل في إطار فرعي. تكون معرّفات الإطارات فريدة داخل علامة تبويب.

      • Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        الإصدار 74 من Chrome أو إصدار أحدث

        تمثّل هذه السمة معرّف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        رقم تعريف العملية التي تشغّل أداة العرض لهذه اللقطة.

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي يتم فيها التنقّل

      • timeStamp

        الرقم

        الوقت الذي انتهى فيه تحميل المستند، بالملّي ثانية منذ بدء الحقبة

      • url

        سلسلة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onCreatedNavigationTarget

chrome.webNavigation.onCreatedNavigationTarget.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عند إنشاء نافذة جديدة أو علامة تبويب جديدة في نافذة حالية لاستضافة عملية تنقّل.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • sourceFrameId

        الرقم

        رقم تعريف الإطار الذي يتضمّن sourceTabId والذي تم فيه تفعيل عملية التنقّل. يشير الرقم 0 إلى الإطار الرئيسي.

      • sourceProcessId

        الرقم

        رقم تعريف العملية التي تشغّل أداة العرض للإطار المصدر

      • sourceTabId

        الرقم

        رقم تعريف علامة التبويب التي يتم فيها تفعيل التنقّل.

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي تم فتح عنوان URL فيها

      • timeStamp

        الرقم

        الوقت الذي كان فيه المتصفّح على وشك إنشاء طريقة عرض جديدة، بالملّي ثانية منذ بدء الحقبة

      • url

        سلسلة

        عنوان URL الذي سيتم فتحه في النافذة الجديدة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onDOMContentLoaded

chrome.webNavigation.onDOMContentLoaded.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عند اكتمال إنشاء نموذج DOM للصفحة، ولكن قد لا تنتهي عملية تحميل الموارد المشار إليها.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • frameId

        الرقم

        يشير الرقم 0 إلى أنّ التنقّل يحدث في نافذة محتوى علامة التبويب، وتشير القيمة الموجبة إلى التنقّل في إطار فرعي. تكون معرّفات الإطارات فريدة داخل علامة تبويب.

      • Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        الإصدار 74 من Chrome أو إصدار أحدث

        تمثّل هذه السمة رقم تعريف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        رقم تعريف العملية التي تشغّل أداة العرض لهذه اللقطة.

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي يتم فيها التنقّل

      • timeStamp

        الرقم

        الوقت الذي تم فيه إنشاء نموذج DOM للصفحة بالكامل، بالمللي ثانية منذ بدء الحقبة

      • url

        سلسلة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onErrorOccurred

chrome.webNavigation.onErrorOccurred.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عند حدوث خطأ وإيقاف عملية التنقّل. يمكن أن يحدث ذلك في حال حدوث خطأ في الشبكة أو إذا أوقف المستخدم عملية التنقّل.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • خطأ

        سلسلة

        تمثّل هذه السمة وصف الخطأ.

      • frameId

        الرقم

        يشير الرقم 0 إلى أنّ التنقّل يحدث في نافذة محتوى علامة التبويب، وتشير القيمة الموجبة إلى التنقّل في إطار فرعي. تكون معرّفات الإطارات فريدة داخل علامة تبويب.

      • Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        الإصدار 74 من Chrome أو إصدار أحدث

        تمثّل هذه السمة رقم تعريف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        تم إيقافها نهائيًا منذ الإصدار 50 من Chrome

        لم يعُد يتم ضبط processId لهذا الحدث.

        قيمة -1

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي يتم فيها التنقّل

      • timeStamp

        الرقم

        الوقت الذي حدث فيه الخطأ، بالملّي ثانية منذ بدء الحقبة

      • url

        سلسلة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onHistoryStateUpdated

chrome.webNavigation.onHistoryStateUpdated.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عند تعديل سجلّ الإطار إلى عنوان URL جديد. ستستخدم جميع الأحداث المستقبلية لهذا الإطار عنوان URL المعدَّل.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • frameId

        الرقم

        يشير الرقم 0 إلى أنّ التنقّل يحدث في نافذة محتوى علامة التبويب، وتشير القيمة الموجبة إلى التنقّل في إطار فرعي. تكون معرّفات الإطارات فريدة داخل علامة تبويب.

      • Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        الإصدار 74 من Chrome أو إصدار أحدث

        تمثّل هذه السمة رقم تعريف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        رقم تعريف العملية التي تشغّل أداة العرض لهذه اللقطة.

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي يتم فيها التنقّل

      • timeStamp

        الرقم

        الوقت الذي تم فيه إكمال عملية التنقّل، بالمللي ثانية منذ بدء حساب الفترة

      • transitionQualifiers

        TransitionQualifier[]

        قائمة بمؤهلات الانتقال.

      • transitionType

        TransitionType

        سبب التنقّل

      • url

        سلسلة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onReferenceFragmentUpdated

chrome.webNavigation.onReferenceFragmentUpdated.addListener(
  callback: function,
  filters?: object,
)

يتم تنشيط هذا الحدث عند تعديل الجزء المرجعي من إطار. ستستخدم جميع الأحداث المستقبلية لهذا الإطار عنوان URL المعدَّل.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • documentId

        سلسلة

        Chrome 106 والإصدارات الأحدث

        تم تحميل المعرّف الفريد العالمي (UUID) للمستند.

      • Chrome 106 والإصدارات الأحدث

        دورة الحياة التي يكون فيها المستند

      • frameId

        الرقم

        يشير الرقم 0 إلى أنّ التنقّل يحدث في نافذة محتوى علامة التبويب، وتشير القيمة الموجبة إلى التنقّل في إطار فرعي. تكون معرّفات الإطارات فريدة داخل علامة تبويب.

      • Chrome 106 والإصدارات الأحدث

        نوع الإطار الذي حدث فيه التنقّل

      • parentDocumentId

        سلسلة اختيارية

        Chrome 106 والإصدارات الأحدث

        رقم تعريف عالمي فريد (UUID) للمستند الرئيسي الذي يملك هذا الإطار لا يتم ضبط هذه السمة إذا لم يكن هناك موقع رئيسي.

      • parentFrameId

        الرقم

        الإصدار 74 من Chrome أو إصدار أحدث

        تمثّل هذه السمة رقم تعريف الإطار الرئيسي، أو -1 إذا كان هذا هو الإطار الرئيسي.

      • processId

        الرقم

        رقم تعريف العملية التي تشغّل أداة العرض لهذه اللقطة.

      • tabId

        الرقم

        رقم تعريف علامة التبويب التي يتم فيها التنقّل

      • timeStamp

        الرقم

        الوقت الذي تم فيه إكمال عملية التنقّل، بالمللي ثانية منذ بدء حساب الفترة

      • transitionQualifiers

        TransitionQualifier[]

        قائمة بمؤهلات الانتقال.

      • transitionType

        TransitionType

        سبب التنقّل

      • url

        سلسلة

  • الفلاتر

    كائن اختياري

    • url

      ‫events.UrlFilter[]

      الشروط التي يجب أن يستوفيها عنوان URL الذي يتم الانتقال إليه. يتم تجاهل الحقلَين "المخططات" و"المنافذ" في UrlFilter لهذا الحدث.

onTabReplaced

chrome.webNavigation.onTabReplaced.addListener(
  callback: function,
)

يتم تنشيط هذا الحدث عندما يتم استبدال محتوى علامة التبويب بعلامة تبويب مختلفة (عادةً ما تكون قد تمّت معالجتها مسبقًا).

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (details: object) => void

    • التفاصيل

      عنصر

      • replacedTabId

        الرقم

        معرّف علامة التبويب التي تم استبدالها

      • tabId

        الرقم

        معرّف علامة التبويب التي حلّت محلّ علامة التبويب القديمة

      • timeStamp

        الرقم

        الوقت الذي تم فيه الاستبدال، بالملّي ثانية منذ بدء حساب الفترة