{"id":18470368,"url":"https://github.com/aliencreations/alien-node-q-utils","last_synced_at":"2025-10-25T02:36:17.306Z","repository":{"id":35275186,"uuid":"39535979","full_name":"AlienCreations/alien-node-q-utils","owner":"AlienCreations","description":"Helper functions for Q on NodeJS","archived":false,"fork":false,"pushed_at":"2023-09-13T21:23:57.000Z","size":26,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-09T00:12:53.054Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlienCreations.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-07-22T23:55:39.000Z","updated_at":"2023-09-13T15:02:49.000Z","dependencies_parsed_at":"2024-11-06T10:13:47.995Z","dependency_job_id":"5b89b8fc-6637-49de-922c-81d5cc15f18d","html_url":"https://github.com/AlienCreations/alien-node-q-utils","commit_stats":{"total_commits":10,"total_committers":1,"mean_commits":10.0,"dds":0.0,"last_synced_commit":"dd1acfba5e2de94a59911d719aad4316d756caec"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlienCreations%2Falien-node-q-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlienCreations%2Falien-node-q-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlienCreations%2Falien-node-q-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlienCreations%2Falien-node-q-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlienCreations","download_url":"https://codeload.github.com/AlienCreations/alien-node-q-utils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253166523,"owners_count":21864482,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T10:13:44.273Z","updated_at":"2025-10-25T02:36:17.202Z","avatar_url":"https://github.com/AlienCreations.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# alien-node-q-utils\nHelper functions for promises with Q on NodeJS. The functions are pure and curried with Ramda.\n\n[![Build Status](https://travis-ci.org/AlienCreations/alien-node-q-utils.svg?branch=master)](https://travis-ci.org/AlienCreations/alien-node-q-utils) [![Coverage Status](https://coveralls.io/repos/AlienCreations/alien-node-q-utils/badge.svg?branch=master\u0026service=github)](https://coveralls.io/github/AlienCreations/alien-node-q-utils?branch=master) [![npm version](http://img.shields.io/npm/v/alien-node-q-utils.svg)](https://npmjs.org/package/alien-node-q-utils) [![Dependency Status](https://david-dm.org/AlienCreations/alien-node-q-utils.svg)](https://david-dm.org/AlienCreations/alien-node-q-utils)\n\n## Install\n\n```\n$ npm install alien-node-q-utils --save\n```\n\nRun the specs\n\n```\n$ npm test\n```\n## Methods\n#### rejectedPromise\nA pre-rejected promise that throws the rejection into an expected `catch` block.\n\n```js\n  it('should pre-reject a promise', function(done) {\n    rejectedPromise('foo')\n      .catch(function(err) {\n        expect(err).toBe('foo');\n        done();\n      })\n  });\n```\n\n#### resolvedPromise\nA pre-resolved promise that passes the resolution into the expected `then` block.\n\n```js\n  it('should pre-resolve a promise', function(done) {\n    resolvedPromise('foo')\n      .then(function(data) {\n        expect(data).toBe('foo');\n        done();\n      })\n  });\n```\n\n#### rejectOnErrorOrResolve\nGiven a function signature of `fn(deferred, err, data)` this will reject `deferred` if `err` is provided, \notherwise resolve `deferred` with `data`. \n - Don't forget this function is curried, so the arity must be recognized. (If you omit the `data` param, you will get a function that accepts only the `data` param.)\n\n```js\n\n  var mockPromiseNoError = function(resolveWith) {\n    var deferred = Q.defer();\n    rejectOnErrorOrResolve(deferred, undefined, resolveWith);\n    return deferred.promise;\n  };\n  \n  var mockPromiseWithError = function(err) {\n    var deferred = Q.defer();\n    rejectOnErrorOrResolve(deferred, err, undefined);\n    return deferred.promise;\n  };\n\n  it('should resolve if no error is provided', function(done) {\n    var deferred = Q.defer();\n    mockPromiseNoError('foo')\n      .then(function(data) {\n        expect(data).toBe('foo');\n        done();\n      });\n  });\n  \n  it('should reject if error is provided', function(done) {\n    var deferred = Q.defer();\n    mockPromiseWithError('foo')\n      .catch(function(err) {\n        expect(err).toBe('foo');\n        done();\n      });\n  });\n```\n\n## TODO \n - Need specs and descriptions for new mapP methods\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliencreations%2Falien-node-q-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliencreations%2Falien-node-q-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliencreations%2Falien-node-q-utils/lists"}