We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

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 compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support5511239 No ?2 No
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support551551 Yes39 ?2 No6.0

1. For earlier versions, this interface is available through the adapter.js polyfill

2. This interface is available in Opera through the adapter.js polyfill.

Document Tags and Contributors

Contributors to this page: fscholz, Sheppy, bunnybooboo, jpmedley
Last updated by: fscholz,