W3cubDocs

/DOM

MediaDeviceInfo.label

The label readonlyinline property of the MediaDeviceInfo interface returns a DOMString, that is a label describing this device (for example "External USB Webcam"). Only available during active MediaStream use, or when persistent permissions have been granted.

Syntax

var label = MediaDeviceInfo.label;

Value

A DOMString which describes the media device. For security reasons, the label is always an empty string ("") if the user has not obtained permission to use at least one media device, either by starting a stream from the microphone or camera, or by persistent permissions being granted.

Specifications

Specification Status Comment
Media Capture and Streams
The definition of 'label' in that specification.
Candidate Recommendation Initial definition.

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 55
55
For earlier versions, this interface is available through the adapter.js polyfill
12 39 No ?
?
This interface is available in Opera through the adapter.js polyfill.
No
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support 55
55
For earlier versions, this interface is available through the adapter.js polyfill
55
55
For earlier versions, this interface is available through the adapter.js polyfill
Yes 39 ?
?
This interface is available in Opera through the adapter.js polyfill.
No 6.0

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo/label