This method will find all promises in the given structure and return a promise that will be fulfilled when all of the promises have been rejected or fulfilled. When the returned promise is fulfilled, you can use synchronous inspection on each of the promises to read their values.

Let's make an asynchronous assertion that we can use for the examples:

expect.addAssertion('to be a number after a short delay', function (expect, subject) {
  return expect.promise(function (run) {
    setTimeout(run(function () {
        expect(subject, 'to be a number');
    }), 1);

See the promise documentation for more details on how expect.promise works.

The following code snippet creates a promise that is rejected when any promise in the nested structure is rejected. When the returned promise is rejected it create an error report with the details.

var promises = {
  foo: expect('42', 'to be a number after a short delay'),
  bar: expect([0, 1, 2], 'to have items satisfying',
                         expect.it('to be a number after a short delay')),
  baz: expect({ a: '1', b: 2 }, 'to have values satisfying',
                                'to be a number after a short delay')
return expect.promise.all(promises).caught(function () {
  return expect.promise.settle(promises).then(function () {
    expect.fail(function (output) {
      Object.keys(promises).forEach(function (key, index) {
        if (promises[key].isFulfilled()) {
        } else {
          output.error('⨯ ').block(promises[key].reason().getErrorMessage({ output: output }));
expected '42' to be a number after a short delay
expected { a'1'b2 }
to have values satisfying to be a number after a short delay
should be a number after a short delay