.verb.md
# function-arguments [![npm version][npmv-img]][npmv-url] [![github release][github-release-img]][github-release-url] [![License][license-img]][license-url]
> Get arguments of a function, useful for and used in dependency injectors. Works for regular functions, generator functions and arrow functions.
[![code style][standard-img]][standard-url]
[![linux build][travis-img]][travis-url]
[![code coverage][coverage-img]][coverage-url]
[![dependency status][david-img]][david-url]
[![npm downloads][downloads-img]][downloads-url]
[![paypal donate][paypalme-img]][paypalme-url]
## Install
> Install with [npm](https://www.npmjs.com/)
```
$ npm i function-arguments --save
```
_**Important:** for more advanced stuff please use [parse-function][], don't suggest features or complex bugs._
## Usage
> For more use-cases see the [tests](./test.js)
```js
const functionArguments = require('function-arguments')
```
## API
### [functionArguments](index.js#L33)
> Get function arguments names.
**Params**
* `fn` **{Function}**: Function from which to get arguments names.
* `returns` **{Array}**
**Example**
```js
var fnArgs = require('function-arguments')
console.log(fnArgs(function (a, b, c) {})) // => [ 'a', 'b', 'c' ]
console.log(fnArgs(function named (a , b, c) {})) // => [ 'a', 'b', 'c' ]
console.log(fnArgs(a => {})) // => [ 'a' ]
console.log(fnArgs((a, b) => {})) // => [ 'a', 'b' ]
console.log(fnArgs(function * (a ,b, c) {})) // => [ 'a', 'b', 'c' ]
console.log(fnArgs(function * named (a ,b, c) {})) // => [ 'a', 'b', 'c' ]
```
### Works when using comments
> As it works for ES2015, it also works if you use comments in weird places.
```js
console.log(fnArgs(function /* something may */ (
// go,
go,
/* wrong, */
here
// (when, using, comments) {}
) { return 1 })) // => [ 'go', 'here' ]
```
## Related
- [flatten-arguments](https://www.npmjs.com/package/flatten-arguments): Fastest, simplest and smallest. Pass `arguments` object or list of… [more](https://github.com/tunnckocore/flatten-arguments#readme) | [homepage](https://github.com/tunnckocore/flatten-arguments#readme "Fastest, simplest and smallest. Pass `arguments` object or list of arguments and get flattened array.")
- [fn-args](https://www.npmjs.com/package/fn-args): Get the arguments of a function | [homepage](https://github.com/sindresorhus/fn-args "Get the arguments of a function")
- [fn-name](https://www.npmjs.com/package/fn-name): Get the name of a named function | [homepage](https://github.com/sindresorhus/fn-name "Get the name of a named function")
- [get-fn-name](https://www.npmjs.com/package/get-fn-name): Get function name with strictness and correctness in mind. Also… [more](https://github.com/tunnckocore/get-fn-name#readme) | [homepage](https://github.com/tunnckocore/get-fn-name#readme "Get function name with strictness and correctness in mind. Also works for arrow functions and getting correct name of bounded functions. Powered by [fn-name][].")
- [handle-arguments](https://www.npmjs.com/package/handle-arguments): Get separately non-callback arguments in `.arguments` and the last argument… [more](https://github.com/hybridables/handle-arguments#readme) | [homepage](https://github.com/hybridables/handle-arguments#readme "Get separately non-callback arguments in `.arguments` and the last argument if it [is-callback-function][] in `.callback`. It also works like [sliced][], but returns object with `.arguments` and `.callback` properties.")
- [manage-arguments](https://www.npmjs.com/package/manage-arguments): Prevents arguments leakage - managing arguments. From Optimization killers by… [more](https://github.com/tunnckocore/manage-arguments#readme) | [homepage](https://github.com/tunnckocore/manage-arguments#readme "Prevents arguments leakage - managing arguments. From Optimization killers by Petka Antonov.")
- [parse-function](https://www.npmjs.com/package/parse-function): Parse a function, arrow function or string to object with… [more](https://github.com/tunnckocore/parse-function#readme) | [homepage](https://github.com/tunnckocore/parse-function#readme "Parse a function, arrow function or string to object with name, args, params and body properties.")
## Contributing
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/tunnckoCore/function-arguments/issues/new).
But before doing anything, please read the [CONTRIBUTING.md](./CONTRIBUTING.md) guidelines.
## [Charlike Make Reagent](http://j.mp/1stW47C) [![new message to charlike][new-message-img]][new-message-url] [![freenode #charlike][freenode-img]][freenode-url]
[![tunnckoCore.tk][author-www-img]][author-www-url] [![keybase tunnckoCore][keybase-img]][keybase-url] [![tunnckoCore npm][author-npm-img]][author-npm-url] [![tunnckoCore twitter][author-twitter-img]][author-twitter-url] [![tunnckoCore github][author-github-img]][author-github-url]
[fn-name]: https://github.com/sindresorhus/fn-name
[is-callback-function]: https://github.com/tunnckocore/is-callback-function
[sliced]: https://github.com/aheckmann/sliced
[downloads-url]: https://www.npmjs.com/package/function-arguments
[downloads-img]: https://img.shields.io/npm/dm/function-arguments.svg
[travis-url]: https://travis-ci.org/tunnckoCore/function-arguments
[travis-img]: https://img.shields.io/travis/tunnckoCore/function-arguments/master.svg
[coverage-url]: https://coveralls.io/r/tunnckoCore/function-arguments
[coverage-img]: https://img.shields.io/coveralls/tunnckoCore/function-arguments.svg
[david-url]: https://david-dm.org/tunnckoCore/function-arguments
[david-img]: https://img.shields.io/david/tunnckoCore/function-arguments.svg
[standard-url]: https://github.com/feross/standard
[standard-img]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg
[author-www-url]: http://www.tunnckocore.tk
[author-www-img]: https://img.shields.io/badge/www-tunnckocore.tk-fe7d37.svg
[keybase-url]: https://keybase.io/tunnckocore
[keybase-img]: https://img.shields.io/badge/keybase-tunnckocore-8a7967.svg
[author-npm-url]: https://www.npmjs.com/~tunnckocore
[author-npm-img]: https://img.shields.io/badge/npm-~tunnckocore-cb3837.svg
[author-twitter-url]: https://twitter.com/tunnckoCore
[author-twitter-img]: https://img.shields.io/badge/twitter-@tunnckoCore-55acee.svg
[author-github-url]: https://github.com/tunnckoCore
[author-github-img]: https://img.shields.io/badge/github-@tunnckoCore-4183c4.svg
[freenode-url]: http://webchat.freenode.net/?channels=charlike
[freenode-img]: https://img.shields.io/badge/freenode-%23charlike-5654a4.svg
[new-message-url]: https://github.com/tunnckoCore/ama
[new-message-img]: https://img.shields.io/badge/ask%20me-anything-green.svg
<!-- -->
[paypalme-url]: https://ko-fi.com/tunnckoCore
[paypalme-img]: https://img.shields.io/badge/support-donate-brightgreen.svg
[npmv-url]: https://www.npmjs.com/package/function-arguments
[npmv-img]: https://img.shields.io/npm/v/function-arguments.svg?label=npm%20version
[github-release-url]: https://github.com/tunnckoCore/function-arguments/releases/latest
[github-release-img]: https://img.shields.io/github/tag/tunnckoCore/function-arguments.svg?label=github%20tag
[license-url]: https://github.com/tunnckoCore/function-arguments/blob/master/LICENSE
[license-img]: https://img.shields.io/badge/license-MIT-blue.svg