說明
使用 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
數字
OS 提供的程序 ID。
-
privateMemory
編號 選填
最近一次的處理程序專用記憶體用量測量結果 (以位元組為單位)。只有在接收物件做為來自 onUpdatedWithMemory 或含有 includeMemory 標記 getProcessInfo 的回呼時才能使用此項目。
-
資料
字串
與程序相關聯的設定檔。
-
scriptCache
快取 選用
程序指令碼快取的最新資訊。只有在從 onUpdated 或 onUpdatedWithMemory 的回呼中接收物件時,才會使用這個屬性。
-
sqliteMemory
編號 選填
程序最近一次的 SQLite 記憶體用量測量結果 (以位元組為單位)。只有在從 onUpdated 或 onUpdatedWithMemory 的回呼中接收物件時,才會使用這個屬性。
-
工作
TaskInfo[]
TaskInfo 陣列,代表在這個程序上執行的工作。
-
類型
程序類型。
ProcessType
瀏覽器處理的類型。
列舉
"瀏覽器"
"renderer"
「擴充功能」
"通知"
"plugin"
"worker"
"nacl"
"service_worker"
"utility"
"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
數字 |數字 []
指定要傳回程序資訊的程序 ID 或單一程序 ID 清單。如果清單空白,代表要求所有程序。
-
includeMemory
布林值
如果需要詳細的記憶體用量,則為「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
布林值
如果終止程序成功,則為 True,否則傳回 false。
-
傳回
-
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,
)
每當程序沒有回應時就會觸發,提供 Corrseponding Process 物件。
onUpdated
chrome.processes.onUpdated.addListener(
callback: function,
)
每次「工作管理員」更新處理程序統計資料時就會觸發,提供更新版 Process 物件的字典,依程序 ID 建立索引。
參數
-
回呼
函式
callback
參數如下所示:(processes: object) => void
-
程序
物件
-
onUpdatedWithMemory
chrome.processes.onUpdatedWithMemory.addListener(
callback: function,
)
每次「工作管理員」更新處理程序統計資料時就會觸發,提供更新版 Process 物件的字典,依程序 ID 建立索引。與 onUpdate 相同,每個 Process 物件都包含記憶體使用詳細資料。請注意,收集記憶體用量資訊會產生額外的 CPU 用量,因此應該只在需要時監聽。
參數
-
回呼
函式
callback
參數如下所示:(processes: object) => void
-
程序
物件
-