This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The MIDIMessageEvent
interface of the Web MIDI API represents the event passed to the onmidimessage
event handler of the MIDIInput
interface. A midimessage
event is fired every time a MIDI message is sent from a device represented by a MIDIInput
, for example when a MIDI keyboard key is pressed, a knob is tweaked, or a slider is moved.
Constructor
MIDIMessageEvent.MIDIMessageEvent
- Creates a new
MIDIMessageEvent
object instance.
Properties
MIDIConnectionEvent.data
- A
Uint8Array
containing the data bytes of a single MIDI message. See the MIDI specification for more information on its form.
Note: Even though the Web MIDI API specifies a receivedTime
property that returns a DOMHighResTimeStamp
, Chrome (the only implementation at the time of writing) does not support that property since the basic Event.timeStamp
property already returns a DOMHighResTimeStamp
in Chrome.
Examples
// Printing all messages to console navigator.requestMIDIAccess().then(midiAccess => { Array.from(midiAccess.inputs).forEach(input => { input[1].onmidimessage = console.log; }) });
Specifications
Specification | Status | Comment |
---|---|---|
Web MIDI API The definition of 'MIDIMessageEvent' in that specification. |
Working Draft | 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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
MIDIMessageEvent | Chrome Full support 43 | Edge Full support ≤79 | Firefox ? | IE No support No | Opera Full support 30 | Safari ? | WebView Android No support No | Chrome Android Full support 43 | Firefox Android ? | Opera Android Full support 30 | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
MIDIMessageEvent() constructor | Chrome Full support 43 | Edge Full support ≤79 | Firefox ? | IE No support No | Opera Full support 30 | Safari ? | WebView Android No support No | Chrome Android Full support 43 | Firefox Android ? | Opera Android Full support 30 | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
data | Chrome Full support 43 | Edge Full support ≤79 | Firefox ? | IE No support No | Opera Full support 30 | Safari ? | WebView Android No support No | Chrome Android Full support 43 | Firefox Android ? | Opera Android Full support 30 | Safari iOS No support No | Samsung Internet Android Full support 4.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.