MediaKeySystemAccess: getConfiguration() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2019.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The getConfiguration() method of the MediaKeySystemAccess interface returns an object with the supported combination of the following configuration options:

label Read only

A string identifying the configuration, preserved as-is from the configuration passed to Navigator.requestMediaKeySystemAccess(). Defaults to the empty string ("").

initDataTypes Read only

Returns a list of supported initialization data type names. An initialization data type is a string indicating the format of the initialization data.

audioCapabilities Read only

Returns a list of supported audio type and capability pairs.

videoCapabilities Read only

Returns a list of supported video type and capability pairs.

distinctiveIdentifier Read only

Indicates whether a persistent distinctive identifier is required.

persistentState Read only

Indicates whether the ability to persist state is required.

sessionTypes Read only

An array of strings indicating the session types that are supported by the configuration.

Permitted values include:

temporary: A session for which the license, key(s) and record of or data related to the session are not persisted. The application does not need to manage such storage. Implementations must support this option, and it is the default.
persistent-license: A session for which the license (and potentially other data related to the session) will be persisted. A record of the license and associated keys persists even if the license is destroyed, providing an attestation that the license and key(s) it contains are no longer usable by the client.