debounce-stream
v2.0.0
Published
Debounces a stream.
Downloads
4,848
Readme
debounce-stream
Debounces a stream.
Example
var events = require('dom-delegation-stream')
, values = require('dom-value-object-stream')
, debounce = require('debounce-stream')
events(document.querySelector('[rel=inputs]'), 'input')
.pipe(values()) // values is a stream that progressively updates on user input
.pipe(debounce(500)) // emit only after a pause of 500 ms
.on('data', function(data) {
console.log(data) // the data after a user has stopped typing for 500 ms
})
API
debounce([milliseconds] [, immediate])
- Create a new debounce duplex streammilliseconds
- Integer. The number of milliseconds to debounce the stream. Defaults to100
immediate
- Boolean. Iftrue
, the debounced function will call immediately, rather than at the end of input. Default isfalse
.
Returns a duplex stream that accepts values on one end, and emits the debounced values on the other.
Notes
This module which was previously known as stream-debounce
is now known as
debounce-stream
. Thanks to RangerMauve for allowing this
module to take over that name! The version was bumped to v2.0.0 for the name
change, and to ensure compatibility for users of the old version.
License
MIT. See LICENSE for details.