[Pkg-javascript-commits] [node-promise] 01/02: Imported Upstream version 5.0.0
Leo Iannacone
l3on-guest at moszumanska.debian.org
Tue May 6 13:48:41 UTC 2014
This is an automated email from the git hooks/post-receive script.
l3on-guest pushed a commit to branch master
in repository node-promise.
commit affbfbf5d039a13de3ff893d8012354ab0c07a63
Author: Leo Iannacone <l3on at ubuntu.com>
Date: Tue May 6 15:15:57 2014 +0200
Imported Upstream version 5.0.0
---
.jshintrc | 5 ++
.npmignore | 6 ++
.travis.yml | 6 ++
LICENSE | 19 ++++
Readme.md | 211 ++++++++++++++++++++++++++++++++++++++++++++
component.json | 17 ++++
core.js | 105 ++++++++++++++++++++++
index.js | 180 +++++++++++++++++++++++++++++++++++++
package.json | 25 ++++++
test/adapter-a.js | 17 ++++
test/extensions-tests.js | 224 +++++++++++++++++++++++++++++++++++++++++++++++
test/promises-tests.js | 4 +
test/resolver-tests.js | 176 +++++++++++++++++++++++++++++++++++++
13 files changed, 995 insertions(+)
diff --git a/.jshintrc b/.jshintrc
new file mode 100644
index 0000000..47c256f
--- /dev/null
+++ b/.jshintrc
@@ -0,0 +1,5 @@
+{
+ "asi": true,
+ "node": true,
+ "strict": true
+}
diff --git a/.npmignore b/.npmignore
new file mode 100644
index 0000000..59bed65
--- /dev/null
+++ b/.npmignore
@@ -0,0 +1,6 @@
+components
+node_modules
+test
+.gitignore
+.travis.yml
+component.json
diff --git a/.travis.yml b/.travis.yml
new file mode 100644
index 0000000..aa94b8b
--- /dev/null
+++ b/.travis.yml
@@ -0,0 +1,6 @@
+language: node_js
+node_js:
+ - "0.7"
+ - "0.8"
+ - "0.9"
+ - "0.10"
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..7a1f763
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,19 @@
+Copyright (c) 2014 Forbes Lindesay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..26e2003
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,211 @@
+<a href="http://promises-aplus.github.com/promises-spec"><img src="http://promises-aplus.github.com/promises-spec/assets/logo-small.png" align="right" /></a>
+# promise
+
+This is a simple implementation of Promises. It is a super set of ES6 Promises designed to have readable, performant code and to provide just the extensions that are absolutely necessary for using promises today.
+
+For detailed tutorials on its use, see www.promisejs.org
+
+[](https://travis-ci.org/then/promise)
+[](https://gemnasium.com/then/promise)
+[](http://badge.fury.io/js/promise)
+
+## Installation
+
+**Server:**
+
+ $ npm install promise
+
+**Client:**
+
+You can use browserify on the client, or use the pre-compiled script that acts as a pollyfill.
+
+```html
+<script src="https://www.promisejs.org/polyfills/promise-4.0.0.js"></script>
+```
+
+## Usage
+
+The example below shows how you can load the promise library (in a way that works on both client and server). It then demonstrates creating a promise from scratch. You simply call `new Promise(fn)`. There is a complete specification for what is returned by this method in [Promises/A+](http://promises-aplus.github.com/promises-spec/).
+
+```javascript
+var Promise = require('promise');
+
+var promise = new Promise(function (resolve, reject) {
+ get('http://www.google.com', function (err, res) {
+ if (err) reject(err);
+ else resolve(res);
+ });
+});
+```
+
+## API
+
+Before all examples, you will need:
+
+```js
+var Promise = require('promise');
+```
+
+### new Promise(resolver)
+
+This creates and returns a new promise. `resolver` must be a function. The `resolver` function is passed two arguments:
+
+ 1. `resolve` should be called with a single argument. If it is called with a non-promise value then the promise is fulfilled with that value. If it is called with a promise (A) then the returned promise takes on the state of that new promise (A).
+ 2. `reject` should be called with a single argument. The returned promise will be rejected with that argument.
+
+### Static Functions
+
+ These methods are invoked by calling `Promise.methodName`.
+
+#### Promise.resolve(value)
+
+(deprecated aliases: `Promise.from(value)`, `Promise.cast(value)`)
+
+Converts values and foreign promises into Promises/A+ promises. If you pass it a value then it returns a Promise for that value. If you pass it something that is close to a promise (such as a jQuery attempt at a promise) it returns a Promise that takes on the state of `value` (rejected or fulfilled).
+
+#### Promise.all(array)
+
+Returns a promise for an array. If it is called with a single argument that `Array.isArray` then this returns a promise for a copy of that array with any promises replaced by their fulfilled values. Otherwise it returns a promise for an array that conatins its arguments, except with promises replaced by their resolution values. e.g.
+
+```js
+Promise.all([Promise.from('a'), 'b', Promise.from('c')])
+ .then(function (res) {
+ assert(res[0] === 'a')
+ assert(res[1] === 'b')
+ assert(res[2] === 'c')
+ })
+
+Promise.all(Promise.from('a'), 'b', Promise.from('c'))
+ .then(function (res) {
+ assert(res[0] === 'a')
+ assert(res[1] === 'b')
+ assert(res[2] === 'c')
+ })
+```
+
+#### Promise.denodeify(fn)
+
+_Non Standard_
+
+Takes a function which accepts a node style callback and returns a new function that returns a promise instead.
+
+e.g.
+
+```javascript
+var fs = require('fs')
+
+var read = Promise.denodeify(fs.readFile)
+var write = Promise.denodeify(fs.writeFile)
+
+var p = read('foo.json', 'utf8')
+ .then(function (str) {
+ return write('foo.json', JSON.stringify(JSON.parse(str), null, ' '), 'utf8')
+ })
+```
+
+#### Promise.nodeify(fn)
+
+_Non Standard_
+
+The twin to `denodeify` is useful when you want to export an API that can be used by people who haven't learnt about the brilliance of promises yet.
+
+```javascript
+module.exports = Promise.nodeify(awesomeAPI)
+function awesomeAPI(a, b) {
+ return download(a, b)
+}
+```
+
+If the last argument passed to `module.exports` is a function, then it will be treated like a node.js callback and not parsed on to the child function, otherwise the API will just return a promise.
+
+### Prototype Methods
+
+These methods are invoked on a promise instance by calling `myPromise.methodName`
+
+### Promise#then(onFulfilled, onRejected)
+
+This method follows the [Promises/A+ spec](http://promises-aplus.github.io/promises-spec/). It explains things very clearly so I recommend you read it.
+
+Either `onFulfilled` or `onRejected` will be called and they will not be called more than once. They will be passed a single argument and will always be called asynchronously (in the next turn of the event loop).
+
+If the promise is fulfilled then `onFulfilled` is called. If the promise is rejected then `onRejected` is called.
+
+The call to `.then` also returns a promise. If the handler that is called returns a promise, the promise returned by `.then` takes on the state of that returned promise. If the handler that is called returns a value that is not a promise, the promise returned by `.then` will be fulfilled with that value. If the handler that is called throws an exception then the promise returned by `.then` is rejected with that exception.
+
+#### Promise#done(onFulfilled, onRejected)
+
+_Non Standard_
+
+The same semantics as `.then` except that it does not return a promise and any exceptions are re-thrown so that they can be logged (crashing the application in non-browser environments)
+
+#### Promise#nodeify(callback)
+
+_Non Standard_
+
+If `callback` is `null` or `undefined` it just returns `this`. If `callback` is a function it is called with rejection reason as the first argument and result as the second argument (as per the node.js convention).
+
+This lets you write API functions that look like:
+
+```javascript
+function awesomeAPI(foo, bar, callback) {
+ return internalAPI(foo, bar)
+ .then(parseResult)
+ .then(null, retryErrors)
+ .nodeify(callback)
+}
+```
+
+People who use typical node.js style callbacks will be able to just pass a callback and get the expected behavior. The enlightened people can not pass a callback and will get awesome promises.
+
+## Extending Promises
+
+ There are three options for extending the promises created by this library.
+
+### Inheritance
+
+ You can use inheritance if you want to create your own complete promise library with this as your basic starting point, perfect if you have lots of cool features you want to add. Here is an example of a promise library called `Awesome`, which is built on top of `Promise` correctly.
+
+```javascript
+var Promise = require('promise');
+function Awesome(fn) {
+ if (!(this instanceof Awesome)) return new Awesome(fn);
+ Promise.call(this, fn);
+}
+Awesome.prototype = Object.create(Promise.prototype);
+Awesome.prototype.constructor = Awesome;
+
+//Awesome extension
+Awesome.prototype.spread = function (cb) {
+ return this.then(function (arr) {
+ return cb.apply(this, arr);
+ })
+};
+```
+
+ N.B. if you fail to set the prototype and constructor properly or fail to do Promise.call, things can fail in really subtle ways.
+
+### Wrap
+
+ This is the nuclear option, for when you want to start from scratch. It ensures you won't be impacted by anyone who is extending the prototype (see below).
+
+```javascript
+function Uber(fn) {
+ if (!(this instanceof Uber)) return new Uber(fn);
+ var _prom = new Promise(fn);
+ this.then = _prom.then;
+}
+
+Uber.prototype.spread = function (cb) {
+ return this.then(function (arr) {
+ return cb.apply(this, arr);
+ })
+};
+```
+
+### Extending the Prototype
+
+ In general, you should never extend the prototype of this promise implimenation because your extensions could easily conflict with someone elses extensions. However, this organisation will host a library of extensions which do not conflict with each other, so you can safely enable any of those. If you think of an extension that we don't provide and you want to write it, submit an issue on this repository and (if I agree) I'll set you up with a repository and give you permission to co [...]
+
+## License
+
+ MIT
diff --git a/component.json b/component.json
new file mode 100644
index 0000000..c572fc5
--- /dev/null
+++ b/component.json
@@ -0,0 +1,17 @@
+{
+ "name": "promise",
+ "repo": "then/promise",
+ "description": "Bare bones Promises/A+ implementation",
+ "version": "5.0.0",
+ "keywords": [],
+ "dependencies": {
+ "johntron/asap": "*"
+ },
+ "development": {},
+ "license": "MIT",
+ "scripts": [
+ "index.js",
+ "core.js"
+ ],
+ "twitter": "@ForbesLindesay"
+}
\ No newline at end of file
diff --git a/core.js b/core.js
new file mode 100644
index 0000000..763bebf
--- /dev/null
+++ b/core.js
@@ -0,0 +1,105 @@
+'use strict';
+
+var asap = require('asap')
+
+module.exports = Promise
+function Promise(fn) {
+ if (typeof this !== 'object') throw new TypeError('Promises must be constructed via new')
+ if (typeof fn !== 'function') throw new TypeError('not a function')
+ var state = null
+ var value = null
+ var deferreds = []
+ var self = this
+
+ this.then = function(onFulfilled, onRejected) {
+ return new Promise(function(resolve, reject) {
+ handle(new Handler(onFulfilled, onRejected, resolve, reject))
+ })
+ }
+
+ function handle(deferred) {
+ if (state === null) {
+ deferreds.push(deferred)
+ return
+ }
+ asap(function() {
+ var cb = state ? deferred.onFulfilled : deferred.onRejected
+ if (cb === null) {
+ (state ? deferred.resolve : deferred.reject)(value)
+ return
+ }
+ var ret
+ try {
+ ret = cb(value)
+ }
+ catch (e) {
+ deferred.reject(e)
+ return
+ }
+ deferred.resolve(ret)
+ })
+ }
+
+ function resolve(newValue) {
+ try { //Promise Resolution Procedure: https://github.com/promises-aplus/promises-spec#the-promise-resolution-procedure
+ if (newValue === self) throw new TypeError('A promise cannot be resolved with itself.')
+ if (newValue && (typeof newValue === 'object' || typeof newValue === 'function')) {
+ var then = newValue.then
+ if (typeof then === 'function') {
+ doResolve(then.bind(newValue), resolve, reject)
+ return
+ }
+ }
+ state = true
+ value = newValue
+ finale()
+ } catch (e) { reject(e) }
+ }
+
+ function reject(newValue) {
+ state = false
+ value = newValue
+ finale()
+ }
+
+ function finale() {
+ for (var i = 0, len = deferreds.length; i < len; i++)
+ handle(deferreds[i])
+ deferreds = null
+ }
+
+ doResolve(fn, resolve, reject)
+}
+
+
+function Handler(onFulfilled, onRejected, resolve, reject){
+ this.onFulfilled = typeof onFulfilled === 'function' ? onFulfilled : null
+ this.onRejected = typeof onRejected === 'function' ? onRejected : null
+ this.resolve = resolve
+ this.reject = reject
+}
+
+/**
+ * Take a potentially misbehaving resolver function and make sure
+ * onFulfilled and onRejected are only called once.
+ *
+ * Makes no guarantees about asynchrony.
+ */
+function doResolve(fn, onFulfilled, onRejected) {
+ var done = false;
+ try {
+ fn(function (value) {
+ if (done) return
+ done = true
+ onFulfilled(value)
+ }, function (reason) {
+ if (done) return
+ done = true
+ onRejected(reason)
+ })
+ } catch (ex) {
+ if (done) return
+ done = true
+ onRejected(ex)
+ }
+}
diff --git a/index.js b/index.js
new file mode 100644
index 0000000..d96b7fc
--- /dev/null
+++ b/index.js
@@ -0,0 +1,180 @@
+'use strict';
+
+//This file contains then/promise specific extensions to the core promise API
+
+var Promise = require('./core.js')
+var asap = require('asap')
+
+module.exports = Promise
+
+/* Static Functions */
+
+function ValuePromise(value) {
+ this.then = function (onFulfilled) {
+ if (typeof onFulfilled !== 'function') return this
+ return new Promise(function (resolve, reject) {
+ asap(function () {
+ try {
+ resolve(onFulfilled(value))
+ } catch (ex) {
+ reject(ex);
+ }
+ })
+ })
+ }
+}
+ValuePromise.prototype = Object.create(Promise.prototype)
+
+var TRUE = new ValuePromise(true)
+var FALSE = new ValuePromise(false)
+var NULL = new ValuePromise(null)
+var UNDEFINED = new ValuePromise(undefined)
+var ZERO = new ValuePromise(0)
+var EMPTYSTRING = new ValuePromise('')
+
+Promise.resolve = function (value) {
+ if (value instanceof Promise) return value
+
+ if (value === null) return NULL
+ if (value === undefined) return UNDEFINED
+ if (value === true) return TRUE
+ if (value === false) return FALSE
+ if (value === 0) return ZERO
+ if (value === '') return EMPTYSTRING
+
+ if (typeof value === 'object' || typeof value === 'function') {
+ try {
+ var then = value.then
+ if (typeof then === 'function') {
+ return new Promise(then.bind(value))
+ }
+ } catch (ex) {
+ return new Promise(function (resolve, reject) {
+ reject(ex)
+ })
+ }
+ }
+
+ return new ValuePromise(value)
+}
+
+Promise.from = Promise.cast = function (value) {
+ var err = new Error('Promise.from and Promise.cast are deprecated, use Promise.resolve instead')
+ err.name = 'Warning'
+ console.warn(err.stack)
+ return Promise.resolve(value)
+}
+
+Promise.denodeify = function (fn, argumentCount) {
+ argumentCount = argumentCount || Infinity
+ return function () {
+ var self = this
+ var args = Array.prototype.slice.call(arguments)
+ return new Promise(function (resolve, reject) {
+ while (args.length && args.length > argumentCount) {
+ args.pop()
+ }
+ args.push(function (err, res) {
+ if (err) reject(err)
+ else resolve(res)
+ })
+ fn.apply(self, args)
+ })
+ }
+}
+Promise.nodeify = function (fn) {
+ return function () {
+ var args = Array.prototype.slice.call(arguments)
+ var callback = typeof args[args.length - 1] === 'function' ? args.pop() : null
+ try {
+ return fn.apply(this, arguments).nodeify(callback)
+ } catch (ex) {
+ if (callback === null || typeof callback == 'undefined') {
+ return new Promise(function (resolve, reject) { reject(ex) })
+ } else {
+ asap(function () {
+ callback(ex)
+ })
+ }
+ }
+ }
+}
+
+Promise.all = function () {
+ var calledWithArray = arguments.length === 1 && Array.isArray(arguments[0])
+ var args = Array.prototype.slice.call(calledWithArray ? arguments[0] : arguments)
+
+ if (!calledWithArray) {
+ var err = new Error('Promise.all should be called with a single array, calling it with multiple arguments is deprecated')
+ err.name = 'Warning'
+ console.warn(err.stack)
+ }
+
+ return new Promise(function (resolve, reject) {
+ if (args.length === 0) return resolve([])
+ var remaining = args.length
+ function res(i, val) {
+ try {
+ if (val && (typeof val === 'object' || typeof val === 'function')) {
+ var then = val.then
+ if (typeof then === 'function') {
+ then.call(val, function (val) { res(i, val) }, reject)
+ return
+ }
+ }
+ args[i] = val
+ if (--remaining === 0) {
+ resolve(args);
+ }
+ } catch (ex) {
+ reject(ex)
+ }
+ }
+ for (var i = 0; i < args.length; i++) {
+ res(i, args[i])
+ }
+ })
+}
+
+Promise.reject = function (value) {
+ return new Promise(function (resolve, reject) {
+ reject(value);
+ });
+}
+
+Promise.race = function (values) {
+ return new Promise(function (resolve, reject) {
+ values.forEach(function(value){
+ Promise.resolve(value).then(resolve, reject);
+ })
+ });
+}
+
+/* Prototype Methods */
+
+Promise.prototype.done = function (onFulfilled, onRejected) {
+ var self = arguments.length ? this.then.apply(this, arguments) : this
+ self.then(null, function (err) {
+ asap(function () {
+ throw err
+ })
+ })
+}
+
+Promise.prototype.nodeify = function (callback) {
+ if (typeof callback != 'function') return this
+
+ this.then(function (value) {
+ asap(function () {
+ callback(null, value)
+ })
+ }, function (err) {
+ asap(function () {
+ callback(err)
+ })
+ })
+}
+
+Promise.prototype['catch'] = function (onRejected) {
+ return this.then(null, onRejected);
+}
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..d661b79
--- /dev/null
+++ b/package.json
@@ -0,0 +1,25 @@
+{
+ "name": "promise",
+ "version": "5.0.0",
+ "description": "Bare bones Promises/A+ implementation",
+ "main": "index.js",
+ "scripts": {
+ "test": "mocha -R spec --timeout 200 --slow 99999",
+ "test-resolve": "mocha test/resolver-tests.js -R spec --timeout 200 --slow 999999",
+ "test-extensions": "mocha test/extensions-tests.js -R spec --timeout 200 --slow 999999"
+ },
+ "repository": {
+ "type": "git",
+ "url": "https://github.com/then/promise.git"
+ },
+ "author": "ForbesLindesay",
+ "license": "MIT",
+ "devDependencies": {
+ "promises-aplus-tests": "*",
+ "better-assert": "*",
+ "mocha": "*"
+ },
+ "dependencies": {
+ "asap": "~1.0.0"
+ }
+}
\ No newline at end of file
diff --git a/test/adapter-a.js b/test/adapter-a.js
new file mode 100644
index 0000000..ebda3ed
--- /dev/null
+++ b/test/adapter-a.js
@@ -0,0 +1,17 @@
+var Promise = require('../');
+
+
+exports.deferred = function () {
+ var resolve, reject;
+ var promise = new Promise(function (_resolve, _reject) {
+ resolve = _resolve;
+ reject = _reject;
+ });
+ return {
+ promise: promise,
+ resolve: resolve,
+ reject: reject
+ };
+};
+exports.resolved = Promise.resolve;
+exports.rejected = Promise.reject;
\ No newline at end of file
diff --git a/test/extensions-tests.js b/test/extensions-tests.js
new file mode 100644
index 0000000..521c97b
--- /dev/null
+++ b/test/extensions-tests.js
@@ -0,0 +1,224 @@
+var assert = require('better-assert')
+var Promise = require('../')
+var sentinel = {}
+var promise = new Promise(function (resolve) {
+ resolve(sentinel)
+})
+var thenable = {then: function (fullfilled, rejected) { fullfilled(sentinel) }}
+var thenableRejected = {then: function (fullfilled, rejected) { rejected(sentinel) }}
+
+var a = {}
+var b = {}
+var c = {}
+
+var A = Promise.resolve(a)
+var B = Promise.resolve(b)
+var C = Promise.resolve(c)
+
+var rejection = {}
+var rejected = new Promise(function (resolve, reject) { reject(rejection) })
+
+describe('extensions', function () {
+ describe('Promise.denodeify(fn, [argumentCount])', function () {
+ it('returns a function that uses promises instead of callbacks', function (done) {
+ function wrap(val, key, callback) {
+ return callback(null, {val: val, key: key})
+ }
+ var pwrap = Promise.denodeify(wrap)
+ pwrap(sentinel, 'foo')
+ .then(function (wrapper) {
+ assert(wrapper.val === sentinel)
+ assert(wrapper.key === 'foo')
+ done()
+ })
+ })
+ it('converts callback error arguments into rejection', function (done) {
+ function fail(val, key, callback) {
+ return callback(sentinel)
+ }
+ var pfail = Promise.denodeify(fail)
+ pfail(promise, 'foo')
+ .then(null, function (err) {
+ assert(err === sentinel)
+ done()
+ })
+ })
+ it('with an argumentCount it ignores extra arguments', function (done) {
+ function wrap(val, key, callback) {
+ return callback(null, {val: val, key: key})
+ }
+ var pwrap = Promise.denodeify(wrap, 2)
+ pwrap(sentinel, 'foo', 'wtf')
+ .then(function (wrapper) {
+ assert(wrapper.val === sentinel)
+ assert(wrapper.key === 'foo')
+ done()
+ })
+ })
+ })
+ describe('Promise.nodeify(fn)', function () {
+ it('converts a promise returning function into a callback function', function (done) {
+ var add = Promise.nodeify(function (a, b) {
+ return Promise.resolve(a)
+ .then(function (a) {
+ return a + b
+ })
+ })
+ add(1, 2, function (err, res) {
+ if (err) return done(err)
+ assert(res === 3)
+ return done()
+ })
+ })
+ it('converts rejected promises into the first argument of the callback', function (done) {
+ var add = Promise.nodeify(function (a, b) {
+ return Promise.resolve(a)
+ .then(function (a) {
+ throw sentinel
+ })
+ })
+ var add2 = Promise.nodeify(function (a, b) {
+ throw sentinel
+ })
+ add(1, 2, function (err, res) {
+ assert(err === sentinel)
+ add2(1, 2, function (err, res){
+ assert(err === sentinel)
+ done()
+ })
+ })
+ })
+ it('passes through when no callback is provided', function (done) {
+ var add = Promise.nodeify(function (a, b) {
+ return Promise.resolve(a)
+ .then(function (a) {
+ return a + b
+ })
+ })
+ add(1, 2)
+ .then(function (res) {
+ assert(res === 3)
+ done()
+ })
+ })
+ })
+ describe('Promise.all(...)', function () {
+ describe('an array', function () {
+ describe('that is empty', function () {
+ it('returns a promise for an empty array', function (done) {
+ var res = Promise.all([])
+ assert(res instanceof Promise)
+ res.then(function (res) {
+ assert(Array.isArray(res))
+ assert(res.length === 0)
+ })
+ .nodeify(done)
+ })
+ })
+ describe('of objects', function () {
+ it('returns a promise for the array', function (done) {
+ var res = Promise.all([a, b, c])
+ assert(res instanceof Promise)
+ res.then(function (res) {
+ assert(Array.isArray(res))
+ assert(res[0] === a)
+ assert(res[1] === b)
+ assert(res[2] === c)
+ })
+ .nodeify(done)
+ })
+ })
+ describe('of promises', function () {
+ it('returns a promise for an array containing the fulfilled values', function (done) {
+ var res = Promise.all([A, B, C])
+ assert(res instanceof Promise)
+ res.then(function (res) {
+ assert(Array.isArray(res))
+ assert(res[0] === a)
+ assert(res[1] === b)
+ assert(res[2] === c)
+ })
+ .nodeify(done)
+ })
+ })
+ describe('of mixed values', function () {
+ it('returns a promise for an array containing the fulfilled values', function (done) {
+ var res = Promise.all([A, b, C])
+ assert(res instanceof Promise)
+ res.then(function (res) {
+ assert(Array.isArray(res))
+ assert(res[0] === a)
+ assert(res[1] === b)
+ assert(res[2] === c)
+ })
+ .nodeify(done)
+ })
+ })
+ describe('containing at least one rejected promise', function () {
+ it('rejects the resulting promise', function (done) {
+ var res = Promise.all([A, rejected, C])
+ assert(res instanceof Promise)
+ res.then(function (res) {
+ throw new Error('Should be rejected')
+ },
+ function (err) {
+ assert(err === rejection)
+ })
+ .nodeify(done)
+ })
+ })
+ })
+ })
+
+ describe('promise.done(onFulfilled, onRejected)', function () {
+ it.skip('behaves like then except for not returning anything', function () {
+ //todo
+ })
+ it.skip('rethrows unhandled rejections', function () {
+ //todo
+ })
+ })
+ describe('promise.nodeify(callback)', function () {
+ it('converts a promise returning function into a callback function', function (done) {
+ function add(a, b, callback) {
+ return Promise.resolve(a)
+ .then(function (a) {
+ return a + b
+ })
+ .nodeify(callback)
+ }
+ add(1, 2, function (err, res) {
+ if (err) return done(err)
+ assert(res === 3)
+ return done()
+ })
+ })
+ it('converts rejected promises into the first argument of the callback', function (done) {
+ function add(a, b, callback) {
+ return Promise.resolve(a)
+ .then(function (a) {
+ throw sentinel
+ })
+ .nodeify(callback)
+ }
+ add(1, 2, function (err, res) {
+ assert(err === sentinel)
+ done()
+ })
+ })
+ it('passes through when no callback is provided', function (done) {
+ function add(a, b, callback) {
+ return Promise.resolve(a)
+ .then(function (a) {
+ return a + b
+ })
+ .nodeify(callback)
+ }
+ add(1, 2)
+ .then(function (res) {
+ assert(res === 3)
+ done()
+ })
+ })
+ })
+})
diff --git a/test/promises-tests.js b/test/promises-tests.js
new file mode 100644
index 0000000..87923c2
--- /dev/null
+++ b/test/promises-tests.js
@@ -0,0 +1,4 @@
+var tests = require('promises-aplus-tests');
+var adapter = require('./adapter-a');
+
+tests.mocha(adapter);
\ No newline at end of file
diff --git a/test/resolver-tests.js b/test/resolver-tests.js
new file mode 100644
index 0000000..9f2905b
--- /dev/null
+++ b/test/resolver-tests.js
@@ -0,0 +1,176 @@
+var assert = require('better-assert');
+var Promise = require('../');
+var sentinel = {};
+var promise = new Promise(function (resolve) {
+ resolve(sentinel);
+});
+
+var _it = it;
+describe('resolver-tests', function () {
+ describe('The Promise Constructor', function () {
+ it('has `Object.getPrototypeOf(promise) === Promise.prototype`', function () {
+ assert(Object.getPrototypeOf(promise) === Promise.prototype)
+ })
+ it('has `promise.constructor === Promise`', function () {
+ assert(promise.constructor === Promise)
+ })
+ it('has `promise.constructor === Promise.prototype.constructor`', function () {
+ assert(promise.constructor === Promise.prototype.constructor)
+ })
+ it('has `Promise.length === 1`', function () {
+ assert(Promise.length === 1)
+ })
+ describe('if resolver is not a function', function () {
+ it('must throw a `TypeError`', function () {
+ try {
+ new Promise({})
+ } catch (ex) {
+ assert(ex instanceof TypeError)
+ return
+ }
+ throw new Error('Should have thrown a TypeError')
+ })
+ })
+ describe('if resolver is a function', function () {
+ it('must be called with the promise\'s resolver arguments', function () {
+ new Promise(function (resolve, reject) {
+ assert(typeof resolve === 'function')
+ assert(typeof reject === 'function')
+ done();
+ })
+ })
+ it('must be called immediately, before `Promise` returns', function () {
+ var called = false;
+ new Promise(function (resolve, reject) {
+ called = true;
+ })
+ assert(called)
+ })
+ })
+ describe('Calling resolve(x)', function () {
+ describe('if promise is resolved', function () {
+ it('nothing happens', function (done) {
+ var thenable = {then: function (onComplete) {
+ setTimeout(function () {
+ onComplete(sentinel)
+ }, 50)
+ }};
+ new Promise(function (resolve) {
+ process.nextTick(function () {
+ resolve(thenable)
+ resolve(null)
+ });
+ })
+ .then(function (result) {
+ assert(result === sentinel)
+ })
+ .then(function () {
+ done()
+ }, function (err) {
+ done(err || new Error('Promise rejected'));
+ })
+ })
+ })
+ describe('otherwise', function () {
+ describe('if x is a thenable', function () {
+ it('assimilates the thenable', function () {
+
+ })
+ })
+ describe('otherwise', function () {
+ it('is fulfilled with x as the fulfillment value', function (done) {
+ new Promise(function (resolve, reject) {
+ resolve(sentinel)
+ })
+ .then(function (fulfillmentValue) {
+ assert(fulfillmentValue === sentinel)
+ })
+ .then(function () {
+ done()
+ }, function (err) {
+ done(err || new Error('Promise rejected'));
+ })
+ })
+ })
+ })
+ })
+ describe('Calling reject(x)', function () {
+ describe('if promise is resolved', function () {
+ it('nothing happens', function (done) {
+ var thenable = {then: function (onComplete) {
+ setTimeout(function () {
+ onComplete(sentinel)
+ }, 50)
+ }};
+ new Promise(function (resolve, reject) {
+ process.nextTick(function () {
+ resolve(thenable)
+ reject('foo')
+ });
+ })
+ .then(function (result) {
+ assert(result === sentinel)
+ })
+ .then(function () {
+ done()
+ }, function (err) {
+ done(err || new Error('Promise rejected'));
+ })
+ })
+ })
+ describe('otherwise', function () {
+ it('is rejected with x as the rejection reason', function (done) {
+ new Promise(function (resolve, reject) {
+ reject(sentinel)
+ })
+ .then(null, function (rejectionReason) {
+ assert(rejectionReason === sentinel)
+ })
+ .then(function () {
+ done()
+ }, function (err) {
+ done(err || new Error('Promise rejected'));
+ })
+ })
+ })
+ })
+ })
+ describe('if resolver throws', function () {
+ describe('if promise is resolved', function () {
+ it('nothing happens', function (done) {
+ var thenable = {then: function (onComplete) {
+ setTimeout(function () {
+ onComplete(sentinel)
+ }, 50)
+ }};
+ new Promise(function (resolve, reject) {
+ resolve(thenable)
+ throw new Error('foo');
+ })
+ .then(function (result) {
+ assert(result === sentinel)
+ })
+ .then(function () {
+ done()
+ }, function (err) {
+ done(err || new Error('Promise rejected'));
+ })
+ })
+ })
+ describe('otherwise', function () {
+ it('is rejected with e as the rejection reason', function () {
+ new Promise(function (resolve, reject) {
+ throw sentinel
+ })
+ .then(null, function (rejectionReason) {
+ assert(rejectionReason === sentinel)
+ })
+ .then(function () {
+ done()
+ }, function (err) {
+ done(err || new Error('Promise rejected'));
+ })
+ })
+ })
+ })
+})
\ No newline at end of file
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-javascript/node-promise.git
More information about the Pkg-javascript-commits
mailing list