lie
    TypeScript icon, indicating that this package has built-in type declarations

    3.3.0 • Public • Published

    lie

    Promises/A+ logo [![Build Status](https://travis-ci.org/calvinmetcalf/lie.svg)](https://travis-ci.org/calvinmetcalf/lie)

    lie is a small, performant promise library implementing the Promises/A+ spec (Version 1.1).

    Originally a fork of Ruben Verborgh's promiscuous, with version 2.6 it became a fork of ayepromise by Chris Burgmer.

    npm install lie
     
    var Promise = require('lie');
    // or use the pollyfill
    require('lie/polyfill');

    Usage

    Either use it with browserify (recommended) or grab one of the files from the dist folder:

    • lie.js/lie.min.js exposes 'Promise' either as a UMD module or from the global scope, depending on if a CJS or AMD loader is available.
    • lie.polyfill.js/lie.polyfill.min.js adds 'Promise' to the global scope only if it's not already defined (not a UMD).

    API

    Implements the standard ES6 api:

    new Promise(function(resolve, reject){
        doSomething(function(err, result) {
            if (err) {
                reject(err);
            } else {
                resolve(result);
            }
        });
    }).then(function (value) {
        //on success
    }, function (reason) {
        //on error
    }).catch(function (reason) {
        //shortcut for error handling
    });
     
    Promise.all([
        //array of promises or values
    ]).then(function ([/* array of results */]));
     
    Promise.race([
        //array of promises or values
    ]);
    // either resolves or rejects depending on the first value to do so

    Unhandled Rejections

    In Node.js, lie emits an unhandledRejection event when a rejected promise isn't caught, in line with how io.js does it. This allows it to act as a promise shim in both Node.js and the browser.

    Install

    npm i lie

    DownloadsWeekly Downloads

    4,499,039

    Version

    3.3.0

    License

    MIT

    Unpacked Size

    59.1 kB

    Total Files

    11

    Last publish

    Collaborators

    • cwmma