This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The DeviceProximityEvent interface provides information about the distance of a nearby physical object using the proximity sensor of a device.

Properties

DeviceProximityEvent.max Read only
The maximum sensing distance the sensor is able to report, in centimeters.
DeviceProximityEvent.min Read only
The minimum sensing distance the sensor is able to report, in centimeters. Ususally zero.
DeviceProximityEvent.value Read only
The current device proximity, in centimeters.

Examples

window.addEventListener('deviceproximity', function(event) {
  console.log("value: " + event.value, "max: " + event.max, "min: " + event.min);
});

Specifications

Specification Status Comment
Proximity Sensor
The definition of 'Proximity Events' in that specification.
Working Draft Initial specification

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support No ?

601 2

Yes

No No No
max No ? Yes No No No
min No ? Yes No No No
value No ? Yes No No No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No No ?

601 2

15

No No ?
max No No ?15 No No ?
min No No ?15 No No ?
value No No ?15 No No ?

1. This event is disabled by default. See bug 1359076.

2. From version 60: this feature is behind the device.sensors.proximity.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

See also

Document Tags and Contributors

Last updated by: connorshea,