chrome.webNavigation

תיאור

אפשר להשתמש ב-API chrome.webNavigation כדי לקבל התראות על הסטטוס של בקשות ניווט בזמן אמת.

הרשאות

webNavigation

כל השיטות והאירועים של chrome.webNavigation מחייבים להצהיר על ההרשאה "webNavigation" במניפסט התוסף. לדוגמה:

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

מושגים ושימוש

סדר האירוע

במקרה של ניווט שהסתיים בהצלחה, האירועים מופעלים לפי הסדר הבא:

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

כל שגיאה שמתרחשת במהלך התהליך מובילה לאירוע onErrorOccurred. במקרה של ניווט, לא הופעלו אירועים נוספים אחרי onErrorOccurred.

אם מסגרת ניווט מכילה תת-מסגרות, onCommitted שלה מופעלת לפני כל onBeforeNavigate; ואילו onCompleted מופעלים אחרי כל ה-onCompleted של הילדים.

אם מקטע ההפניה של מסגרת משתנה, מופעל אירוע onReferenceFragmentUpdated. הזה האירוע יכול להתחיל בכל שלב אחרי onDOMContentLoaded, גם אחרי onCompleted.

אם ה-API של ההיסטוריה משמש לשינוי המצב של מסגרת (למשל, באמצעות history.pushState(), האירוע onHistoryStateUpdated הופעל. האירוע הזה יכול לפעול בכל שלב אחרי onDOMContentLoaded.

אם ניווט שחזר דף מהמטמון לדף הקודם/הבא, האירוע onDOMContentLoaded לא יופעל. האירוע לא מופעל כי הטעינה של התוכן כבר הסתיימה כשהדף. ביקור ראשון.

אם הופעל ניווט באמצעות Chrome ללא התקנה או דפי ללא התקנה, הקובץ נטען במלואו הדף יוחלף בכרטיסייה הנוכחית. במקרה כזה, אירוע onTabReplaced מופעל.

קשר לאירועים ב-webRequest

אין סדר מוגדר בין האירועים ב-webRequest API לבין האירועים ממשק API לניווט באינטרנט. יכול להיות שאירועי webRequest עדיין מתקבלים עבור פריימים שכבר התחיל ניווט חדש, או שהניווט ממשיך רק אחרי שמשאבי הרשת כבר מלאה.

באופן כללי, אירועי WebNavigation קשורים במידה רבה למצב הניווט שמוצג בממשק המשתמש, ואילו אירועי webRequest תואמים למצב של סטאק הרשת בדרך כלל אטומים למשתמשים.

מזהי הכרטיסיות

לא כל כרטיסיות הניווט מתאימות לכרטיסיות עצמן בממשק המשתמש של Chrome. למשל, כרטיסייה שמתרחשת עובדה מראש. לא ניתן לגשת לכרטיסיות כאלה באמצעות tabs API ולא ניתן לבקש מידע עליהם להתקשר אל webNavigation.getFrame() או webNavigation.getAllFrames(). ברגע שכרטיסייה כזו מוחלף, מופעל אירוע onTabReplaced ו ניתן לגשת אליו דרך ממשקי ה-API האלה.

חותמות זמן

חשוב לציין שקיימות כמה בעיות טכניות בטיפול של מערכת ההפעלה ב-Chrome ייחודי תהליכים יכולים לגרום להטיית השעון בין הדפדפן עצמו לתהליכי תוספים. ש המשמעות היא שהנכס timeStamp של נכס WebNavigation האירוע timeStamp מובטח רק להיות עקביים באופן פנימי. השוואת אירוע אחד לאירוע אחר תאפשר לך לקבל את הקיזוז הנכון ביניהם, אבל השוואתם לזמן הנוכחי בסיומת (באמצעות (new Date()).getTime(), למשל) עלול לתת תוצאות בלתי צפויות.

מזהי פריימים

אפשר לזהות מסגרות בתוך כרטיסייה לפי מזהה מסגרת. מזהה המסגרת של הפריים הראשי הוא תמיד 0. המזהה של מסגרות הצאצא הוא מספר חיובי. אחרי בניית המסמך במסגרת, מזהה המסגרת שלו לא משתנה במהלך כל משך החיים של המסמך. החל מ-Chrome 49, המזהה הזה קבוע גם עבור משך החיים של המסגרת (במספר ניווטים).

Chrome הוא ריבוי תהליכים, לכן כרטיסייה עשויה להשתמש בתהליכים שונים כדי לעבד את המקור והיעד של דף אינטרנט. לכן, אם הניווט מתבצע בתהליך חדש, ייתכן לקבל אירועים גם מהדף החדש וגם מהדף הישן עד לביצוע הניווט החדש (כלומר אירוע onCommitted נשלח לפריים הראשי החדש). במילים אחרות, ייתכן שיהיו יש רצף אחד בהמתנה של אירועי ניווט באינטרנט עם אותו frameId. הרצפים יכולים להיות מזוהה באמצעות המפתח processId.

כמו כן, חשוב לזכור שבמהלך טעינה זמנית, התהליך עשוי להשתנות מספר פעמים. זה קורה כשהטעינה מופנית לאתר אחר. במקרה כזה, תקבלו onBeforeNavigate ו-onErrorOccurred אירועים, עד שתקבלו את אירוע onCommitted הסופי.

מושג נוסף שבעייתי בשימוש בתוספים הוא מחזור החיים של מסגרת. מסגרת מארחת מסמך (שמשויך לכתובת URL שהתחייבת אליה). המסמך יכול להשתנות (למשל באמצעות ניווט), אבל ה-frameId לא ישתנה, ולכן קשה לשייך שמשהו קרה במסמך מסוים עם רק frameIds. אנחנו משיקים קונספט של documentId שהוא מזהה ייחודי של כל מסמך. אם מנווטים במסגרת ופותחים מסמך חדש שהמזהה ישתנה. השדה הזה שימושי לקביעת כשדפים משנים את המצב של מחזור החיים שלהם (בין עיבוד מראש/פעיל/שמור במטמון) כי הוא נשאר ללא שינוי.

סוגי מעבר ופרמטרים ספציפיים

האירוע webNavigation onCommitted כולל transitionType ו-transitionQualifiers לנכס. סוג המעבר זהה לשימוש ב-history API ומתאר כיצד הדפדפן עבר לכתובת ה-URL המסוימת הזאת. בנוסף, ניתן לציין כמה מאפייני מעבר מוחזרות שמגדירות את הניווט בצורה מפורטת יותר.

ערכי המעבר הבאים קיימים:

תוחם מעבר	תיאור
"client_redirect"	הפניה אחת או יותר שנגרמות על ידי תגי JavaScript או מטא-רענון בדף, התרחשה במהלך הניווט.
'server_redirect'	הפניה אחת או יותר שנבעו מכותרות HTTP שנשלחו מהשרת אירעה במהלך הניווט.
'קדימה_back'	המשתמש השתמש בלחצן 'קדימה' או 'הקודם' כדי להתחיל את הניווט.
"from_address_bar"	המשתמש הפעיל את הניווט מסרגל הכתובות (שנקרא גם סרגל הכתובות).

דוגמאות

כדי לנסות את ה-API הזה, צריך להתקין את הדוגמה של WebNavigation API מ-chrome-extension-samples. של מאגר הנתונים.

סוגים

TransitionQualifier

Chrome 44 ואילך

Enum

"client_redirect"

"server_redirect"

"קדימה_back"

"from_address_bar"

TransitionType

Chrome 44 ואילך

הסיבה לניווט. המערכת משתמשת באותם סוגי המעברים שמוגדרים ב-API של ההיסטוריה. סוגי המעברים האלה זהים לאלה שמוגדרים ב-history API, מלבד "start_page" במקום "auto_toplevel" (לתאימות לאחור).

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

" manual_subframe"

"נוצר"

"start_page"

"form_submit"

"טעינה מחדש"

"מילת מפתח"

"keyword_generated"

שיטות

getAllFrames()

הבטחה

chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
)

אחזור מידע על כל המסגרות של כרטיסייה נתונה.

פרמטרים

• פרטים

  אובייקט

  מידע על הכרטיסייה שממנה מאחזרים את כל הפריימים.

  • tabId

    number

    המזהה של הכרטיסייה.

• קריאה חוזרת (callback)

  פונקציה אופציונלית

  הפרמטר callback נראה כך:

  (details?: object[]) => void

  • פרטים

    אובייקט[] אופציונלי

    רשימה של המסגרות בכרטיסייה הנתונה, הערך null אם מזהה הכרטיסייה שצוין אינו חוקי.

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • errorOccurred

      בוליאני

      הערך הוא True אם הניווט האחרון במסגרת הזו נקטע על ידי שגיאה, כלומר האירוע onErrorOccurred הופעל.

    • frameId

      number

      מזהה המסגרת. 0 מציין שזו המסגרת הראשית. ערך חיובי מציין את המזהה של תת-מסגרת.

    • frameType

      FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      מזהה התהליך שמפעיל את הרינדור של הפריים הזה.

    • כתובת אתר

      מחרוזת

      כתובת ה-URL שמשויכת כרגע למסגרת הזו.

החזרות

• Promise<object[] | לא מוגדר>

  Chrome מגרסה 93 ואילך

  הבטחות נתמכות במניפסט מגרסה V3 ואילך, אבל ניתנות קריאות חוזרות (callback) בשביל תאימות לאחור. לא ניתן להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה הזו מצליחה לפתור את הבעיה באותו סוג שמועבר לקריאה החוזרת.

getFrame()

הבטחה

chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
)

מאחזר מידע על המסגרת הנתונה. מסגרת מתייחסת לרכיב <iframe> או <frame> של דף אינטרנט, ומזוהה באמצעות מזהה כרטיסייה ומזהה מסגרת.

פרמטרים

• פרטים

  אובייקט

  מידע על המסגרת שצריך לאחזר עליה מידע.

  • documentId

    מחרוזת אופציונלי

    Chrome 106+

    המזהה הייחודי של המסמך (UUID) של המסמך. אם תספקו את frameId ו/או TabId, הם יאומתו כך שיתאימו למסמך שנמצא במזהה המסמך שסופק.

  • frameId

    מספר אופציונלי

    המזהה של המסגרת בכרטיסייה הנתונה.

  • processId

    מספר אופציונלי

    הוצא משימוש מאז Chrome 49

    עכשיו המסגרות מזוהות באופן ייחודי לפי מזהה הכרטיסייה ומזהה המסגרת שלהן. מזהה התהליך כבר לא נחוץ והמערכת מתעלמת ממנו.

    מזהה התהליך שמפעיל את כלי הרינדור בכרטיסייה הזו.

  • tabId

    מספר אופציונלי

    מזהה הכרטיסייה שבה מוצגת המסגרת.

• קריאה חוזרת (callback)

  פונקציה אופציונלית

  הפרמטר callback נראה כך:

  (details?: object) => void

  • פרטים

    אובייקט אופציונלי

    מידע על המסגרת המבוקשת, null אם מזהה המסגרת ו/או מזהה הכרטיסייה שצוינו לא תקינים.

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • errorOccurred

      בוליאני

      הערך הוא True אם הניווט האחרון במסגרת הזו נקטע על ידי שגיאה, כלומר האירוע onErrorOccurred הופעל.

    • frameType

      FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • כתובת אתר

      מחרוזת

      כתובת ה-URL שמשויכת כרגע למסגרת הזו, אם המסגרת שמזוהה על ידי frameId הייתה קיימת בנקודה מסוימת בכרטיסייה הנתונה. העובדה שכתובת URL משויכת ל-frameId נתון לא מרמזת על כך שהמסגרת המתאימה עדיין קיימת.

החזרות

• Promise&lt;object | לא מוגדר>

  Chrome מגרסה 93 ואילך

  הבטחות נתמכות במניפסט מגרסה V3 ואילך, אבל ניתנות קריאות חוזרות (callback) בשביל תאימות לאחור. לא ניתן להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה הזו מצליחה לפתור את הבעיה באותו סוג שמועבר לקריאה החוזרת.

אירועים

onBeforeNavigate

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

מופעל כשמתבצע ניווט.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • frameId

      number

      0 מציין שהניווט מתרחש בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי פריימים הם ייחודיים לכרטיסייה ולתהליך נתונים.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      הוצא משימוש מאז Chrome 50

      ה-ProcessId כבר לא מוגדר לאירוע הזה, כי התהליך שיעבד את המסמך שייווצר לא ידוע עד onCommit.

      הערך של 1-.

    • tabId

      number

      המזהה של הכרטיסייה שבה הניווט עומד להתרחש.

    • timeStamp

      number

      השעה שבה הדפדפן עמד להתחיל את הניווט, באלפיות שנייה מאז נקודת ההתחלה.

    • כתובת אתר

      מחרוזת

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onCommitted

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

מופעל כשהניווט מתבצע. ייתכן שעדיין מתבצעת הורדה של המסמך (והמשאבים שאליהם הוא מתייחס, כמו תמונות ומסגרות משנה), אבל לפחות חלק מהמסמך התקבל מהשרת והדפדפן החליט לעבור למסמך החדש.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • frameId

      number

      0 מציין שהניווט מתרחש בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי פריימים הם ייחודיים בכרטיסייה.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      Chrome מגרסה 74 ואילך

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      מזהה התהליך שמפעיל את הרינדור של הפריים הזה.

    • tabId

      number

      המזהה של הכרטיסייה שבה מתבצע הניווט.

    • timeStamp

      number

      הזמן שבו הניווט בוצע, באלפיות השנייה מאז תחילת התקופה.

    • transitionQualifiers

      TransitionQualifier[]

      רשימה של הגדרות מעבר.

    • transitionType

      TransitionType

      הסיבה לניווט.

    • כתובת אתר

      מחרוזת

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onCompleted

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

מופעל כשמסמך, כולל המשאבים שאליהם הוא מתייחס, נטען ומאתחל במלואו.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • frameId

      number

      0 מציין שהניווט מתרחש בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי פריימים הם ייחודיים בכרטיסייה.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      Chrome מגרסה 74 ואילך

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      מזהה התהליך שמפעיל את הרינדור של הפריים הזה.

    • tabId

      number

      המזהה של הכרטיסייה שבה מתבצע הניווט.

    • timeStamp

      number

      הזמן שבו המסמך סיימה לטעון, באלפיות השנייה מאז תחילת התקופה.

    • כתובת אתר

      מחרוזת

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onCreatedNavigationTarget

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

מופעל כשחלון חדש או כרטיסייה חדשה בחלון קיים נוצרים כדי לארח ניווט.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • sourceFrameId

      number

      מזהה המסגרת עם sourceTabId שבו הופעל הניווט. הספרה 0 מציין את המסגרת הראשית.

    • sourceProcessId

      number

      מזהה התהליך שמפעיל את כלי הרינדור של פריים המקור.

    • sourceTabId

      number

      המזהה של הכרטיסייה שבה הניווט מופעל.

    • tabId

      number

      המזהה של הכרטיסייה שבה כתובת ה-URL נפתחה

    • timeStamp

      number

      השעה שבה הדפדפן עמד ליצור תצוגה חדשה, באלפיות שנייה מתחילת התקופה.

    • כתובת אתר

      מחרוזת

      כתובת ה-URL לפתיחה בחלון החדש.

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onDOMContentLoaded

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

מופעל כשה-DOM של הדף מובנה במלואו, אבל ייתכן שהמשאבים שאליהם מתבצעת ההפניה לא מסיימים את הטעינה.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • frameId

      number

      0 מציין שהניווט מתרחש בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי פריימים הם ייחודיים בכרטיסייה.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      Chrome מגרסה 74 ואילך

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      מזהה התהליך שמפעיל את הרינדור של הפריים הזה.

    • tabId

      number

      המזהה של הכרטיסייה שבה מתבצע הניווט.

    • timeStamp

      number

      הזמן שבו ה-DOM של הדף נבנה באופן מלא, באלפיות שנייה מאז תחילת התקופה.

    • כתובת אתר

      מחרוזת

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onErrorOccurred

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

מופעל כשמתרחשת שגיאה והניווט מתבטל. מצב כזה יכול לקרות אם אירעה שגיאה בחיבור לרשת או אם המשתמש ביטל את הניווט.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • error

      מחרוזת

      תיאור השגיאה.

    • frameId

      number

      0 מציין שהניווט מתרחש בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי פריימים הם ייחודיים בכרטיסייה.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      Chrome מגרסה 74 ואילך

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      הוצא משימוש מאז Chrome 50

      ה-ProcessId כבר לא מוגדר לאירוע הזה.

      הערך של 1-.

    • tabId

      number

      המזהה של הכרטיסייה שבה מתבצע הניווט.

    • timeStamp

      number

      הזמן שבו אירעה השגיאה, באלפיות השנייה מאז תחילת התקופה.

    • כתובת אתר

      מחרוזת

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onHistoryStateUpdated

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

מופעל כשההיסטוריה של הפריים עודכנה לכתובת URL חדשה. כל האירועים העתידיים במסגרת הזו יתבססו על כתובת ה-URL המעודכנת.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • frameId

      number

      0 מציין שהניווט מתרחש בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי פריימים הם ייחודיים בכרטיסייה.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      Chrome מגרסה 74 ואילך

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      מזהה התהליך שמפעיל את הרינדור של הפריים הזה.

    • tabId

      number

      המזהה של הכרטיסייה שבה מתבצע הניווט.

    • timeStamp

      number

      הזמן שבו הניווט בוצע, באלפיות השנייה מאז תחילת התקופה.

    • transitionQualifiers

      TransitionQualifier[]

      רשימה של הגדרות מעבר.

    • transitionType

      TransitionType

      הסיבה לניווט.

    • כתובת אתר

      מחרוזת

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onReferenceFragmentUpdated

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

מופעל כשמקטע ההפניה של מסגרת עודכן. כל האירועים העתידיים במסגרת הזו יתבססו על כתובת ה-URL המעודכנת.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • documentId

      מחרוזת

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של המסמך שנטען.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      מחזור החיים של המסמך.

    • frameId

      number

      0 מציין שהניווט מתרחש בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי פריימים הם ייחודיים בכרטיסייה.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      סוג המסגרת שבה התרחש הניווט.

    • parentDocumentId

      מחרוזת אופציונלי

      Chrome 106+

      מזהה ייחודי אוניברסלי (UUID) של מסמך ההורה שהוא הבעלים של המסגרת הזו. הערך לא מוגדר אם אין הורה.

    • parentFrameId

      number

      Chrome מגרסה 74 ואילך

      המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.

    • processId

      number

      מזהה התהליך שמפעיל את הרינדור של הפריים הזה.

    • tabId

      number

      המזהה של הכרטיסייה שבה מתבצע הניווט.

    • timeStamp

      number

      הזמן שבו הניווט בוצע, באלפיות השנייה מאז תחילת התקופה.

    • transitionQualifiers

      TransitionQualifier[]

      רשימה של הגדרות מעבר.

    • transitionType

      TransitionType

      הסיבה לניווט.

    • כתובת אתר

      מחרוזת

• מסננים

  אובייקט אופציונלי

  • כתובת אתר

    events.UrlFilter[]

    התנאים שכתובת ה-URL שמנווטים אליהם חייבת לעמוד. 'סכמות' ו-ports המערכת מתעלמת משדות של UrlFilter עבור האירוע הזה.

onTabReplaced

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

מופעל כשתוכן הכרטיסייה מוחלף בכרטיסייה אחרת (בדרך כלל שעובדה מראש)

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (details: object) => void

  • פרטים

    אובייקט

    • replacedTabId

      number

      מזהה הכרטיסייה שהוחלפה.

    • tabId

      number

      המזהה של הכרטיסייה שהחליפה את הכרטיסייה הישנה.

    • timeStamp

      number

      הזמן שבו התרחשה ההחלפה, באלפיות שנייה מאז epoch.