chrome.processes

설명

chrome.processes API를 사용하여 브라우저의 프로세스와 상호작용합니다.

권한

processes

지원 대상

개발자 채널

유형

Cache

속성

  • liveSize

    숫자

    사용된 캐시의 부분(바이트)입니다.

  • 크기

    숫자

    캐시 크기(바이트)입니다.

Process

속성

  • cpu

    number 선택사항

    프로세스의 모든 스레드에서 사용된 전체 단일 CPU 코어의 백분율로 표시되는 프로세스의 CPU 사용량을 가장 최근에 측정한 값입니다. 이는 0에서 CpuInfo.numOfProcessors*100까지의 값을 제공하며, 다중 스레드 프로세스에서 100% 를 초과할 수 있습니다. onUpdated 또는 onUpdatedWithMemory에서 콜백의 일부로 객체를 수신할 때만 사용할 수 있습니다.

  • cssCache

    캐시 선택사항

    프로세스의 CSS 캐시에 대한 최신 정보입니다. onUpdated 또는 onUpdatedWithMemory에서 콜백의 일부로 객체를 수신할 때만 사용할 수 있습니다.

  • id

    숫자

    브라우저에서 제공하는 프로세스의 고유 ID입니다.

  • imageCache

    캐시 선택사항

    프로세스의 이미지 캐시에 대한 최신 정보입니다. onUpdated 또는 onUpdatedWithMemory에서 콜백의 일부로 객체를 수신할 때만 사용할 수 있습니다.

  • jsMemoryAllocated

    number 선택사항

    프로세스 자바스크립트 할당 메모리에 대한 최근 측정값(바이트)입니다. onUpdated 또는 onUpdatedWithMemory에서 콜백의 일부로 객체를 수신할 때만 사용할 수 있습니다.

  • jsMemoryUsed

    number 선택사항

    사용된 프로세스 JavaScript 메모리의 최근 측정값(바이트)입니다. onUpdated 또는 onUpdatedWithMemory에서 콜백의 일부로 객체를 수신할 때만 사용할 수 있습니다.

  • naclDebugPort

    숫자

    Native Client 프로세스의 디버깅 포트입니다. 다른 프로세스 유형과 디버깅이 사용 설정되지 않은 NaCl 프로세스의 경우 0입니다.

  • 네트워크

    number 선택사항

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

  • osProcessId

    숫자

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

  • privateMemory

    number 선택사항

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

  • profile

    string

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

  • scriptCache

    캐시 선택사항

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

  • sqliteMemory

    number 선택사항

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

  • tasks

    TaskInfo[]

    이 프로세스에서 실행 중인 작업을 나타내는 TaskInfo의 배열입니다.

  • 유형

    ProcessType

    프로세스의 유형입니다.

ProcessType

브라우저가 처리하는 유형입니다.

열거형

"plugin"

"nacl"

TaskInfo

속성

  • tabId

    number 선택사항

    탭 ID로, 이 작업이 렌더기 프로세스에서 실행되는 탭을 나타내는 경우 선택사항입니다.

  • title

    string

    할 일의 제목입니다.

방법

getProcessIdForTab()

프로미스 
chrome.processes.getProcessIdForTab(
  tabId: number,
  callback?: function,
)

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

매개변수

  • tabId

    숫자

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

  • 콜백

    함수 선택사항

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

    (processId: number)=>void

    • processId

      숫자

      탭의 렌더기 프로세스의 프로세스 ID입니다.

반환 값

  • 프로미스<number>

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

getProcessInfo()

프로미스 
chrome.processes.getProcessInfo(
  processIds: number|number[],
  includeMemory: boolean,
  callback?: function,
)

지정된 각 프로세스 ID의 프로세스 정보를 검색합니다.

매개변수

  • processIds

    숫자|숫자[]

    프로세스 정보를 반환할 프로세스 ID 또는 단일 프로세스 ID의 목록입니다. 빈 목록은 모든 프로세스가 요청되었음을 나타냅니다.

  • includeMemory

    boolean

    자세한 메모리 사용량이 필요한 경우 true입니다. 메모리 사용량 정보를 수집하면 CPU 사용량이 추가로 발생하므로 필요할 때만 쿼리해야 합니다.

  • 콜백

    함수 선택사항

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

    (processes: object)=>void

    • processes

      객체

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

반환 값

  • Promise<object>

    프로미스는 Manifest V3 이상에서 지원되지만 콜백은 이전 버전과의 호환성을 위해 제공됩니다. 동일한 함수 호출에 둘 다 사용할 수는 없습니다. 프로미스는 콜백에 전달된 것과 동일한 유형으로 확인됩니다.

terminate()

프로미스 
chrome.processes.terminate(
  processId: number,
  callback?: function,
)

지정된 렌더기 프로세스를 종료합니다. about:crash 방문과 동일하지만 탭의 URL을 변경하지 않습니다.

매개변수

  • processId

    숫자

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

  • 콜백

    함수 선택사항

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

    (didTerminate: boolean)=>void

    • didTerminate

      boolean

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

반환 값

  • Promise<boolean>

    프로미스는 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,
)

프로세스가 응답하지 않을 때마다 발생하며, 해당 프로세스 객체를 제공합니다.

매개변수

  • 콜백

    기능

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

    (process: Process)=>void

onUpdated

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

작업 관리자가 프로세스 통계를 업데이트할 때마다 실행되며, 프로세스 ID로 색인이 생성된 업데이트된 프로세스 객체의 사전을 제공합니다.

매개변수

  • 콜백

    기능

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

    (processes: object)=>void

    • processes

      객체

onUpdatedWithMemory

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

작업 관리자가 프로세스 통계를 업데이트할 때마다 실행되며, 프로세스 ID로 색인이 생성된 업데이트된 프로세스 객체의 사전을 제공합니다. onUpdate와 동일하며 각 Process 객체에 포함된 메모리 사용량 세부정보가 추가됩니다. 메모리 사용량 정보를 수집하면 CPU 사용량이 추가로 발생하므로 필요할 때만 리슨해야 합니다.

매개변수

  • 콜백

    기능

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

    (processes: object)=>void

    • processes

      객체