chrome.processes

תיאור

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

הרשאות

processes

זמינות

ערוץ פיתוח

סוגים

Cache

מאפיינים

• liveSize

  number

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

• size

  number

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

Process

מאפיינים

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

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

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

• cssCache

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

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

• id [מזהה]

  number

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

• imageCache

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

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

• jsMemoryAllocated

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

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

• jsMemoryUsed

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

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

• naclDebugPort

  number

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

• רשת

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

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

• osProcessId

  number

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

• privateMemory

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

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

• פרופיל

  מחרוזת

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

• scriptCache

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

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

• sqliteMemory

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

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

• משימות

  TaskInfo[]

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

• סוג

  ProcessType

  סוג התהליך.

ProcessType

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

Enum

‫"browser"

‪"renderer"

‫'extension'

‫"notification"

‫"plugin"

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

‪"nacl"

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

"utility"

‫"gpu"

‫"other"

TaskInfo

מאפיינים

• tabId

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

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

• title

  מחרוזת

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

Methods

getProcessIdForTab()

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

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

פרמטרים

• tabId

  number

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

החזרות

• Promise<number>

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

getProcessInfo()

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

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

פרמטרים

• processIds

  number | number[]

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

• includeMemory

  בוליאני

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

החזרות

• Promise<object>

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

terminate()

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

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

פרמטרים

• processId

  number

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

החזרות

• Promise<boolean>

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

אירועים

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

  • תהליכים

    אובייקט