AudioContext.createIIRFilter()

The createIIRFilter() method of the AudioContext interface creates an IIRFilterNode, which represents a general infinite impulse response (IIR) filter which can be configured to serve as various types of filter.

Syntax

var iirFilter = AudioContext.createIIRFilter(feedforward, feedback);

Parameters

feedforward

An array of floating-point values specifying the feedforward (numerator) coefficients for the transfer function of the IIR filter. The maximum length of this array is 20, and at least one value must be nonzero.

feedback

An array of floating-point values specifying the feedback (denominator) coefficients for the transfer function of the IIR filter. This array may have up to 20 members, the first of which must not be zero.

Return value

An IIRFilterNode implementing the filter with the specified feedback and feedforward coefficient arrays.

Exceptions

InvalidStateError

All of the feedforward coefficients are 0, and/or the first feedback coefficient is 0.

NotSupportedError

One or both of the input arrays exceeds 20 members.

Specifications

Browser compatibility

See also

• Using the Web Audio API
• IIRFilterNode
• AudioNode