OscillatorNode

OscillatorNode is an interface within the Web Audio API that represents a periodic waveform generator. It is a type of AudioNode, which are the building blocks of the Web Audio graph. An OscillatorNode can produce a sound wave of a specified frequency, shape, and gain. It is commonly used to create basic tones, melodies, and sound effects in web applications.

The OscillatorNode has several key properties that can be set to control its output. The type property determines the waveform of the generated sound, with common options including sine, square, sawtooth, and triangle waves. The frequency property controls the pitch of the sound, measured in Hertz. The detune property allows for fine-tuning the frequency, often used for vibrato effects.

To use an OscillatorNode, it is first created using the AudioContext's `createOscillator()` method. It is then connected to other AudioNodes in the audio graph, typically ending with an AudioContext's destination to be played through the speakers. The `start()` method is used to begin generating the waveform, and `stop()` is used to cease generation. The `onended` event handler can be used to detect when the oscillator has finished playing.