Skip to content

danielcobo/getparameters

Repository files navigation

getparameters

Get JS function parameters

🧭 Table of contents

✨ Benefits

  • Works with arrow functions
  • Works with parameters with default values
  • Works with edge cases like comments within function definition

🎒 Requierments

No requierments or dependencies.

🚀 Quickstart

Install

NodeJS

Install using the terminal:

npm install getparameters

Require the module:

const getparameters = require('getparameters');

Note: In case you're wondering, @danielcobo/ is just a namespace scope - an NPM feature. Scopes make it easier to name modules and improve security.

Browser

Declare it as a global variable named getparameters by including this script before any script you want to use it in:

<script src="https://cdn.jsdelivr.net/npm/getparameters@1/dist/iife/getparameters.min.js"></script>

Or import it as an ECMAScript module:

import * as getparameters from 'https://cdn.jsdelivr.net/npm/getparameters@1/dist/esm/getparameters.min.js';

Also, feel free to download the file if you prefer not to use jsdelivr. In that case just replace the url with the relative file path.

Example use

  const func1 = function (a, b) {
    return a+b
  };
  getParameters(func1)) //['a', 'b'])

  const func2 = function (a = true, b) {
    return a||b
  };
  getParameters(func2)) //['a=true', 'b']

For details see documentation below.

📘 Documentation

getparameters()

Get function parameter names (and their defualt values, if any)

Name Type Default Description
func function Function to get parameter names from

Returns

Type Description
Array.string Parameters

Source: src/index.js:1

🆘 Troubleshooting

If you run into trouble or have questions just submit an issue.

🤝 Contributing

Anyone can contribute

Contributions come in many shapes and sizes. All are welcome. You can contribute by:

  • asking questions
  • suggesting features
  • sharing this repo with friends
  • improving documentation (even fixing typos counts 😉)
  • providing tutorials (if you do, please let me know, I would love to read them)
  • improving tests
  • contributing code (new features, performance boosts, code readability improvements..)

Rules for contributions

General guidelines:

  • there are no dumb questions
  • be polite and respectful to others
  • do good

When coding remember:

  • working > maintainability > performance
  • best code is no code
  • be descriptive when naming
  • keep it DRY
  • do test

Contribution licence: All contributions are considered to be under same license as this repository.

🧪 Testing

Testing suite: 🃏 Jest | Test command: npm test

Mutation testing suite: 👽 Stryker Mutator | Mutation test command: npm run mutation

If you intend to develop further or contribute code, then please ensure to write and use testing. Strive for 100% code coverage and high mutation scores. Mutation score 100 is great, but it's not always neccessary (if there are valid reasons).

⚖️ License

MIT License

About

Get function parameters

Resources

License

Unknown, Unknown licenses found

Licenses found

Unknown
LICENSE.md
Unknown
LICENSE.hbs

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published