MIDIOutput: send() method

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 send() method of the MIDIOutput interface queues messages for the corresponding MIDI port. The message can be sent immediately, or with an optional timestamp to delay sending.

Syntax

js
send(data)
send(data, timestamp)

Parameters

data

A sequence of one or more valid MIDI messages. Each entry represents a single byte of data.

timestamp Optional

A DOMHighResTimestamp with the time in milliseconds when the message should be sent (relative to Performance.timeOrigin).

Return value

None (undefined).

Exceptions

TypeError

Thrown if data is not a valid sequence, or does not contain a valid MIDI message.

InvalidAccessError DOMException

Thrown if data is a system exclusive message, and the MIDIAccess did not enable exclusive access.

InvalidStateError DOMException

Thrown if the port is disconnected.

Examples

In the following example a middle C note is sent immediately, followed by a note off message one second later.

js
function sendMiddleC(midiAccess, portID) {
  const noteOnMessage = [0x90, 60, 0x7f]; // note on middle C, full velocity
  const output = midiAccess.outputs.get(portID);
  output.send(noteOnMessage); //omitting the timestamp means send immediately.
  output.send([0x80, 60, 0x40], window.performance.now() + 1000.0); // timestamp = now + 1000ms.
}

Specifications

Specification
Web MIDI API
# dom-midioutput-send

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
send

Legend

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

Full support
Full support
No support
No support
See implementation notes.