Proximity Events

5.1 Attributes

ondeviceproximity of type EventHandler

5.2 DeviceProximityEvent Interface

[Constructor (DOMString type, optional DeviceProximityEventInit eventInitDict)]
interface DeviceProximityEvent : Event {
    readonly attribute double value;
    readonly attribute double min;
    readonly attribute double max;
};
dictionary DeviceProximityEventInit : EventInit {
    double value;
    double min;
    double max;
};

When a user agent is required to fire a device proximity event, the user agent must run the following steps:

1. Create an event that uses the DeviceProximityEvent interface, with the name deviceproximity, which bubbles, is not cancelable, and has no default action, that also meets the following conditions:
   1. If the implementation is unable to report the current device proximity, initialize the value attribute to positive Infinity, otherwise initialize the attribute to the current device proximity.
   2. If the implementation is unable to report the minimum sensing distance, initialize the min attribute to negative Infinity, otherwise initialize the attribute to the minimum sensing distance.
   3. If the implementation is unable to report the maximum sensing distance, initialize the max attribute to positive Infinity, otherwise initialize the attribute to the maximum sensing distance.
2. Queue a task to dispatch the newly created event at the Window object.

When the current proximity changes, the user agent must fire a device proximity event.

6.1 Attributes

onuserproximity of type EventHandler

6.2 UserProximityEvent Interface

[Constructor (DOMString type, optional UserProximityEventInit eventInitDict)]
interface UserProximityEvent : Event {
    readonly attribute boolean near;
};
dictionary UserProximityEventInit : EventInit {
    boolean near;
};

When a user agent is required to fire a user proximity event, the user agent must run the following steps:

1. Create an event that uses the UserProximityEvent interface, with the name userproximity, which bubbles, is not cancelable, and has no default action, that also meets the following conditions:
   1. If the implementation is unable to report the current user proximity state, initialize the near attribute to false, otherwise initialize the attribute to the current user proximity state.
2. Queue a task to dispatch the newly created event at the Window object.

When the current user proximity state changes, the user agent must fire a user proximity event.