תוספי Manifest V2 הוסרו מחנות האינטרנט של Chrome ב-31 באוגוסט 2026. כדי שהתוסף יהיה זמין שוב למשתמשים, צריך להעביר אותו ל-Manifest V3.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

chrome.webNavigation

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

אפשר להשתמש ב-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 יהיה עקבי רק באופן פנימי. השוואה בין אירוע אחד לאירוע אחר תיתן לכם את ההפרש הנכון ביניהם, אבל השוואה שלהם לזמן הנוכחי בתוך התוסף (באמצעות (new Date()).getTime(), למשל) עשויה לתת תוצאות לא צפויות.

מזהי מסגרות

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

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

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

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

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

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

אלה המאפיינים של המעברים:

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

דוגמאות

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

סוגים

TransitionQualifier

‫Chrome 44 ואילך

ספירה

‎"client_redirect"

‫"server_redirect"

‫"forward_back"

‎"from_address_bar"

TransitionType

‫Chrome 44 ואילך

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

ספירה

‫"link"

'הקלדה'

‫auto_bookmark

‫"auto_subframe"

‎"manual_subframe"

"נוצר"

‫'start_page'

‫"form_submit"

"reload"

'מילת מפתח'

‫‎"keyword_generated"

Methods

getAllFrames()

Promise

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

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

פרמטרים

פרטים

אובייקט

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

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

הפרמטר callback נראה כך:
```
(details?: object[]) => void
```
- פרטים
  
  object[] אופציונלי
  
  רשימה של מסגרות בכרטיסייה הנתונה, 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
    
    מחרוזת
    
    כתובת ה-URL שמשויכת כרגע למסגרת הזו.

החזרות

Promise<object[] | undefined>

‫Chrome 93 ואילך

התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getFrame()

Promise

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

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

פרמטרים

פרטים

אובייקט

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

החזרות

Promise<object | undefined>

‫Chrome 93 ואילך

התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

אירועים

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

אובייקט אופציונלי
- url
  
  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
    
    המזהה של התהליך שמריץ את רכיב הרינדור של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצע הניווט.
  - timeStamp
    
    number
    
    הזמן שבו הניווט בוצע, באלפיות שנייה מאז ראשית הזמן.
  - transitionQualifiers
    
    TransitionQualifier[]
    
    רשימה של תנאים למעבר.
  - transitionType
    
    TransitionType
    
    הסיבה לניווט.
  - url
    
    מחרוזת
מסננים

אובייקט אופציונלי
- url
  
  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
    
    המזהה של התהליך שמריץ את רכיב הרינדור של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצע הניווט.
  - timeStamp
    
    number
    
    הזמן שבו טעינת המסמך הסתיימה, באלפיות שנייה מאז ראשית הזמן.
  - url
    
    מחרוזת
מסננים

אובייקט אופציונלי
- url
  
  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
    
    המזהה של התהליך שמריץ את רכיב ה-renderer של מסגרת המקור.
  - sourceTabId
    
    number
    
    המזהה של הכרטיסייה שבה מופעל הניווט.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה כתובת ה-URL נפתחת
  - timeStamp
    
    number
    
    הזמן שבו הדפדפן עמד ליצור תצוגה חדשה, באלפיות שנייה מאז ראשית הזמן.
  - url
    
    מחרוזת
    
    כתובת ה-URL שתיפתח בחלון החדש.
מסננים

אובייקט אופציונלי
- 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
    
    המזהה של התהליך שמריץ את רכיב הרינדור של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצע הניווט.
  - timeStamp
    
    number
    
    הזמן שבו ה-DOM של הדף נוצר במלואו, באלפיות השנייה מאז ראשית הזמן.
  - url
    
    מחרוזת
מסננים

אובייקט אופציונלי
- url
  
  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
    
    הזמן שבו השגיאה התרחשה, באלפיות השנייה מאז ראשית הזמן.
  - url
    
    מחרוזת
מסננים

אובייקט אופציונלי
- url
  
  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
    
    המזהה של התהליך שמריץ את רכיב הרינדור של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצע הניווט.
  - timeStamp
    
    number
    
    הזמן שבו הניווט בוצע, באלפיות שנייה מאז ראשית הזמן.
  - transitionQualifiers
    
    TransitionQualifier[]
    
    רשימה של תנאים למעבר.
  - transitionType
    
    TransitionType
    
    הסיבה לניווט.
  - url
    
    מחרוזת
מסננים

אובייקט אופציונלי
- url
  
  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
    
    המזהה של התהליך שמריץ את רכיב הרינדור של המסגרת הזו.
  - tabId
    
    number
    
    המזהה של הכרטיסייה שבה מתבצע הניווט.
  - timeStamp
    
    number
    
    הזמן שבו הניווט בוצע, באלפיות שנייה מאז ראשית הזמן.
  - transitionQualifiers
    
    TransitionQualifier[]
    
    רשימה של תנאים למעבר.
  - transitionType
    
    TransitionType
    
    הסיבה לניווט.
  - url
    
    מחרוזת
מסננים

אובייקט אופציונלי
- url
  
  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

ספירה

TransitionType

ספירה

Methods

getAllFrames()

פרמטרים

החזרות

getFrame()

פרמטרים

החזרות

אירועים

onBeforeNavigate

פרמטרים

onCommitted

פרמטרים

onCompleted

פרמטרים

onCreatedNavigationTarget

פרמטרים

onDOMContentLoaded

פרמטרים

onErrorOccurred

פרמטרים

onHistoryStateUpdated

פרמטרים

onReferenceFragmentUpdated

פרמטרים

onTabReplaced

פרמטרים

chrome.webNavigation