# backburner.js
**Repository Path**: mirrors_discourse/backburner.js
## Basic Information
- **Project Name**: backburner.js
- **Description**: A rewrite of the Ember.js run loop as a generic microlibrary
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: discourse-patches
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-10-24
- **Last Updated**: 2026-05-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# backburner.js [](https://travis-ci.org/BackburnerJS/backburner.js)
A rewrite of the Ember.js run loop as a generic microlibrary.
## TL;DR
A priority queue that will efficiently batch, order, reorder and process work; done via scheduling work on specific queues.
## API
### Constructor
| Constructor | Description |
|---|---|
| `new Backburner()` | instantiate a Backburner instance with an array of queue names |
### Instance methods
| Method | Description |
|---|---|
| `Backburner#run` | execute the passed function and flush any deferred actions |
| `Backburner#defer` | defer the passed function to run inside the specified queue |
| `Backburner#deferOnce` | defer the passed function to run inside the specified queue, only execute it once |
| `Backburner#setTimeout` | execute the passed function in a specified amount of time |
| `Backburner#debounce` | execute the passed function in a specified amount of time, reset timer upon additional calls |
| `Backburner#throttle` | rate-limit the passed function for a specified amount of time |
| `Backburner#cancel` | cancel a `deferOnce`, `setTimeout`, `debounce` or `throttle` |
| `Backburner#on` | Add an event callback. Supports the following events:
- `begin` - Fires whenever the runloop begins. Callbacks are passed the current instance and the previous instance.
- `end` - Fires whenever the runloop ends. Callbacks are passed the current instance and the next instance.
|
| `Backburner#off` | Removes an event callback |
| `Backburner#join` | Join the passed method with an existing queue and execute immediately, if there isn't one use `Backburner#run` |
| `Backburner#getDebugInfo` | Returns debug information for counters, timers and queues, which includes surfacing the stack trace information for the respective calls |
#### Alias
| Alias | Description |
|---|---|
| `Backburner#schedule` | same as `defer` |
| `Backburner#scheduleOnce` | same as `deferOnce` |
| `Backburner#later` | same as `setTimeout` |
## Example usage
The following code will only cause a single DOM manipulation:
```html
Backburner demo
```
## Benchmarks
The `/bench` directory includes a number of performance benchmarks.
To run in `node`:
```bash
yarn ember build
node ./bench/index.js # (all benchmarks)
node ./bench/index.js ./bench/benches/some-file.js # (specific benchmark)
```
Or to run in a browser, run `yarn ember server`, and visit `http://localhost:4200` in a browser. Be aware that having the developer tools open/closed can affect JS performance.