https://github.com/palashmon/unique-objects
Get unique objects from an array of objects based on single/multiple keys.
https://github.com/palashmon/unique-objects
array array-item array-of-objects javascript-array json objects tiny-library unique
Last synced: about 2 months ago
JSON representation
Get unique objects from an array of objects based on single/multiple keys.
- Host: GitHub
- URL: https://github.com/palashmon/unique-objects
- Owner: palashmon
- License: mit
- Created: 2018-07-13T15:55:45.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-09-01T03:40:40.000Z (2 months ago)
- Last Synced: 2025-09-01T04:11:28.471Z (2 months ago)
- Topics: array, array-item, array-of-objects, javascript-array, json, objects, tiny-library, unique
- Language: JavaScript
- Homepage:
- Size: 111 KB
- Stars: 11
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# unique-objects 
> Get unique objects from array of objects based on single/multiple keys.
## Install
```
$ npm i unique-objects
```
## Usage
This can be helpful in cases where you need unique records based on a single key or multiple keys.
```js
const uniqueObjects = require('unique-objects');
const users = [
{ id: 1, username: 'bret' },
{ id: 2, username: 'samantha' },
{ id: 2, username: 'samantha' },
{ id: 2, username: 'samantha2' },
{ id: 3, username: 'elvis' },
{ id: 3, username: 'elvis2' },
{ id: 3, username: 'elvis2' }
];
// Get unique objects in the users array based on just id
uniqueObjects(users, ['id']);
//=> Returns just 3 unique objects out of 7
// [
// { "id": 1, "username": "bret"},
// { "id": 2, "username": "samantha2"},
// { "id": 3, "username": "elvis2"},
// ]
// Get unique objects in the users array based on both id & username
uniqueObjects(users, ['id', 'username']);
//=> Returns just 5 unique objects out of 7
// [
// { "id": 1, "username": "bret"},
// { "id": 2, "username": "samantha"},
// { "id": 2, "username": "samantha2"},
// { "id": 3, "username": "elvis"},
// { "id": 3, "username": "elvis2"},
// ]
```
## API
### uniqueObjects(arrayInput, keys)
#### arrayInput
Type: `Array`
Default: `[]`
Must be a JavaScript Array. This is main array of object that we are going to process.
#### keys
Type: `Array`
Default: `[]`
Must be a JavaScript Array. This is the array of key(s) in the object that is used to find object is unique or not.
## License
MIT © [Palash Mondal](https://github.com/palashmon)