BaseAudioContext.createIIRFilter()

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.

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

Specification Status Comment
Web Audio API
The definition of 'createIIRFilter()' in that specification.
Working Draft

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
createIIRFilterChrome Full support 49Edge Full support ≤18Firefox Full support 53
Notes
Full support 53
Notes
Notes Originally implemented on AudioContext in Firefox 50.
IE No support NoOpera Full support YesSafari No support NoWebView Android Full support 49Chrome Android Full support 49Firefox Android Full support 53
Notes
Full support 53
Notes
Notes Originally implemented on AudioContext in Firefox Android 50.
Opera Android Full support YesSafari iOS No support NoSamsung Internet Android Full support 5.0

Legend

Full support
Full support
No support
No support
See implementation notes.
See implementation notes.

See also