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 프로세스의 경우 0입니다.

  • 네트워크

    번호 선택사항

    프로세스 네트워크 사용량의 최근 측정값(초당 바이트 수)입니다. onUpdated 또는 onUpdatedWithMemory의 콜백의 일부로 객체를 수신하는 경우에만 사용할 수 있습니다.

  • osProcessId

    숫자

    OS에서 제공한 프로세스의 ID입니다.

  • privateMemory

    번호 선택사항

    프로세스 비공개 메모리 사용량의 가장 최근 측정값(단위: 바이트)입니다. includeMemory 플래그가 있는 onUpdatedWithMemory 또는 getProcessInfo의 콜백의 일부로 객체를 수신하는 경우에만 사용할 수 있습니다.

  • 프로필

    문자열

    프로세스가 연결된 프로필입니다.

  • scriptCache

    캐시 선택사항

    프로세스의 스크립트 캐시에 관한 최신 정보입니다. onUpdated 또는 onUpdatedWithMemory의 콜백의 일부로 객체를 수신하는 경우에만 사용할 수 있습니다.

  • sqliteMemory

    번호 선택사항

    프로세스의 SQLite 메모리 사용량에 대한 가장 최근 측정값(단위: 바이트)입니다. onUpdated 또는 onUpdatedWithMemory의 콜백의 일부로 객체를 수신하는 경우에만 사용할 수 있습니다.

  • 작업

    TaskInfo[]

    이 프로세스에서 실행 중인 태스크를 나타내는 TaskInfo 배열입니다.

  • 유형

    ProcessType

    프로세스의 유형입니다.

ProcessType

브라우저 프로세스의 유형입니다.

열거형

'브라우저'

'renderer'

"extension"

"알림"

'플러그인'

'worker'

"nacl"

'service_worker'
사용하지 않음, 반환되지 않습니다.

'유틸리티'

"gpu"

'기타'

TaskInfo

속성

  • tabId

    번호 선택사항

    이 태스크가 렌더러 프로세스에서 실행 중인 탭을 나타내는 경우 선택사항인 탭 ID입니다.

  • 제목

    문자열

    할 일의 제목입니다.

메서드

getProcessIdForTab()

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

지정된 탭의 렌더러 프로세스의 ID를 반환합니다.

매개변수

  • tabId

    숫자

    렌더러 프로세스 ID를 반환할 탭의 ID입니다.

  • callback

    함수 선택사항

    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

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (processes: object) => void

    • 프로세스

      객체

      현재 브라우저 프로세스의 실시간 하위 프로세스인 요청된 각 프로세스에 대한 Process 객체의 사전으로, 프로세스 ID로 색인이 생성됩니다. 시간 경과에 따른 집계가 필요한 측정항목은 각 프로세스 객체에 채워지지 않습니다.

반환 값

  • Promise<object>

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

terminate()

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

지정된 렌더러 프로세스를 종료합니다. about:crash를 방문하는 것과 같지만 탭의 URL은 변경하지 않습니다.

매개변수

  • processId

    숫자

    종료할 프로세스의 ID입니다.

  • callback

    함수 선택사항

    callback 매개변수는 다음과 같습니다. 

    (didTerminate: boolean) => void

    • didTerminate

      부울

      프로세스 종료에 성공하면 true이고, 그렇지 않으면 false입니다.

반환 값

  • Promise<boolean>

    Promise는 Manifest V3 이상에서만 지원되며 다른 플랫폼에서는 콜백을 사용해야 합니다.

이벤트

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로 색인이 생성됩니다. 각 Process 객체에 메모리 사용량 세부정보가 추가된 onUpdate와 동일합니다. 메모리 사용량 정보를 수집하면 추가 CPU 사용량이 발생하므로 필요한 경우에만 리슨해야 합니다.

매개변수

  • callback

    함수

    callback 매개변수는 다음과 같습니다. 

    (processes: object) => void

    • 프로세스

      객체