Skip to content

A composable token for cancelling asynchronous operations.

License

Notifications You must be signed in to change notification settings

reuzel/cancellationtoken

 
 

Repository files navigation

Cancellation Token

npm

Cancellation tokens are composable entities that allow cancelling asynchronous operations.

The implementation roughly follows these TC39 proposals:

The implementation is written in TypeScript and therefore comes with typings already bundled.

Installation

Install the library via your favourite package manager.

npm install cancellationtoken

or

yarn add cancellationtoken

Usage

You can create a new cancellation token along with a function to cancel it via create. Functions can consume tokens by accessing the ìsCancelled property.

import CancellationToken from 'cancellationtoken'

const { cancel, token } = CancellationToken.create()
console.log(token.isCancelled) // prints false
cancel()
console.log(token.isCancelled) // prints true

Documentation

Coming soon! Meanwhile you can use the TypeScript definitions and examples.

Examples

For usage examples have a look at the examples/ directory.

cd examples/
npm install
npm run example 01-tutorial
npm run example <name>

or

cd examples/
yarn
yarn run example 01-tutorial
yarn run example <name>

Contributors


conradreuter

💻 📖 💡 ⚠️

Andrew Arnott

💻 🐛 📖 ⚠️

About

A composable token for cancelling asynchronous operations.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 99.0%
  • JavaScript 1.0%