דף זה תורגם על ידי Cloud Translation API.

chrome.webNavigation

תיאור

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

הרשאות

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 Instant או Instant Pages, דף שנטען במלואו מוחלף בכרטיסייה הנוכחית. במקרה כזה, מופעל אירוע onTabReplaced.

הקשר לאירועים מסוג webRequest

אין סדר מוגדר בין האירועים של webRequest API לבין האירועים של webNavigation 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 יישלח למסגרת הראשית החדשה). במילים אחרות, יכול להיות יותר מרצף אחד של אירועי webNavigation בהמתנה עם אותו frameId. אפשר להבחין בין הרצפים באמצעות המקש processId.

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

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

סוגי מעברים ותנאים

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

אלה התנאים להגדרת מעבר:

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

דוגמאות

כדי לנסות את ה-API הזה, מתקינים את הדוגמה ל-webNavigation API ממאגר chrome-extension-samples.

סוגים

TransitionQualifier

‫Chrome 44 ואילך

Enum

‎"client_redirect"

‫"server_redirect"

‎"forward_back"

‫"from_address_bar"

TransitionType

‫Chrome 44 ואילך

הסיבה לניווט. נעשה שימוש באותם סוגי מעברים שמוגדרים ב-History API. אלה אותם סוגי מעברים שמוגדרים ב-History API, רק שבמקום "auto_toplevel" מופיע "start_page" (לצורך תאימות לדור קודם).

Enum

"link"

‫"typed"

‪"auto_bookmark"

"auto_subframe"

‫"manual_subframe"

‫"generated"

‎"start_page"

"form_submit"

‫"reload"

‫"keyword"

‎"keyword_generated"

Methods

getAllFrames()

chrome.webNavigation.getAllFrames(
  details: object,
): Promise<object[] | undefined>

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

פרמטרים

פרטים

אובייקט

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

החזרות

Promise<object[] | undefined>

‫Chrome 93 ואילך

getFrame()

chrome.webNavigation.getFrame(
  details: object,
): Promise<object | undefined>

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

פרמטרים

פרטים

אובייקט

מידע על המסגרת שרוצים לאחזר מידע לגביה.
- documentId
  
  מחרוזת אופציונלי
  
  ‫Chrome 106 ואילך
  
  המזהה הייחודי האוניברסלי (UUID) של המסמך. אם מסופקים frameId או tabId, המערכת תבדוק שהם תואמים למסמך שנמצא לפי מזהה המסמך שסופק.
- frameId
  
  מספר אופציונלי
  
  המזהה של המסגרת בכרטיסייה הנתונה.
- processId
  
  מספר אופציונלי
  
  הוצא משימוש מאז Chrome 49
  
  מסגרות מזוהות עכשיו באופן ייחודי לפי מזהה הכרטיסייה ומזהה המסגרת שלהן. מזהה התהליך כבר לא נדרש ולכן המערכת מתעלמת ממנו.
  המזהה של התהליך שמריץ את רכיב הרינדור בכרטיסייה הזו.
- tabId
  
  מספר אופציונלי
  
  המזהה של הכרטיסייה שבה נמצאת המסגרת.

החזרות

Promise<object | undefined>

‫Chrome 93 ואילך

אירועים

onBeforeNavigate

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

מופעל כשניווט עומד להתרחש.

פרמטרים

callback

פונקציה

הפרמטר callback נראה כך:
```
(details: object) => void
```
- פרטים
  
  אובייקט
  - documentLifecycle
    
    extensionTypes.DocumentLifecycle
    
    ‫Chrome 106 ואילך
    
    מחזור החיים של המסמך.
  - frameId
    
    number
    
    ‫0 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה, וערך חיובי מציין ניווט ב-iframe. מזהי המסגרות הם ייחודיים לכרטיסייה ולתהליך נתונים מסוימים.
  - 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 שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-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 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה, וערך חיובי מציין ניווט ב-iframe. מזהי המסגרות ייחודיים בתוך כרטיסייה.
  - frameType
    
    extensionTypes.FrameType
    
    ‫Chrome 106 ואילך
    
    סוג המסגרת שבה התרחש הניווט.
  - parentDocumentId
    
    מחרוזת אופציונלי
    
    ‫Chrome 106 ואילך
    
    מזהה UUID של מסמך ההורה שבבעלותו המסגרת הזו. אם אין נכס אב, הערך לא מוגדר.
  - parentFrameId
    
    number
    
    ‫Chrome 74 ואילך
    
    המזהה של מסגרת האב, או -1 אם זו המסגרת הראשית.
  - processId
    
    number
    
    המזהה של התהליך שמריץ את רכיב ה-Renderer של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצעת הניווט.
  - timeStamp
    
    number
    
    הזמן שבו הניווט בוצע, באלפיות השנייה מאז תחילת התקופה של זמן מערכת.
  - transitionQualifiers
    
    TransitionQualifier[]
    
    רשימה של תנאים למעבר.
  - transitionType
    
    TransitionType
    
    הסיבה לניווט.
  - כתובת אתר
    
    מחרוזת
מסננים

אובייקט אופציונלי
- כתובת אתר
  
  events.UrlFilter[]
  
  תנאים שכתובת ה-URL שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-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 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה, וערך חיובי מציין ניווט ב-iframe. מזהי המסגרות ייחודיים בתוך כרטיסייה.
  - frameType
    
    extensionTypes.FrameType
    
    ‫Chrome 106 ואילך
    
    סוג המסגרת שבה התרחש הניווט.
  - parentDocumentId
    
    מחרוזת אופציונלי
    
    ‫Chrome 106 ואילך
    
    מזהה UUID של מסמך ההורה שבבעלותו המסגרת הזו. אם אין נכס אב, הערך לא מוגדר.
  - parentFrameId
    
    number
    
    ‫Chrome 74 ואילך
    
    המזהה של מסגרת האב, או -1 אם זו המסגרת הראשית.
  - processId
    
    number
    
    המזהה של התהליך שמריץ את רכיב ה-Renderer של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצעת הניווט.
  - timeStamp
    
    number
    
    הזמן שבו טעינת המסמך הסתיימה, באלפיות השנייה מאז ראשית התקופה.
  - כתובת אתר
    
    מחרוזת
מסננים

אובייקט אופציונלי
- כתובת אתר
  
  events.UrlFilter[]
  
  תנאים שכתובת ה-URL שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-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 שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-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 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה, וערך חיובי מציין ניווט ב-iframe. מזהי המסגרות ייחודיים בתוך כרטיסייה.
  - frameType
    
    extensionTypes.FrameType
    
    ‫Chrome 106 ואילך
    
    סוג המסגרת שבה התרחש הניווט.
  - parentDocumentId
    
    מחרוזת אופציונלי
    
    ‫Chrome 106 ואילך
    
    מזהה UUID של מסמך ההורה שבבעלותו המסגרת הזו. אם אין נכס אב, הערך לא מוגדר.
  - parentFrameId
    
    number
    
    ‫Chrome 74 ואילך
    
    המזהה של מסגרת האב, או -1 אם זו המסגרת הראשית.
  - processId
    
    number
    
    המזהה של התהליך שמריץ את רכיב ה-Renderer של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצעת הניווט.
  - timeStamp
    
    number
    
    הזמן שבו ה-DOM של הדף נוצר במלואו, באלפיות השנייה מאז ראשית הזמן.
  - כתובת אתר
    
    מחרוזת
מסננים

אובייקט אופציונלי
- כתובת אתר
  
  events.UrlFilter[]
  
  תנאים שכתובת ה-URL שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-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 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה, וערך חיובי מציין ניווט ב-iframe. מזהי המסגרות ייחודיים בתוך כרטיסייה.
  - 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 שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-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 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה, וערך חיובי מציין ניווט ב-iframe. מזהי המסגרות ייחודיים בתוך כרטיסייה.
  - frameType
    
    extensionTypes.FrameType
    
    ‫Chrome 106 ואילך
    
    סוג המסגרת שבה התרחש הניווט.
  - parentDocumentId
    
    מחרוזת אופציונלי
    
    ‫Chrome 106 ואילך
    
    מזהה UUID של מסמך ההורה שבבעלותו המסגרת הזו. אם אין נכס אב, הערך לא מוגדר.
  - parentFrameId
    
    number
    
    ‫Chrome 74 ואילך
    
    המזהה של מסגרת האב, או -1 אם זו המסגרת הראשית.
  - processId
    
    number
    
    המזהה של התהליך שמריץ את רכיב ה-Renderer של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצעת הניווט.
  - timeStamp
    
    number
    
    הזמן שבו הניווט בוצע, באלפיות השנייה מאז תחילת התקופה של זמן מערכת.
  - transitionQualifiers
    
    TransitionQualifier[]
    
    רשימה של תנאים למעבר.
  - transitionType
    
    TransitionType
    
    הסיבה לניווט.
  - כתובת אתר
    
    מחרוזת
מסננים

אובייקט אופציונלי
- כתובת אתר
  
  events.UrlFilter[]
  
  תנאים שכתובת ה-URL שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-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 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה, וערך חיובי מציין ניווט ב-iframe. מזהי המסגרות ייחודיים בתוך כרטיסייה.
  - frameType
    
    extensionTypes.FrameType
    
    ‫Chrome 106 ואילך
    
    סוג המסגרת שבה התרחש הניווט.
  - parentDocumentId
    
    מחרוזת אופציונלי
    
    ‫Chrome 106 ואילך
    
    מזהה UUID של מסמך ההורה שבבעלותו המסגרת הזו. אם אין נכס אב, הערך לא מוגדר.
  - parentFrameId
    
    number
    
    ‫Chrome 74 ואילך
    
    המזהה של מסגרת האב, או -1 אם זו המסגרת הראשית.
  - processId
    
    number
    
    המזהה של התהליך שמריץ את רכיב ה-Renderer של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצעת הניווט.
  - timeStamp
    
    number
    
    הזמן שבו הניווט בוצע, באלפיות השנייה מאז תחילת התקופה של זמן מערכת.
  - transitionQualifiers
    
    TransitionQualifier[]
    
    רשימה של תנאים למעבר.
  - transitionType
    
    TransitionType
    
    הסיבה לניווט.
  - כתובת אתר
    
    מחרוזת
מסננים

אובייקט אופציונלי
- כתובת אתר
  
  events.UrlFilter[]
  
  תנאים שכתובת ה-URL שאליה עוברים צריכה לעמוד בהם. המערכת מתעלמת מהשדות schemes ו-ports של UrlFilter לגבי האירוע הזה.

onTabReplaced

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

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

פרמטרים

callback

פונקציה

הפרמטר callback נראה כך:
```
(details: object) => void
```
- פרטים
  
  אובייקט
  - replacedTabId
    
    number
    
    המזהה של הכרטיסייה שהוחלפה.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שהחליפה את הכרטיסייה הישנה.
  - timeStamp
    
    number
    
    הזמן שבו ההחלפה התרחשה, באלפיות השנייה מאז תחילת התקופה של זמן מערכת.

chrome.webNavigation קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

תיאור

הרשאות

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

סדר האירועים

הקשר לאירועים מסוג webRequest

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

חותמות זמן

מזהי פריים

סוגי מעברים ותנאים

דוגמאות

סוגים

TransitionQualifier

Enum

TransitionType

Enum

Methods

getAllFrames()

פרמטרים

החזרות

getFrame()

פרמטרים

החזרות

אירועים

onBeforeNavigate

פרמטרים

onCommitted

פרמטרים

onCompleted

פרמטרים

onCreatedNavigationTarget

פרמטרים

onDOMContentLoaded

פרמטרים

onErrorOccurred

פרמטרים

onHistoryStateUpdated

פרמטרים

onReferenceFragmentUpdated

פרמטרים

onTabReplaced

פרמטרים

chrome.webNavigation