Idley

Helper functions for implementing the idle-until-urgent pattern. For detailed explanation of this pattern, see this article from Philip Walton.

Installation

``
// with yarn
yarn add idley

// with npm
npm install idley
`

Usage

`ts
// ES2015+ and TS
import { computed, throttled, debounced } from 'idley'

// CommonJS
var idley = require('idley')
`

Functions

$3

computed(fn: function): function

Creates a function that returns the result of executing the passed fn when the browser is idle. If the result is requested and it has not been computed yet, the function will be executed immediately.

`ts
import { computed } from 'idley'

const heavyTask = () => 5

const foo = computed(heavyTask)

console.log(foo()) // 5
`

$3

throttled(fn: function): function

Creates a throttled function that only invokes the passed fn at most once when the browser is idle.

`ts
import { throttled } from 'idley'

const heavyTask = (n) => console.log(n)

const foo = throttled(heavyTask)

foo(1)
foo(2)

// 2
`

$3

debounced(fn: function): function

Creates a debounced function that delays invoking the passed fn until the browser is idle.


`ts
import { debounced } from 'idley'

const heavyTask = (n) => console.log(n)

const foo = debounced(heavyTask)

foo(1)
foo(2)

// 1
// 2
``

_This library relies on requestIdleCallback. It will degrade to requestAnimationFrame, or setTimeout in this order_

Published under MIT Licence

(c) Yosbel Marin 2018