BaseAudioContext: createIIRFilter() method

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 createIIRFilter() method of the BaseAudioContext interface creates an IIRFilterNode, which represents a general infinite impulse response (IIR) filter which can be configured to serve as various types of filter.

Note: The IIRFilterNode() constructor is the recommended way to create a IIRFilterNode; see Creating an AudioNode.

Syntax

js
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 DOMException

Thrown if all of the feedforward coefficients are 0, or if the first feedback coefficient is 0.

NotSupportedError DOMException

Thrown if one or both of the input arrays exceeds 20 members.

Specifications

Specification
Web Audio API
# dom-baseaudiocontext-createiirfilter

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
createIIRFilter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

See also