Web/API/IIRFilterNode/IIRFilterNode

The IIRFilterNode() constructor of the Web Audio API creates a new IIRFilterNode object which an AudioNode processor which implements a general infinite impulse response filter.

Syntax

var iIRFilterNode = new IIRFilterNode(context, options)

Parameters

Inherits parameters from the AudioNodeOptions dictionary.

context: A reference to an AudioContext.
options: Options are as follows:

feedforward

A sequence of feedforward coefficients.
feedback: A sequence of feedback coefficients.

Unlike other nodes in the Web Audio API, the options passed into the IIR filter upon creation are not optional. The filter needs these values to work and with the vast range of filters available, there is no default.

Return value

A new IIRFilterNode object instance.

Examples

let feedForward = [0.00020298, 0.0004059599, 0.00020298];
let feedBackward = [1.0126964558, -1.9991880801, 0.9873035442];

const AudioContext = window.AudioContext || window.webkitAudioContext;
const audioCtx = new AudioContext();

const iirFilter = new IIRFilterNode(audioCtx, { feedforward: feedForward, feedback: feedBackward });

Specifications

Specification	Status	Comment
Web Audio APIThe definition of 'IIRFilterNode()' in that specification.	Working Draft	Initial definition.

Browser Compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`IIRFilterNode()` constructor	Chrome Full support 55 Notes' Full support 55 Notes' Notes' Before version 59, the default values were not supported.	Edge Full support 79	Firefox Full support 53	IE No support No	Opera Full support 42	Safari No support No	WebView Android Full support 55 Notes' Full support 55 Notes' Notes' Before version 59, the default values were not supported.	Chrome Android Full support 55 Notes' Full support 55 Notes' Notes' Before version 59, the default values were not supported.	Firefox Android Full support 53	Opera Android Full support 42	Safari iOS No support No	Samsung Internet Android Full support 6.0 Notes' Full support 6.0 Notes' Notes' Before Samsung Internet 7.0, the default values were not supported.

Legend

Full support: Full support
No support: No support
See implementation notes.': See implementation notes.

IIRFilterNode() by Mozilla Contributors is licensed under CC-BY-SA 2.5.