chrome.processes

說明

使用 chrome.processes API 與瀏覽器程序互動。

權限

processes

可用性

開發人員頻道

類型

Cache

屬性

  • liveSize

    數字

    使用的快取部分，以位元組為單位。

  • 大小

    數字

    快取大小 (以位元組為單位)。

Process

屬性

  • CPU

    號碼 選填

    最近一次測量的程序 CPU 使用率，以程序所有執行緒使用的單一 CPU 核心總百分比表示。這會提供從零到 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 或 getProcessInfo 搭配 includeMemory 旗標，以回呼形式接收物件時，才能使用這項功能。

  • 資料

    字串

    與該程序相關聯的設定檔。

  • scriptCache

    快取 選填

    程序的指令碼快取最新資訊。只有在透過 onUpdated 或 onUpdatedWithMemory 的回呼接收物件時，才能使用這個方法。

  • sqliteMemory

    數字 選填

    程序 SQLite 記憶體用量的最新測量結果，以位元組為單位。只有在透過 onUpdated 或 onUpdatedWithMemory 的回呼接收物件時，才能使用這個方法。

  • 工作

    TaskInfo[]

    代表這個程序中執行工作的 TaskInfo 陣列。

  • 類型

    ProcessType

    程序類型。

ProcessType

瀏覽器程序類型。

列舉

「browser」

「renderer」

「extension」

「notification」

「plugin」

「worker」
已過時，不會再傳回。

「nacl」

「service_worker」
已過時，永遠不會傳回。

「utility」

"gpu"

「other」

TaskInfo

屬性

  • tabId

    數字 選填

    選用分頁 ID，如果這項工作代表在算繪程序上執行的分頁。

  • title

    字串

    工作名稱。

方法

getProcessIdForTab()

chrome.processes.getProcessIdForTab(
  tabId: number,
): Promise<number>

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

參數

  • tabId

    數字

    要傳回轉譯器程序 ID 的索引標籤 ID。

傳回

  • Promise<number>

getProcessInfo()

chrome.processes.getProcessInfo(
  processIds: number | number[],
  includeMemory: boolean,
): Promise<object>

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

參數

  • processIds

    數字 | 數字 []

    要傳回程序資訊的程序 ID 清單或單一程序 ID。如果清單為空白，表示要求所有程序。

  • includeMemory

    布林值

    如果需要詳細的記憶體用量，則為「true」。請注意，收集記憶體用量資訊會增加 CPU 用量，因此只應在需要時查詢。

傳回

  • Promise<object>

terminate()

chrome.processes.terminate(
  processId: number,
): Promise<boolean>

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

參數

  • processId

    數字

    要終止的程序 ID。

傳回

  • Promise<boolean>

事件

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

      數字

    • exitType

      數字

    • exitCode

      數字

onUnresponsive

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

每次程序無回應時觸發，並提供對應的程序物件。

參數

  • callback

    函式

    callback 參數如下： 

    (process: Process) => void

onUpdated

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

每次工作管理員更新處理程序統計資料時都會觸發，並提供更新的處理程序物件字典，依處理程序 ID 建立索引。

參數

  • callback

    函式

    callback 參數如下： 

    (processes: object) => void

    • 程序

      物件

onUpdatedWithMemory

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

每次工作管理員更新處理程序統計資料時都會觸發，並提供更新的處理程序物件字典，依處理程序 ID 編列索引。與 onUpdate 相同，但每個 Process 物件中都包含記憶體用量詳細資料。請注意，收集記憶體用量資訊會增加 CPU 用量，因此只應在需要時監聽。

參數

  • callback

    函式

    callback 參數如下： 

    (processes: object) => void

    • 程序

      物件