A devicechange
event is sent to a MediaDevices
instance whenever a media device such as a camera, microphone, or speaker is connected to or removed from the system. It's a generic Event
with no added properties.
General info
- Specification
- Media Capture and Streams
- Interface
- Event
- Bubbles
- No
- Cancelable
- No
- Target
MediaDevices
- Default Action
- None
Properties
Property | Type | Description |
---|---|---|
target Read only |
EventTarget |
The event target (the topmost target in the DOM tree). |
type Read only |
DOMString |
The type of event. |
bubbles Read only |
Boolean |
Whether the event normally bubbles or not |
cancelable Read only |
Boolean |
Whether the event is cancellable or not? |
Related events
None.
Example
See "Example" in MediaDevices.ondevicechange for an example that uses devicechange
events to update lists of devices onscreen.
Specifications
Specification | Status | Comment |
---|---|---|
Media Capture and Streams The definition of 'devicechange' in that specification. |
Editor's Draft | Initial specification. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Edge | Internet Explorer | Opera | Safari (WebKit) | |
---|---|---|---|---|---|---|---|
Basic support | 52.0 | 51 (51)[1] | (Yes) | ? | ? | 39 | ? |
Feature | Android | Android Webview | Edge | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|---|---|
Basic support | No support | No support | (Yes) | ? | ? | ? | 39 | ? | No support |
[1] Support for the devicechange
event and for MediaDevices.ondevicechange
landed in Firefox 51, but only for Mac, and disabled by default. It can be enabled by setting the preference media.ondevicechange.enabled
to true
. Support for this event was added for Linux and Windows—and it was enabled by default—starting in Firefox 52.