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

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

chrome.webNavigation

refresh date: 2026-09-25 robots: noindex

תיאור

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

הקשר לאירועי webRequest

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

באופן כללי, אירועי webNavigation קשורים באופן הדוק למצב הניווט שמוצג בממשק המשתמש, ואירועי webRequest תואמים למצב של מקבץ הרשת (network stack), שבדרך כלל לא גלוי למשתמש.

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

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

חותמות זמן

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

מזהי מסגרות

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

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

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

עוד קונספט שבעייתי בתוספים הוא מחזור החיים של המסגרת. מסגרת מארחת מסמך (שמשויך לכתובת URL שהוקצתה). המסמך יכול להשתנות (למשל, על ידי ניווט) אבל ה-frameId לא ישתנה, ולכן קשה לשייך אירוע שקרה במסמך ספציפי רק באמצעות frameIds. אנחנו מציגים את הקונספט של 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 ואילך

טיפוסים בני מנייה (enum)

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

‫Chrome מגרסה 44 ואילך

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

טיפוסים בני מנייה (enum)

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"generated"

"start_page"

"form_submit"

"reload"

"מילת מפתח"

"keyword_generated"

Methods

getAllFrames()

Promise

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

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

פרמטרים

פרטים

אובייקט

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

function optional

הפרמטר 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 ואילך

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

function optional

הפרמטר callback נראה כך:
```
(details?: object) => void
```
- פרטים
  
  object optional
  
  מידע על המסגרת המבוקשת, או 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 ואילך

הבטחות נתמכות רק ב-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 מציין שהניווט מתבצע בחלון התוכן של הכרטיסייה. ערך חיובי מציין ניווט במסגרת משנה. מזהי מסגרות הם ייחודיים לכרטיסייה ולתהליך נתונים.
  - frameType
    
    extensionTypes.FrameType
    
    ‫Chrome מגרסה 106 ואילך
    
    סוג המסגרת שבה התרחש הניווט.
  - parentDocumentId
    
    מחרוזת אופציונלי
    
    ‫Chrome מגרסה 106 ואילך
    
    מזהה UUID של מסמך ההורה שהמסגרת הזו שייכת לו. השדה הזה לא מוגדר אם אין נכס ראשי.
  - parentFrameId
    
    number
    
    המזהה של מסגרת ההורה, או -1 אם זו המסגרת הראשית.
  - processId
    
    number
    
    הוצא משימוש בגרסה Chrome 50
    
    ה-processId לא מוגדר יותר לאירוע הזה, כי התהליך שיוביל לעיבוד המסמך שיתקבל לא ידוע עד ל-onCommit.
    הערך של ‎-1.
  - tabId
    
    number
    
    מזהה הכרטיסייה שבה הניווט עומד להתרחש.
  - timeStamp
    
    number
    
    הזמן שבו הדפדפן עמד להתחיל את הניווט, באלפיות השנייה מאז ראשית זמן יוניקס (Unix epoch).
  - url
    
    מחרוזת
מסננים

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

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
    
    הסיבה לניווט.
  - url
    
    מחרוזת
מסננים

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

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

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

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 שתיפתח בחלון החדש.
מסננים

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

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

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

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

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

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
    
    הסיבה לניווט.
  - url
    
    מחרוזת
מסננים

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

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
    
    הסיבה לניווט.
  - url
    
    מחרוזת
מסננים

object optional
- url
  
  events.UrlFilter[]
  
  התנאים שכתובת ה-URL שאליה מנווטים צריכה לעמוד בהם.

onTabReplaced

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

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

פרמטרים

callback

פונקציה

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

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

תיאור

הרשאות

מניפסט

סדר האירועים

הקשר לאירועי webRequest

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

חותמות זמן

מזהי מסגרות

סוגי הפניות וגורמים מסייגים

דוגמאות

סוגים

TransitionQualifier

טיפוסים בני מנייה (enum)

TransitionType

טיפוסים בני מנייה (enum)

Methods

getAllFrames()

פרמטרים

החזרות

getFrame()

פרמטרים

החזרות

אירועים

onBeforeNavigate

פרמטרים

onCommitted

פרמטרים

onCompleted

פרמטרים

onCreatedNavigationTarget

פרמטרים

onDOMContentLoaded

פרמטרים

onErrorOccurred

פרמטרים

onHistoryStateUpdated

פרמטרים

onReferenceFragmentUpdated

פרמטרים

onTabReplaced

פרמטרים

chrome.webNavigation