Get unique primitive values from an array.
- ✨ Benefits
- 🎒 Requierments
- 🚀 Quickstart
- 📘 Documentation
- 🆘 Troubleshooting
- 🤝 Contributing
- 🧪 Testing
- ⚖️ License
- Immutable
- Works with numbers
- Works with strings
- Works with booleans
- Works with symbols
- Works with null
- Works with undefined
No requierments, just install or grab from the CDN.
Install using the terminal:
npm install @danielcobo/getunique
Require the module:
const getunique = require('@danielcobo/getunique');
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.
Declare it as a global variable named getunique by including this script before any script you want to use it in:
<script src="https://cdn.jsdelivr.net/npm/@danielcobo/getunique@1/dist/iife/getunique.min.js"></script>
Or import it as an ECMAScript module:
import * as getunique from 'https://cdn.jsdelivr.net/npm/@danielcobo/getunique@1/dist/esm/getunique.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.
const arr = getUnique(['one', 'two', 'two', 'three']); //'one', 'two', 'three'
For details see documentation below.
Filter array for unqiue primitive data values
Name | Type | Default | Description |
---|---|---|---|
arr | array |
Array of JS primitives (see https://developer.mozilla.org/en-US/docs/Glossary/Primitive) |
Type | Description |
---|---|
array |
Array of unique values |
Source: src/index.js:1
If you run into trouble or have questions just submit an issue.
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..)
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 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).