DynamicsCompressorNode: ratio 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 ratio property of the DynamicsCompressorNode interface Is a k-rate AudioParam representing the amount of change, in dB, needed in the input for a 1 dB change in the output.

The ratio property's default value is 12 and it can be set between 1 and 20.

Describes the effect of different ratio on the output signal

Value

An AudioParam.

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

Examples

js
const audioCtx = new AudioContext();
const compressor = audioCtx.createDynamicsCompressor();
compressor.ratio.value = 12;

See BaseAudioContext.createDynamicsCompressor() for more complete example code.

Specifications

Specification
Web Audio API
# dom-dynamicscompressornode-ratio

Browser compatibility

BCD tables only load in the browser

See also