promiscuous

promiscuous

promiscuous is a JavaScript promise/deferred implementation, implementing the Promises/A+ spec.

It strives to be minimal (< 1kb minified / 0.5kb gzipped) and fast.

Installation and usage

Node

First, install promiscuous with npm.

$ npm install promiscuous

Then, include promiscuous in your code file.

var promiscuous = require('promiscuous');

Browsers

Include promiscuous in your HTML file.

<script src="promicuous-browser.js"></script>

API

Create a resolved promise

var one = promiscuous.resolve("one");
one.then(console.log);
/* one */

Create a rejected promise

var none = promiscuous.reject("error");
none.then(console.log, console.error);
/* error */

Write a function that returns a promise

function promiseSomething(something) {
  var defer = promiscuous.deferred();
  setTimeout(function () {
    if (something)
      defer.resolve(something);
    else
      defer.reject("nothing");
  }, 1000);
  return defer.promise();
}
promiseSomething("something").then(console.log, console.error);
/* something */