chrome.processes

תיאור

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

הרשאות

processes

זמינות

ערוץ פיתוח

סוגים

Cache

מאפיינים

  • liveSize

    number

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

  • size

    number

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

Process

מאפיינים

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

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

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

  • cssCache

    מטמון אופציונלי

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

  • id [מזהה]

    number

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

  • imageCache

    מטמון אופציונלי

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

  • jsMemoryAllocated

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

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

  • jsMemoryUsed

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

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

  • naclDebugPort

    number

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

  • רשת

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

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

  • osProcessId

    number

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

  • privateMemory

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

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

  • פרופיל

    מחרוזת

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

  • scriptCache

    מטמון אופציונלי

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

  • sqliteMemory

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

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

  • משימות

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

  • סוג

    סוג התהליך.

ProcessType

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

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

"browser"

"renderer"

"extension"

"notification"

"plugin"

"worker"

"nacl"

"service_worker"
לא בשימוש, אף פעם לא יוחזר.

"utility"

"gpu"

"other"

TaskInfo

מאפיינים

  • tabId

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

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

  • title

    מחרוזת

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

Methods

getProcessIdForTab()

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

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

פרמטרים

  • tabId

    number

    המזהה של הכרטיסייה שעבורה צריך להחזיר את מזהה התהליך של ה-Renderer.

  • 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,
)

הפונקציה מאחזרת את פרטי התהליך לכל מזהה תהליך שצוין.

פרמטרים

  • 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,
)

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

פרמטרים

  • processId

    number

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

  • callback

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

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

    (didTerminate: boolean) => void

    • didTerminate

      בוליאני

      הערך יהיה True אם סיום התהליך הצליח, ו-False אם לא.

החזרות

  • Promise<boolean>

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

אירועים

onCreated

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

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

פרמטרים

  • callback

    פונקציה

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

    (process: Process) => void

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

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

    • תהליכים

      אובייקט