Back to Content

OscillatorNode: frequency property

files/en-us/web/api/oscillatornode/frequency/index.md

latest1.2 KB
Original Source

{{ APIRef("Web Audio API") }}

The frequency property of the {{ domxref("OscillatorNode") }} interface is an a-rate {{domxref("AudioParam")}} representing the frequency of oscillation in hertz.

[!NOTE] Though the AudioParam returned is read-only, the value it represents is not.

Value

An a-rate {{domxref("AudioParam")}}.

Examples

The following example shows basic usage of an {{ domxref("AudioContext") }} to create an oscillator node. For an applied example, 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.start();

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also