chrome.processes

說明

使用 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

    程序類型。

ProcessType

瀏覽器處理的類型。

列舉

"extension"

"nacl"

"service_worker"

"gpu"

TaskInfo

屬性

  • tabId

    數字 選填

    如果這個工作代表在轉譯器程序中執行的分頁，則為選用分頁 ID。

  • title

    字串

    工作的標題。

方法

getProcessIdForTab()

Promise 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

傳回指定分頁的轉譯器程序 ID。

參數

  • tabId

    號碼

    要傳回轉譯器程序 ID 的分頁 ID。

  • 回呼

    函式選用

    callback 參數如下所示： 

    (processId: number)=>void

    • processId

      號碼

      分頁轉譯器程序的程序 ID。

傳回

  • Promise<number>

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

getProcessInfo()

Promise 
chrome.processes.getProcessInfo(
  processIds: number|number[],
  includeMemory: boolean,
  callback?: function,
)

擷取各個指定程序 ID 的程序資訊。

參數

  • processIds

    數字|數字 []

    傳回程序 ID 的清單或單一程序 ID。如果清單空白，代表已要求所有程序。

  • includeMemory

    boolean

    如果必須提供詳細的記憶體用量，則為「true」。請注意，收集記憶體用量資訊會導致額外的 CPU 使用率，因此只應在必要時查詢。

  • 回呼

    函式選用

    callback 參數如下所示： 

    (processes: object)=>void

    • 程序

      物件

      每個要求程序的 Process 物件字典，該程序是目前瀏覽器程序的有效子項程序，並依程序 ID 建立索引。每個 Process 物件中不會填入長期需要匯總的指標。

傳回

  • Promise<object>

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

terminate()

Promise 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

終止指定的轉譯器程序。相當於造訪 about:crash，但不會變更分頁的網址。

參數

  • processId

    號碼

    要終止程序的 ID。

  • 回呼

    函式選用

    callback 參數如下所示： 

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

      如果終止程序成功，則為「是」，否則傳回「否」。

傳回

  • Promise<boolean>

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。

活動

onCreated

chrome.processes.onCreated.addListener(
  callback: function,
)

每次建立程序時就觸發，會提供破壞程序物件。

參數

  • 回呼

    功能

    callback 參數如下所示： 

    (process: Process)=>void

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,
)

每當程序沒有回應時觸發，並提供破壞程序物件。

參數

  • 回呼

    功能

    callback 參數如下所示： 

    (process: Process)=>void

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

    • 程序

      物件