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

  • תהליכים

    אובייקט