# debounce-collect

> Makes a function execute only once in a given interval.

Latest version **1.0.2** (published 2015-09-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install debounce-collect
pnpm add debounce-collect
yarn add debounce-collect
bun add debounce-collect
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.2 |
| Published | 2015-09-21 |
| First published | 2015-09-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 12 |
| Author | Rico Sta. Cruz |
| Maintainers | rstacruz |

## Links

- npm: https://www.npmjs.com/package/debounce-collect
- Repository: https://github.com/rstacruz/debounce-collect
- Homepage: https://github.com/rstacruz/debounce-collect#readme
- Issues: https://github.com/rstacruz/debounce-collect/issues
- npm.io page: https://npm.io/package/debounce-collect

## Recent versions

- 1.0.2 (latest) — 2015-09-21
- 1.0.0 — 2015-09-21

## README

# debounce-collect

An implementation of debounce. Unlike [underscore]'s debounce, this one
collects arguments of all calls.

This is based on underscore's [implementation](https://github.com/jashkenas/underscore/blob/1.8.3/underscore.js#L813-L847) of debounce.

[![Status](https://travis-ci.org/rstacruz/debounce-collect.svg?branch=master)](https://travis-ci.org/rstacruz/debounce-collect "See test builds")

[underscore]: http://underscorejs.org/

## Usage

Debounce-collect is available as an npm package.

```js
var debounce = require('debounce-collect')
```

When used outside a CommonJS environment, it's accessible as `global.debounceCollect`.

## Description

```js
debounce(function, wait, [immediate])
```

Creates and returns a new debounced version of the passed function which will
postpone its execution until after `wait` milliseconds have elapsed since the
last time it was invoked. Useful for implementing behavior that should only
happen after the input has stopped arriving. For example: rendering a preview
of a Markdown comment, recalculating a layout after the window has stopped
being resized, and so on.

Pass *true* for the `immediate` argument to cause `debounce()` to trigger the function
on the leading instead of the trailing edge of the `wait` interval. Useful in
circumstances like preventing accidental double-clicks on a "submit" button
from firing a second time. 

### Differences from `_.debounce`

The resulting function will be called with an array of all function arguments
for all calls.

## Example

```js
// this will call the update function:
//
//    update('change', 'file1.txt')
//    update('change', 'file2.txt')
//
chokidar.watch('.')
  .on('all', debounce(update, 50))

function update (argsList) {
  console.log(argsList)

  // result:
  // [
  //   [ 'change', 'file1.txt' ],
  //   [ 'change', 'file2.txt' ]
  // ]
}
```

## Thanks

**debounce-collect** © 2015+, Rico Sta. Cruz. Released under the [MIT] License.<br>
Authored and maintained by Rico Sta. Cruz with help from contributors ([list][contributors]).

> [ricostacruz.com](http://ricostacruz.com) &nbsp;&middot;&nbsp;
> GitHub [@rstacruz](https://github.com/rstacruz) &nbsp;&middot;&nbsp;
> Twitter [@rstacruz](https://twitter.com/rstacruz)

[MIT]: http://mit-license.org/
[contributors]: http://github.com/rstacruz/debounce-collect/contributors

---
_Source: https://npm.io/package/debounce-collect · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._