browser.idle

설명

chrome.idle API를 사용하여 머신의 유휴 상태가 변경되는 시점을 감지합니다.

권한

idle

idle API를 사용하려면 확장 프로그램의 매니페스트에서 "idle" 권한을 선언해야 합니다. 예를 들면 다음과 같습니다.

{
  "name": "My extension",
  ...
  "permissions": [
    "idle"
  ],
  ...
}

유형

IdleState

Chrome 44 이상 브라우저.*(Chrome 148부터)

열거형

'active'

"idle"

"locked"

메서드

getAutoLockDelay()

Chrome 73 이상 Chrome 148 이후 browser.* ChromeOS만 해당

browser.idle.getAutoLockDelay(): Promise<number>

유휴 상태에서 화면이 자동으로 잠길 때까지 걸리는 시간(초)을 가져옵니다. 화면이 자동으로 잠기지 않는 경우 기간 0을 반환합니다. 현재 ChromeOS에서만 지원됩니다.

반환 값

• <number> 약속

  Chrome 116 이상 Chrome 148 이후 browser.*

queryState()

browser.idle.queryState(
  detectionIntervalInSeconds: number,
): Promise<IdleState>

시스템이 잠겨 있으면 'locked'를, 사용자가 지정된 시간(초) 동안 입력을 생성하지 않으면 'idle'을, 그 외의 경우에는 'active'를 반환합니다.

매개변수

• detectionIntervalInSeconds

  숫자

  마지막 사용자 입력이 감지된 후 detectionIntervalInSeconds초가 경과하면 시스템이 유휴 상태인 것으로 간주됩니다.

반환 값

• Promise<IdleState>

  Chrome 116 이상 Chrome 148 이후 browser.*

setDetectionInterval()

browser.idle.setDetectionInterval(
  intervalInSeconds: number,
): void

onStateChanged 이벤트에 대해 시스템이 유휴 상태인 시점을 결정하는 데 사용되는 간격(초)을 설정합니다. 기본 간격은 60초입니다.

매개변수

• intervalInSeconds

  숫자

  시스템이 유휴 상태인 시점을 결정하는 데 사용되는 기준점(초)입니다.

이벤트

onStateChanged

browser.idle.onStateChanged.addListener(
  callback: function,
)

시스템이 활성, 유휴 또는 잠금 상태로 변경될 때 실행됩니다. 이 이벤트는 화면이 잠기거나 화면 보호기가 활성화되면 'locked'로, 시스템이 잠금 해제되고 사용자가 지정된 시간(초) 동안 입력을 생성하지 않으면 'idle'로, 사용자가 유휴 시스템에서 입력을 생성하면 'active'로 실행됩니다.

매개변수

• callback

  함수

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

  (newState: IdleState) => void

  • newState

    IdleState