說明
使用 chrome.processes
API 與瀏覽器的程序互動。
權限
processes
適用國家/地區
類型
Cache
屬性
-
liveSize
號碼
快取使用部分,以位元組為單位。
-
大小
號碼
快取的大小,以位元組為單位。
Process
屬性
-
cpu
數字 選填
程序的 CPU 使用率最近一次的測量值,以程序的所有執行緒表示,所使用單個 CPU 核心的總用量百分比。這個值的範圍從 0 到 CpuInfo.numOfProcessors*100,在多執行緒程序中可超過 100%。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
cssCache
快取 選用
這個程序的 CSS 快取最新資訊。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
id
號碼
瀏覽器提供的程序專屬 ID。
-
imageCache
快取 選用
程序圖片快取的最新資訊。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
jsMemoryAllocated
數字 選填
對程序 JavaScript 分配記憶體的最新測量值 (以位元組為單位)。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
jsMemoryUsed
數字 選填
最近所用程序 JavaScript 記憶體的測量結果 (以位元組為單位)。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
naclDebugPort
號碼
Native Client 程序的偵錯通訊埠。如為其他程序類型,以及未啟用偵錯功能的 NaCl 程序,則為零。
-
聯播網
數字 選填
最近程序網路用量測量結果,以每秒位元組數為單位。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
osProcessId
號碼
程序的 ID (由 OS 提供)。
-
privateMemory
數字 選填
最近一次測量程序專用記憶體用量 (以位元組為單位) 的測量結果。只有在從 onUpdatedWithMemory 或 getProcessInfo 包含 includeMemory 標記的回呼中,以回呼形式接收物件時才能使用。
-
資料
字串
與程序相關聯的設定檔。
-
scriptCache
快取 選用
程序的指令碼快取最新資訊。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
sqliteMemory
數字 選填
程序最近測量的 SQLite 記憶體用量,以位元組為單位。只有從 onUpdated 或 onUpdatedWithMemory 接收物件做為回呼的一部分時,才適用。
-
工作
TaskInfo[]
TaskInfo 陣列,代表在此程序中執行的工作。
-
類型
程序類型。
ProcessType
瀏覽器處理的類型。
列舉
"extension"
"nacl"
"service_worker"
"gpu"
TaskInfo
屬性
-
tabId
數字 選填
如果這個工作代表在轉譯器程序中執行的分頁,則為選用分頁 ID。
-
title
字串
工作的標題。
方法
getProcessIdForTab()
chrome.processes.getProcessIdForTab(
tabId: number,
callback?: function,
)
傳回指定分頁的轉譯器程序 ID。
參數
-
tabId
號碼
要傳回轉譯器程序 ID 的分頁 ID。
-
回呼
函式選用
callback
參數如下所示:(processId: number) => void
-
processId
號碼
分頁轉譯器程序的程序 ID。
-
傳回
-
Promise<number>
Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
getProcessInfo()
chrome.processes.getProcessInfo(
processIds: number | number[],
includeMemory: boolean,
callback?: function,
)
擷取各個指定程序 ID 的程序資訊。
參數
-
processIds
數字 | number[]
傳回程序 ID 的清單或單一程序 ID。如果清單空白,代表已要求所有程序。
-
includeMemory
boolean
如果必須提供詳細的記憶體用量,則為「true」。請注意,收集記憶體用量資訊會導致額外的 CPU 使用率,因此只應在必要時查詢。
-
回呼
函式選用
callback
參數如下所示:(processes: object) => void
-
程序
物件
每個要求程序的
Process
物件字典,該程序是目前瀏覽器程序的有效子項程序,並依程序 ID 建立索引。每個 Process 物件中不會填入長期需要匯總的指標。
-
傳回
-
Promise<object>
Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
terminate()
chrome.processes.terminate(
processId: number,
callback?: function,
)
終止指定的轉譯器程序。相當於造訪 about:crash,但不會變更分頁的網址。
參數
-
processId
號碼
要終止程序的 ID。
-
回呼
函式選用
callback
參數如下所示:(didTerminate: boolean) => void
-
didTerminate
boolean
如果終止程序成功,則為「是」,否則傳回「否」。
-
傳回
-
Promise<boolean>
Promise 僅支援 Manifest V3 以上版本,其他平台就必須使用回呼。
活動
onCreated
chrome.processes.onCreated.addListener(
callback: function,
)
每次建立程序時就觸發,會提供破壞程序物件。
onExited
chrome.processes.onExited.addListener(
callback: function,
)
每次終止程序時觸發,提供離開事件類型。
參數
-
回呼
功能
callback
參數如下所示:(processId: number, exitType: number, exitCode: number) => void
-
processId
號碼
-
exitType
號碼
-
exitCode
號碼
-
onUnresponsive
chrome.processes.onUnresponsive.addListener(
callback: function,
)
每當程序沒有回應時觸發,並提供破壞程序物件。
onUpdated
chrome.processes.onUpdated.addListener(
callback: function,
)
每當「工作管理員」更新程序統計資料,並提供已更新的 Process 物件的字典,即會觸發
參數
-
回呼
功能
callback
參數如下所示:(processes: object) => void
-
程序
物件
-
onUpdatedWithMemory
chrome.processes.onUpdatedWithMemory.addListener(
callback: function,
)
每當「工作管理員」更新程序統計資料,並提供已更新的 Process 物件的字典,即會觸發與 onUpdate 相同,在每個 Process 物件中加入了記憶體用量詳細資料。請注意,收集記憶體用量資訊會導致額外的 CPU 使用率,因此只應在必要時監聽。
參數
-
回呼
功能
callback
參數如下所示:(processes: object) => void
-
程序
物件
-