UIScreen: potentialEDRHeadroom property
The potentialEDRHeadroom property is how many times brighter than normal white the brightest white this screen can show at most is.
Value
A number with no unit: a multiple of brightness, no less than 1.
- Read-only. Assigning to it throws
TypeError. 1means this screen cannot show content brighter than normal white. On the iPhone Air simulator (iOS 27.2) it is1.- It is never less than
currentEDRHeadroom. - According to the iOS documentation, it may change when the status of reference display mode changes; you can read it again in
referencedisplaymodestatuschange. Not verified in the simulator.
Examples
js
application.addEventListener('sceneconnect', (e) => {
const screen = e.scene.screen;
console.log(screen.potentialEDRHeadroom);
});Result: on the iPhone Air simulator (iOS 27.2), logs 1.
Corresponding iOS API
UIScreen.potentialEDRHeadroom.