תיאור
שימוש ב-chrome.processes
API כדי לקיים אינטראקציה עם התהליכים של הדפדפן.
הרשאות
processes
זמינות
סוגים
Cache
מאפיינים
-
liveSize
number
החלק של המטמון שנמצא בשימוש, בבייטים.
-
size
number
גודל המטמון, בבייט.
Process
מאפיינים
-
cpu, מעבד, CPU, סי פי יו
מספר אופציונלי
המדידה האחרונה של השימוש של התהליך במעבד, שמתבטאת באחוז הליבה אחת של המעבד שנעשה בה שימוש בסך הכול על ידי כל השרשור של התהליך. הפונקציה מחזירה ערך בין אפס ל-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[]
מערך של TaskInfos שמייצג את המשימות שפועלות בתהליך הזה.
-
סוג
סוג התהליך.
ProcessType
סוגי התהליכים בדפדפן.
טיפוסים בני מנייה (enum)
"browser"
"renderer"
"extension"
"notification"
"plugin"
"worker"
"nacl"
"service_worker"
לא בשימוש, אף פעם לא יוחזר.
"utility"
"gpu"
"other"
TaskInfo
מאפיינים
-
tabId
מספר אופציונלי
מזהה כרטיסייה אופציונלי, אם המשימה הזו מייצגת כרטיסייה שפועלת בתהליך עיבוד.
-
title
מחרוזת
השם של המשימה.
Methods
getProcessIdForTab()
chrome.processes.getProcessIdForTab(
tabId: number,
callback?: function,
)
הפונקציה מחזירה את המזהה של תהליך ה-renderer בכרטיסייה שצוינה.
פרמטרים
-
tabId
number
המזהה של הכרטיסייה שעבורה צריך להחזיר את מזהה התהליך של ה-Renderer.
-
callback
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(processId: number) => void
-
processId
number
מזהה התהליך של תהליך העיבוד של הכרטיסייה.
-
החזרות
-
Promise<number>
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
getProcessInfo()
chrome.processes.getProcessInfo(
processIds: number | number[],
includeMemory: boolean,
callback?: function,
)
הפונקציה מאחזרת את פרטי התהליך לכל מזהה תהליך שצוין.
פרמטרים
-
processIds
number | number[]
רשימת מזהי התהליכים או מזהה תהליך יחיד שעבורם רוצים להחזיר את פרטי התהליך. רשימה ריקה מציינת שכל התהליכים נדרשים.
-
includeMemory
בוליאני
הערך True מוגדר אם נדרש שימוש מפורט בזיכרון. חשוב לזכור שאיסוף מידע על השימוש בזיכרון כרוך בשימוש נוסף במעבד, ולכן כדאי לשלוח שאילתות לקבלת המידע רק כשצריך.
-
callback
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(processes: object) => void
-
תהליכים
אובייקט
מילון של אובייקטים מסוג
Process
לכל תהליך שביקשתם שהוא תהליך צאצא פעיל של תהליך הדפדפן הנוכחי, שממוין לפי מזהה התהליך. מדדים שדורשים צבירת נתונים לאורך זמן לא יאוכלסו בכל אובייקט Process.
-
החזרות
-
Promise<object>
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
terminate()
chrome.processes.terminate(
processId: number,
callback?: function,
)
סיום תהליך העיבוד שצוין. זהו אירוע ששווה ערך לביקור בכתובת about:crash, אבל בלי לשנות את כתובת ה-URL של הכרטיסייה.
פרמטרים
-
processId
number
המזהה של התהליך שרוצים לסיים.
-
callback
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(didTerminate: boolean) => void
-
didTerminate
בוליאני
הערך יהיה True אם סיום התהליך הצליח, ו-False אם לא.
-
החזרות
-
Promise<boolean>
התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.
אירועים
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
-
תהליכים
אובייקט
-