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

    數字

    作業系統提供的程序 ID。

  • privateMemory

    號碼 選填

    程序私人記憶體用量的最新測量值，以位元組為單位。只有在透過 includeMemory 標記的 onUpdatedWithMemory 或 getProcessInfo 回呼接收物件時，才可使用。

  • 資料

    字串

    與程序相關聯的設定檔。

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

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

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

參數

  • tabId

    數字

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

  • callback

    函式 選填

    callback 參數如下所示： 

    (processId: number) => void

    • processId

      數字

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

傳回

  • Promise<number>

    承諾在資訊清單 3 以上版本中受支援，但回呼則是為了回溯相容性而提供。您無法在同一個函式呼叫中同時使用這兩種方法。承諾會以傳遞至回呼的相同類型解析。

getProcessInfo()

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

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

參數

  • processIds

    數字 | 數字陣列

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

  • includeMemory

    布林值

    如果需要詳細的記憶體用量，則為「是」。請注意，收集記憶體用量資訊會導致額外的 CPU 用量，因此請只在需要時查詢。

  • callback

    函式 選填

    callback 參數如下所示： 

    (processes: object) => void

    • 程序

      物件

      針對每個要求的程序 (為目前瀏覽器程序的實際子程序) 建立 Process 物件的字典，並以處理程序 ID 做為索引。需要匯總一段時間內資料的指標，不會填入每個 Process 物件。

傳回

  • Promise<object>

    承諾在資訊清單 3 以上版本中受支援，但回呼則是為了回溯相容性而提供。您無法在同一個函式呼叫中同時使用這兩種方法。承諾會以傳遞至回呼的相同類型解析。

terminate()

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

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

參數

  • processId

    數字

    要終止的程序 ID。

  • callback

    函式 選填

    callback 參數如下所示： 

    (didTerminate: boolean) => void

    • didTerminate

      布林值

      如果終止程序成功，則傳回 True，否則傳回 false。

傳回

  • Promise<boolean>

    承諾在資訊清單 3 以上版本中受支援，但回呼則是為了回溯相容性而提供。您無法在同一個函式呼叫中同時使用這兩種方法。承諾會以傳遞至回呼的相同類型解析。

事件

onCreated

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

每次建立程序時觸發，提供對應的 Process 物件。

參數

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

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

參數

  • 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

    • 程序

      物件