A library for simple promises and Deferred constructs with TypeScript support.
Go to file
2019-03-26 12:02:02 +01:00
test BREAKING CHANGE(remove util dependency and promisify functionality): update 2019-03-26 12:02:01 +01:00
ts BREAKING CHANGE(remove util dependency and promisify functionality): update 2019-03-26 12:02:01 +01:00
.gitignore add ci 2016-12-16 21:21:58 +01:00
.gitlab-ci.yml fix(core): update to latest gitzone standards 2018-07-02 22:54:13 +02:00
npmextra.json BREAKING CHANGE(scope): switch scope to pushrocks 2018-07-02 22:49:21 +02:00
package-lock.json 3.0.0 2019-03-26 12:02:02 +01:00
package.json 3.0.0 2019-03-26 12:02:02 +01:00
README.md fix(README): fix import statement 2018-07-03 08:41:42 +02:00
tslint.json add ci 2016-12-16 21:21:58 +01:00

@pushrocks/smartpromise

smart helpers that work with promises

Availabililty

npm git git docs

Status for master

build status coverage report npm downloads per month Dependency Status bitHound Dependencies bitHound Code TypeScript node JavaScript Style Guide

Usage

Use TypeScript for best in class instellisense.

Note: smartq uses native ES6 promises smartq does not repeat any native functions, so for things like .all() simply use Promise.all()

import * as q from '@pushrocks/smartpromise'

// Deferred
// -----------------------------------------------
let myAsyncFunction = (): Promise<string> => {
    let done = q.defer<string>() // returns your typical Deferred object
    setTimeout(() => {
        done.resolve('hi') // will throw type error for other types than string as argument ;)
    },6000)
    return done.promise
}

let myAsyncFunction2 = async () => {
    let aString = await myAsyncFunction()
    console.log(aString) // will log 'hi' to console
}

myAsyncFunction2();


// Resolved and Rejected promises
// ------------------------------------------------
q.resolvedPromise(`I'll get logged to console soon`)
    .then(x => {
        console.log(x)
    })

q.rejectedPromise(`what a lovely error message`)
    .then(() => {
        console.log('This never makes it to console')
    }/*, alternatively put a reject function here */)
    .catch(err => {
        console.log(err)
    })

// Promisify (typed)
// ------------------------------------------------

let myCallbackedFunction = (someString: string, someNumber: number, cb) => {
    cb(null, someString)
}

let myPromisedFunction = q.promisify(myCallbackFunction)
myPromisedFunction('helloThere', 2).then(x => {
    console.log(x) // will log 'helloThere' to console
})

For further information read the linked docs at the top of this README.

MIT licensed | © Lossless GmbH

repo-footer