Web/API/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 StreamsThe definition of 'label' in that specification.	Candidate Recommendation	Initial definition.

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
label	Chrome Full support 55 Notes' Full support 55 Notes' Notes' For earlier versions, this interface is available through the adapter.js polyfill	Edge Full support 12	Firefox Full support 39	IE No support No	Opera No support No Notes' No support No Notes' Notes' This property can be used in Opera by using the adapter.js polyfill.	Safari No support No	WebView Android Full support 55 Notes' Full support 55 Notes' Notes' For earlier versions, this interface is available through the adapter.js polyfill	Chrome Android Full support 55 Notes' Full support 55 Notes' Notes' For earlier versions, this interface is available through the adapter.js polyfill	Firefox Android Full support 39	Opera Android No support No Notes' No support No Notes' Notes' This property can be used in Opera by using the adapter.js polyfill.	Safari iOS No support No	Samsung Internet Android Full support 6.0 Notes' Full support 6.0 Notes' Notes' For earlier versions, this interface is available through the adapter.js polyfill

Legend

Full support  

Full support

No support  

No support

See implementation notes.'

See implementation notes.

MediaDeviceInfo.label by Mozilla Contributors is licensed under CC-BY-SA 2.5.