MDN wants to learn about developers like you:

The OscillatorNode interface represents a periodic waveform, such as a sine wave. It is an AudioScheduledSourceNode audio-processing module that causes a specified frequency of a given wave to be created—in effect, a constant tone.

An OscillatorNode is created using the BaseAudioContext.createOscillator() method. It always has exactly one output and no inputs. Its basic property defaults (see AudioNode for definitions) are:

Number of inputs 0
Number of outputs 1
Channel count mode max
Channel count 2 (not used in the default count mode)
Channel interpretation speakers


Creates a new instance of an OscillatorNode object, optionally providing an object specifying default values for the node's properties.  If the default values are acceptable, you can simply call the BaseAudioContext.createOscillator() factory method.


Inherits properties from its parent, AudioScheduledSourceNode, and adds the following properties:

An a-rate AudioParam representing the frequency of oscillation in hertz (though the AudioParam returned is read-only, the value it represents is not). The default value is 440 Hz (a standard middle-A note).
An a-rate AudioParam representing detuning of oscillation in cents (though the AudioParam returned is read-only, the value it represents is not). The default value is 0.
A string which specifies the shape of waveform to play; this can be one of a number of standard values, or custom to use a PeriodicWave to describe a custom waveform. Different waves will produce different tones. Standard values are "sine", "square", "sawtooth", "triangle" and "custom". The default is "sine".

Event handlers

Sets the event handler for the ended event, which fires when the tone has stopped playing.


Inherits methods from its parent, AudioScheduledSourceNode, and adds the following:

Sets a PeriodicWave which describes a periodic waveform to be used instead of one of the standard waveforms; calling this sets the type to custom. This replaces the now-obsolete OscillatorNode.setWaveTable() method.
Specifies the exact time to start playing the tone.
Specifies the time to stop playing the tone.


The following example shows basic usage of an AudioContext to create an oscillator node and to start playing a tone on it. For an applied example, 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.setValueAtTime(440, audioCtx.currentTime); // value in hertz


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

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support14 Yes25 No156
OscillatorNode() constructor551 ?53 No42 ?
detune14 Yes25 No156
frequency14 Yes25 No156
onended14 Yes25 No156
type14 Yes25 No156
setPeriodicWave14 Yes25 No156
start14 Yes252 No156
stop14 Yes252 No156
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Basic support1414 Yes26 No15 ?
OscillatorNode() constructor551551 ?53 No42 ?
detune Yes14 Yes26 No15 ?
frequency Yes14 Yes26 No15 ?
onended Yes14 Yes26 No15 ?
type Yes14 Yes26 No15 ?
setPeriodicWave Yes14 Yes26 No15 ?
start Yes14 Yes262 No15 ?
stop Yes14 Yes262 No15 ?

1. Before Chrome 59, the default values were not supported.

2. Before Firefox 30, the when parameter was not optional.

See also

Document Tags and Contributors

 Last updated by: MysteryPancake,