MediaKeySession: message event

Baseline Widely available

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

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

The message event of the MediaKeySession interface fires when a message is generated by the content decryption module.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

js
addEventListener("message", (event) => { })

onmessage = (event) => { }

Event type

A MediaKeyMessageEvent. Inherits from Event.

Event MediaKeyMessageEvent

Event properties

MediaKeyMessageEvent.message Read only

Returns an ArrayBuffer with a message from the content decryption module. Messages vary by key system.

MediaKeyMessageEvent.messageType Read only

Indicates the type of message. May be one of license-request, license-renewal, license-release, or individualization-request.

Specifications

Specification
Encrypted Media Extensions
# dom-mediakeysession-onmessage

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
message event
Chrome – Partial support
Chrome 42 – 54 (Release date: 2015-04-14)
footnote Partial support
footnote The onmessage event handler property is not supported.
Chrome – Full support
Chrome 55 (Release date: 2016-12-01)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 52 (Release date: 2017-03-07)
footnote Full support
Opera – Partial support
Opera 29 – 41 (Release date: 2015-04-28)
footnote Partial support
footnote The onmessage event handler property is not supported.
Opera – Full support
Opera 42 (Release date: 2016-12-13)
footnote Full support
Safari – Full support
Safari 12.1 (Release date: 2019-03-25)
footnote Full support
Chrome Android – Partial support
Chrome Android 42 – 54 (Release date: 2015-04-15)
footnote Partial support
footnote The onmessage event handler property is not supported.
Chrome Android – Full support
Chrome Android 55 (Release date: 2016-12-06)
footnote Full support
Firefox for Android – Full support
Firefox for Android 52 (Release date: 2017-03-07)
footnote Full support
Opera Android – Partial support
Opera Android 29 – 41 (Release date: 2015-04-28)
footnote Partial support
footnote The onmessage event handler property is not supported.
Opera Android – Full support
Opera Android 42 (Release date: 2017-01-21)
footnote Full support
Safari on iOS – Full support
Safari on iOS 12.2 (Release date: 2019-03-25)
footnote Full support
Samsung Internet – Partial support
Samsung Internet 4 – 5.4 (Release date: 2016-03-11)
footnote Partial support
footnote The onmessage event handler property is not supported.
Samsung Internet – Full support
Samsung Internet 6 (Release date: 2017-08-23)
footnote Full support
WebView Android – Partial support
WebView Android 43 – 54 (Release date: 2015-05-27)
footnote Partial support
footnote The onmessage event handler property is not supported.
WebView Android – Full support
WebView Android 55 (Release date: 2016-12-06)
footnote Full support
WebView on iOS – Full support
WebView on iOS 12.2 (Release date: 2019-03-25)
footnote Full support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.