reflect.js 2.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980
  1. 'use strict';
  2. Object.defineProperty(exports, "__esModule", {
  3. value: true
  4. });
  5. exports.default = reflect;
  6. var _initialParams = require('./internal/initialParams');
  7. var _initialParams2 = _interopRequireDefault(_initialParams);
  8. var _rest = require('./internal/rest');
  9. var _rest2 = _interopRequireDefault(_rest);
  10. function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
  11. /**
  12. * Wraps the function in another function that always returns data even when it
  13. * errors.
  14. *
  15. * The object returned has either the property `error` or `value`.
  16. *
  17. * @name reflect
  18. * @static
  19. * @memberOf module:Utils
  20. * @method
  21. * @category Util
  22. * @param {Function} fn - The function you want to wrap
  23. * @returns {Function} - A function that always passes null to it's callback as
  24. * the error. The second argument to the callback will be an `object` with
  25. * either an `error` or a `value` property.
  26. * @example
  27. *
  28. * async.parallel([
  29. * async.reflect(function(callback) {
  30. * // do some stuff ...
  31. * callback(null, 'one');
  32. * }),
  33. * async.reflect(function(callback) {
  34. * // do some more stuff but error ...
  35. * callback('bad stuff happened');
  36. * }),
  37. * async.reflect(function(callback) {
  38. * // do some more stuff ...
  39. * callback(null, 'two');
  40. * })
  41. * ],
  42. * // optional callback
  43. * function(err, results) {
  44. * // values
  45. * // results[0].value = 'one'
  46. * // results[1].error = 'bad stuff happened'
  47. * // results[2].value = 'two'
  48. * });
  49. */
  50. function reflect(fn) {
  51. return (0, _initialParams2.default)(function reflectOn(args, reflectCallback) {
  52. args.push((0, _rest2.default)(function callback(err, cbArgs) {
  53. if (err) {
  54. reflectCallback(null, {
  55. error: err
  56. });
  57. } else {
  58. var value = null;
  59. if (cbArgs.length === 1) {
  60. value = cbArgs[0];
  61. } else if (cbArgs.length > 1) {
  62. value = cbArgs;
  63. }
  64. reflectCallback(null, {
  65. value: value
  66. });
  67. }
  68. }));
  69. return fn.apply(this, args);
  70. });
  71. }
  72. module.exports = exports['default'];