OscillatorNode: detune property

Baseline Widely available

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

The detune property of the OscillatorNode interface is an a-rate AudioParam representing detuning of oscillation in cents.

Note: Though the AudioParam returned is read-only, the value it represents is not.

Value

An a-rate AudioParam.

Examples

The following example shows basic usage of an AudioContext to create an oscillator node. For applied examples/information, check out our Violent Theremin demo (see app.js for relevant code).

js
// create web audio api context
const audioCtx = new AudioContext();

// create Oscillator node
const oscillator = audioCtx.createOscillator();

oscillator.type = "square";
oscillator.frequency.setValueAtTime(440, audioCtx.currentTime); // value in hertz
oscillator.detune.setValueAtTime(100, audioCtx.currentTime); // value in cents
oscillator.start();

Specifications

Specification
Web Audio API
# dom-oscillatornode-detune

Browser compatibility

BCD tables only load in the browser

See also