MIDIOutput.send()

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

MIDIOutput.send(data, timestamp);

Parameters

data
A sequence of one or more valid MIDI messages. Each entry represents a single byte of data.
timestampOptional
A DOMHighResTimestamp with the time in milliseconds, which is the delay before sending the message.

Exceptions

TypeError
Thrown if data is not a valid sequence, or does not contain a valid MIDI message.
InvalidAccessError
Thrown if data is a system exclusive message, and the MIDIAccess did not enable eclusive access.
InvalidStateError
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.

function sendMiddleC( midiAccess, portID ) {
  var noteOnMessage = [0x90, 60, 0x7f];    // note on middle C, full velocity
  var 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

No specification found

No specification data found for api.MIDIOutput.send.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser compatibility

BCD tables only load in the browser