Navigator.requestMediaKeySystemAccess()

This article needs a technical review. How you can help.

The Navigator.requestMediaKeySystemAccess() method returns a Promise for a MediaKeySystemAccess object.

Syntax

​Navigator.requestMediaKeySystemAccess(keySystem, supportedConfigurations).then(function(mediaKeySystemAccess) { ... });

Parameters

keySystem
A DOMString identifier of the key system. For example com.example.somesystem or org.w3.clearkey.
supportedConfigurations
A non-empty Array of MediaKeySystemConfiguration objects. The first element with a satisfiable configuration will be used.

Note: Firefox implements an older version of the specification and does not require the second, supportedConfigurations, parameter to be defined. This is likely to change in the future (bug 1180482).

Return value

A Promise that resolves to a MediaKeySystemAccess object. If the given keySystem is not supported or none of the the requested configurations are satisfiable, the returned Promise is rejected with a DOMException whose name is NotSupportedError.

Specifications

Specification Status Comment
Encrypted Media Extensions
The definition of 'requestMediaKeySystemAccess()' in that specification.
Working Draft Initial definition

Browser compatibility

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 42.0 (Yes) ? ? ? ?
Feature Android Android Webview Edge Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support 43.0 (Yes) ? ? ? ? ? 42.0

Document Tags and Contributors

 Contributors to this page: abbycar, rolfedh, Sebastianz, sjakthol, jpmedley, teoli
 Last updated by: abbycar,