chrome.processes

תיאור

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

הרשאות

processes

זמינות

ערוץ פיתוח

סוגים

Cache

מאפיינים

  • liveSize

    number

    החלק בבייטים מתוך המטמון.

  • size

    number

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

Process

מאפיינים

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

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

    המדידה האחרונה של השימוש במעבד (CPU), מבוטאת כאחוז מתוך סך כל ליבת המעבד (CPU) שנעשה בה שימוש בכל ה-threads של התהליך. הפעולה הזו מחזירה ערך בין אפס ל-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.

  • משימות

    TaskInfo[]

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

  • סוג

    ProcessType

    סוג התהליך.

ProcessType

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

Enum

"דפדפן"

"renderer"

"תוסף"

"התראה"

"פלאגין"

"worker"

"nacl"

"service_worker"

"שירות עזר"

"gpu"

"אחר"

TaskInfo

מאפיינים

  • tabId

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

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

  • title

    מחרוזת

    שם המשימה.

שיטות

getProcessIdForTab()

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

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

פרמטרים

  • tabId

    number

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

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

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

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

    (processId: number) => void

    • processId

      number

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

החזרות

  • Promise<number>

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

getProcessInfo()

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

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

פרמטרים

  • processIds

    מספר | מספר[]

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

  • includeMemory

    בוליאני

    הערך הוא 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

    number

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

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

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

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

    (didTerminate: boolean) => void

    • didTerminate

      בוליאני

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

החזרות

  • Promise<boolean>

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

אירועים

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

    • קוד יציאה

      number

onUnresponsive

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

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

פרמטרים

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

    פונקציה

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

    (process: Process) => void

onUpdated

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

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

פרמטרים

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

    פונקציה

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

    (processes: object) => void

    • תהליכים

      אובייקט

onUpdatedWithMemory

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

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

פרמטרים

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

    פונקציה

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

    (processes: object) => void

    • תהליכים

      אובייקט