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>

אירועים

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

    • תהליכים

      אובייקט