MIDIInput: midimessage event

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

The midimessage event of the Web MIDI API is fired when the MIDI port corresponding to this MIDIInput finishes receiving one or more MIDI messages. An instance of MIDIMessageEvent containing the message that was received is passed to the event handler.

Syntax

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

js
addEventListener("midimessage", (event) => { })
onmidimessage = (event) => { }

Event type

An MIDIMessageEvent. Inherits from Event.

Event MIDIMessageEvent

Event properties

This interface also inherits properties from Event.

MIDIMessageEvent.data

A Uint8Array containing the data bytes of a single MIDI message. See the MIDI specification for more information on its form.

Examples

In the following example midimessage events are listened for on all input ports. When a message is received the MIDIMessageEvent.data property is printed to the console.

js
inputs.forEach((input) => {
  input.onmidimessage = (message) => {
    console.log(message.data);
  };
});

Specifications

Specification
Web MIDI API
# dom-midiinput-onmidimessage

Browser compatibility