screen-wake-lock
Permissions-Policy Media

개요

screen-wake-lock 지시어는 Screen Wake Lock API의 navigator.wakeLock.request('screen')으로 화면이 자동으로 어두워지거나 잠기지 않게 유지하는 기능을 제어합니다. 기본 허용 목록은 self이며, 레시피·내비게이션·프레젠테이션 화면 등에 쓰입니다.

자세히

`screen-wake-lock=(self)`는 자기 오리진, `screen-wake-lock=()`는 전면 차단, `screen-wake-lock=(self "https://present.example.com")`는 지정 오리진에 위임합니다. iframe에는 `allow="screen-wake-lock"`가 필요합니다. 정책이 거부하면 navigator.wakeLock.request('screen')이 반환하는 Promise는 NotAllowedError로 reject됩니다.

웨이크 록은 문서가 보이는(visible) 상태에서만 유지되며, 탭이 백그라운드로 가면 자동 해제되고 다시 활성화 시 재요청해야 합니다. 화면을 계속 켜두면 배터리 소모가 커지므로, 사용자에게 이로운 경우에만 최소 범위로 위임하는 것이 좋습니다. 보안 컨텍스트에서만 동작하며 구형 Feature-Policy를 대체합니다.

문법

Permissions-Policy: screen-wake-lock=(self)

실무 참고

관련 지시어