W3cubDocs

/DOM

OscillatorNode.detune

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

Syntax

var oscillator = audioCtx.createOscillator();
oscillator.detune.value = 100; // value in cents

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

Value

An a-rate AudioParam.

Example

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).

// create web audio api context
var audioCtx = new (window.AudioContext || window.webkitAudioContext)();

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

oscillator.type = 'square';
oscillator.frequency.value = 440; // value in hertz
oscillator.detune.value = 100; // value in cents
oscillator.start();

Specifications

Specification	Status	Comment
Web Audio API The definition of 'detune' in that specification.	Working Draft

Browser compatibility

Feature	Chrome	Edge	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	14 webkit	(Yes)	23	No support	15 webkit 22 (unprefixed)	6 webkit