handle-arguments

Handles given Arguments object - return separatly last argument (commonly callback) and other arguments as Array. Useful in node-style callback flow. Used by hybridify

Install

npm i handle-arguments --save

Features

• prevents arguments leakage (Optimization killers by @petkaantonov)
• support node lists in IE < 9 and ensure dense arrays are returned

API

For more use-cases see the tests

handleArguments

• <argsObject> {Arguments} the arguments object
• return {Object}
  • callback {Function} last argument if function or undefined
  • cb {Function} alias of callback
  • arguments {Array} all arguments without last (the callback)
  • args {Array} alias of arguments

Example:

var handleArguments = require('handle-arguments')

function fixture () {
  return handleArguments(arguments)
}

console.log(fixture(1, 2, 3))
//=> {callback: undefined, cb: undefined
// arguments: [1, 2, 3], args: [1, 2, 3]}

console.log(fixture(1, 2, function _callback_ () {}))
//=> {callback: [Function: _callback_], cb: [Function: _callback_],
// arguments: [1, 2], args: [1, 2]}

instead of commonly used pattern

function fixture () {
  var args = [].slice.call(arguments)
  var len = args.length
  var callback = args[len - 1]

  if (typeof callback === 'function') {
    args = args.slice(0, -1)
    callback.apply(null, [null].concat(args))
  }
  return args
}

Related

• async-exec-cmd: Simple, fast, flexible and cross-platform async executing commands (with node-cross-spawn).
• bluebird: Full featured Promises/A+ implementation with exceptionally good performance
• hybridify: Building hybrid APIs. You can use both callback and promise in same time. Like… more
• handle-callback: Initial step for creating hybrid APIs, used by hybridify. Handle callback in promise - give… more
• manage-arguments: Prevents arguments leakage - managing arguments. From Optimization killers by Petka Antonov. Powers handle-arguments
• Optimization killers by @petkaantonov

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
But before doing anything, please read the CONTRIBUTING.md guidelines.

Charlike Make Reagent