chrome.processes

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

תיאור

משתמשים ב-chrome.processes API כדי ליצור אינטראקציה עם התהליכים של הדפדפן.

הרשאות

processes

זמינות

Dev channel

סוגים

Cache

מאפיינים

  • liveSize

    number

    החלק במטמון שנמצא בשימוש, בבייטים.

  • size

    number

    גודל המטמון בבייטים.

Process

מאפיינים

  • cpu, מעבד, CPU, סי פי יו

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

    המדידה האחרונה של השימוש במעבד בתהליך, שמוצגת כאחוז מליבת מעבד אחת שנעשה בה שימוש כולל, על ידי כל השרשורים של התהליך. הערך שמתקבל הוא בין אפס ל-CpuInfo.numOfProcessors*100, ויכול להיות שהוא יעלה על 100% בתהליכים מרובי-הליכי משנה. המאפיין הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdated או מ-onUpdatedWithMemory.

  • cssCache

    ‫Cache אופציונלי

    המידע העדכני ביותר על מטמון ה-CSS לתהליך. המאפיין הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdated או מ-onUpdatedWithMemory.

  • id [מזהה]

    number

    מזהה ייחודי של התהליך שסופק על ידי הדפדפן.

  • imageCache

    ‫Cache אופציונלי

    המידע העדכני ביותר על מטמון התמונות של התהליך. המאפיין הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdated או מ-onUpdatedWithMemory.

  • jsMemoryAllocated

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

    המדידה האחרונה של הזיכרון שהוקצה ל-JavaScript בתהליך, בבייטים. המאפיין הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdated או מ-onUpdatedWithMemory.

  • jsMemoryUsed

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

    הערך העדכני ביותר של זיכרון ה-JavaScript שבו נעשה שימוש בתהליך, בבייטים. המאפיין הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdated או מ-onUpdatedWithMemory.

  • naclDebugPort

    number

    יציאת הניפוי באגים לתהליכי Native Client. אפס לסוגים אחרים של תהליכים ולתהליכי NaCl שלא מופעל בהם ניפוי באגים.

  • רשת

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

    המדידה האחרונה של השימוש ברשת של התהליך, בבייטים לשנייה. המאפיין הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdated או מ-onUpdatedWithMemory.

  • osProcessId

    number

    מזהה התהליך, כפי שסופק על ידי מערכת ההפעלה.

  • privateMemory

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

    המדידה האחרונה של השימוש בזיכרון הפרטי של התהליך, בבייטים. האירוע הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdatedWithMemory או מ-getProcessInfo עם הדגל includeMemory.

  • פרופיל

    מחרוזת

    הפרופיל שהתהליך משויך אליו.

  • scriptCache

    ‫Cache אופציונלי

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

  • sqliteMemory

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

    המדידה האחרונה של השימוש בזיכרון של SQLite בתהליך, בבייטים. המאפיין הזה זמין רק כשמקבלים את האובייקט כחלק מקריאה חוזרת מ-onUpdated או מ-onUpdatedWithMemory.

  • משימות

    TaskInfo[]

    מערך של TaskInfo שמייצג את המשימות שפועלות בתהליך הזה.

  • סוג

    ProcessType

    סוג התהליך.

ProcessType

סוגי תהליכי הדפדפן.

ספירה

‫'browser'

‫"renderer"

'תוסף'

‫'notification'

‫'plugin'

‫worker
הוצא משימוש, לא יוחזר לעולם.

‫"nacl"

‫"service_worker"
הוצא משימוש, לא יוחזר לעולם.

‫'utility'

‪"gpu"

'אחר'

TaskInfo

מאפיינים

  • tabId

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

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

  • title

    מחרוזת

    השם של המשימה.

Methods

getProcessIdForTab()

Promise 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
): Promise<number>

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

פרמטרים

  • tabId

    number

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

  • callback

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

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

    (processId: number) => void

    • processId

      number

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

החזרות

  • Promise<number>

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

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

getProcessInfo()

Promise 
chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
  callback?: function,
): Promise<object>

אחזור מידע על התהליך לכל מזהה תהליך שצוין.

פרמטרים

  • processIds

    number | number[]

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

  • includeMemory

    בוליאני

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

  • callback

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

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

    (processes: object) => void

    • תהליכים

      אובייקט

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

החזרות

  • Promise<object>

    פונקציית קריאה חוזרת שמופעלת כשמידע התהליך נאסף.

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

terminate()

Promise 
chrome.processes.terminate(
  processId: number,
  callback?: function,
): Promise<boolean>

הפסקת תהליך העיבוד שצוין. מקביל לביקור בכתובת about:crash, אבל בלי לשנות את כתובת ה-URL של הכרטיסייה.

פרמטרים

  • processId

    number

    המזהה של התהליך שרוצים להפסיק.

  • callback

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

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

    (didTerminate: boolean) => void

    • didTerminate

      בוליאני

      ‫True אם סיום התהליך הצליח, ו-False בכל מקרה אחר.

החזרות

  • Promise<boolean>

    קריאה חוזרת (callback) לדיווח על סטטוס סגירת החשבון.

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

אירועים

onCreated

chrome.processes.onCreated.addListener(
  callback: function,
)

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

פרמטרים

  • callback

    פונקציה

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

    (process: Process) => void

    • תהליך דיפוזיה הפוך

      Process

onExited

chrome.processes.onExited.addListener(
  callback: function,
)

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

פרמטרים

  • callback

    פונקציה

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

    (processId: number, exitType: number, exitCode: number) => void

    • processId

      number

    • exitType

      number

    • exitCode

      number

onUnresponsive

chrome.processes.onUnresponsive.addListener(
  callback: function,
)

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

פרמטרים

  • callback

    פונקציה

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

    (process: Process) => void

    • תהליך דיפוזיה הפוך

      Process

onUpdated

chrome.processes.onUpdated.addListener(
  callback: function,
)

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

פרמטרים

  • callback

    פונקציה

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

    (processes: object) => void

    • תהליכים

      אובייקט

onUpdatedWithMemory

chrome.processes.onUpdatedWithMemory.addListener(
  callback: function,
)

האירוע מופעל בכל פעם שמנהל המשימות מעדכן את נתוני התהליך שלו, ומספק את המילון של אובייקטי התהליך המעודכנים, שממוינים לפי מזהה התהליך. זהה ל-onUpdate, אבל כולל גם פרטים על השימוש בזיכרון בכל אובייקט Process. הערה: איסוף מידע על השימוש בזיכרון גורם לשימוש נוסף במעבד, ולכן כדאי להשתמש בו רק כשצריך.

פרמטרים

  • callback

    פונקציה

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

    (processes: object) => void

    • תהליכים

      אובייקט