Package Exports
- task-handler
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (task-handler) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
task-handler
A simple, dependency-free Task Manager to make handling of your Javascript Timers easier to work with.
Combined with pubchan, provides a lightweight and powerful toolkit for managing asynchronous coordination of your applications events.
Note: Documentation is currently a work in progress. However, the code itself is at a stable level and used in production. This module has been lifted from our private repositories and released to the public.
Install
yarn add task-handleror
npm install --save task-handler100% Flow Coverage
Proudly built with 100% Flow Coverage and exported .flow.js files so your flow projects will benefit!
We strongly recommend you look over the types in the source. This will give you an idea of how the various pieces of the package work.
Note: There are certain things Flow is not capable of providing type coverage for, such as try/catch blocks. These are not included in our assessment of "100% Coverage".
Example
Simple
/* @flow */
import createTaskHandler from 'task-handler';
const task = createTaskHandler('simple');
// after timeout
task.after('task:one', 3000, () => log('task:one execute'));
// every interval, execute
task.every('task:two', 3000, () => log('task:two execute'));
// immediately execute (nextTick, immediate, timeout priority - first found)
task.defer('task:four', () => log('task:four execute'));
// every interval and immediately (defer), execute
task.everyNow('task:three', 3000, () => log('task:three execute'));
// clear all tasks, killing the event queue and completing execution
task.after('complete', 10000, () => {
log('complete - clearing tasks');
task.clear();
});More Examples
For more examples you can check out the examples directory
API Reference
Module Exports
createTaskHandler (Function) (default)
Overview
A factory for building and retrieving TaskHandler instances. If an id is
provided as the functions argument, it will return a TaskHandler with the
given id. If that TaskHandler was previously created, it returns it, otherwise
it creates a new instance and returns that.
import createTaskHandler from 'task-handler';
const task = createTaskHandler();Type Signature
declare function createTaskHandler(id?: string): TaskHandler;TaskHandler (Class)
Documentation coming soon...
// public interface for TaskHandler
class TaskHandler {
// how many scheduled tasks of any type do we have?
get size(): number
// create a timeout, cancelling any timeouts
// currently scheduled with the given id if any
after(
id: TaskID,
delay: number,
fn: CallbackFn,
...args: Array<any>
): CallbackRef
defer(id: TaskID, fn: CallbackFn, ...args: Array<any>): CallbackRef
every(
id: TaskID,
interval: number,
fn: CallbackFn,
...args: Array<any>
): CallbackRef
everyNow(
id: TaskID,
interval: number,
fn: CallbackFn,
...args: Array<any>
): CallbackRef
// cancel the given timeout (optionally provide a type if it should only
// be cancelled if its of the given type).
// returns true if a task was cancelled.
cancel(id: TaskID, type?: TaskTypes): boolean
// cancel all of a given type (or all if no argument provided)
clear(...types: Array<TaskTypes>): void
// are the given tasks currently scheduled? returns true if all tasks
// given are present.
has(...ids: Array<TaskID>): boolean
}TaskRef (Object)
type TaskID = string;
type TaskCancelFunction = () => boolean;
type WhileConditionFn = (ref: CallbackRef, ...args: Array<*>) => boolean;
type CallbackRef = {|
+task: TaskHandler,
+id: TaskID,
+cancel: TaskCancelFunction,
+while: (condition: WhileConditionFn) => void,
|};