chrome.processes

תיאור

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

הרשאות

processes

זמינות

ערוץ הפיתוח

סוגים

Cache

תכונות

  • liveSize

    מספר

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

  • גודל

    מספר

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

Process

תכונות

  • cpu

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

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

  • cssCache

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

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

  • id

    מספר

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

  • imageCache

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

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

  • jsMemoryAllocated

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

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

  • jsMemoryUsed

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

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

  • naclDebugPort

    מספר

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

  • רשת

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

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

  • osProcessId

    מספר

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

  • privateMemory

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

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

  • פרופיל

    מחרוזת

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

  • scriptCache

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

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

  • sqliteMemory

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

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

  • משימות

    TaskInfo[]

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

  • סוג

    ProcessType

    סוג התהליך.

ProcessType

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

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

"renderer"

"worker"

"nacl"

"service_worker"

TaskInfo

תכונות

  • tabId

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

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

  • title

    מחרוזת

    שם המשימה.

שיטות

getProcessIdForTab()

הבטחה 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

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

פרמטרים

  • tabId

    מספר

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

  • קריאה חוזרת (callback)

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

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

    (processId: number)=>void

    • processId

      מספר

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

החזרות

  • הבטחה<number>

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

getProcessInfo()

הבטחה 
chrome.processes.getProcessInfo(
  processIds: number|number[],
  includeMemory: boolean,
  callback?: function,
)

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

פרמטרים

  • processIds

    מספר|מספר[]

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

  • includeMemory

    boolean

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

  • קריאה חוזרת (callback)

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

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

    (processes: object)=>void

    • תהליכים

      אובייקט

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

החזרות

  • Promise<object>

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

terminate()

הבטחה 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

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

פרמטרים

  • processId

    מספר

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

  • קריאה חוזרת (callback)

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

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

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

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

החזרות

  • Promise<boolean>

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

אירועים

onCreated

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

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

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

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

    (process: Process)=>void

onExited

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

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

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

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

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

    • processId

      מספר

    • exitType

      מספר

    • exitCode

      מספר

onUnresponsive

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

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

פרמטרים

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

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

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

    (processes: object)=>void

    • תהליכים

      אובייקט