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

    數字

    OS 提供的程序 ID。

  • privateMemory

    編號 選填

    最近一次的處理程序專用記憶體用量測量結果 (以位元組為單位)。只有在接收物件做為來自 onUpdatedWithMemory 或含有 includeMemory 標記 getProcessInfo 的回呼時才能使用此項目。

  • 資料

    字串

    與程序相關聯的設定檔。

  • scriptCache

    快取 選用

    程序指令碼快取的最新資訊。只有在從 onUpdated 或 onUpdatedWithMemory 的回呼中接收物件時，才會使用這個屬性。

  • sqliteMemory

    編號 選填

    程序最近一次的 SQLite 記憶體用量測量結果 (以位元組為單位)。只有在從 onUpdated 或 onUpdatedWithMemory 的回呼中接收物件時，才會使用這個屬性。

  • 工作

    TaskInfo[]

    TaskInfo 陣列，代表在這個程序上執行的工作。

  • 類型

    ProcessType

    程序類型。

ProcessType

瀏覽器處理的類型。

列舉

"瀏覽器"

"renderer"

「擴充功能」

"通知"

"plugin"

"worker"

"nacl"

"service_worker"

"utility"

"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>

    Promise 適用於 Manifest V3 及以上版本，但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。

getProcessInfo()

Promise 
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()

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

在每次建立程序時觸發，提供校正程序物件。

參數

  • 回呼

    函式

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

每當程序沒有回應時就會觸發，提供 Corrseponding Process 物件。

參數

  • 回呼

    函式

    callback 參數如下所示： 

    (process: Process) => void

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

    • 程序

      物件