https://github.com/jonkemp/find-where
Iterates over a collection of values and returns the first value that matches all of the key-value pairs provided
https://github.com/jonkemp/find-where
array find findwhere util utility
Last synced: 3 months ago
JSON representation
Iterates over a collection of values and returns the first value that matches all of the key-value pairs provided
- Host: GitHub
- URL: https://github.com/jonkemp/find-where
- Owner: jonkemp
- License: mit
- Created: 2020-02-15T14:05:54.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-02-06T01:42:22.000Z (5 months ago)
- Last Synced: 2025-04-28T15:08:48.108Z (3 months ago)
- Topics: array, find, findwhere, util, utility
- Language: JavaScript
- Size: 255 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# find-where 
> Iterates over a collection of values and returns the first value that matches all of the key-value pairs provided.
If no match is found, or if the collection is empty, `undefined` will be returned.
Inspired by `_.findWhere`. 😄
## Install
Install with [npm](https://npmjs.org/package/find-where)
```
$ npm install find-where
```
Or [unpkg](https://unpkg.com/find-where/)
```
```
Check out the unit tests on [CodePen](https://codepen.io/jonkemp/full/rNVeVKE).
## Usage
```js
const findWhere = require('find-where');
const users = [
{ 'user': 'barney', 'age': 36, 'active': true },
{ 'user': 'fred', 'age': 40, 'active': false },
{ 'user': 'pebbles', 'age': 1, 'active': true }
];
findWhere(users, { 'age': 1 });
//=> { 'user': 'pebbles', 'age': 1, 'active': true }
findWhere(users, { 'user': 'barney' });
//=> { 'user': 'barney', 'age': 36, 'active': true }
findWhere(users, { 'age': 36, 'active': true });
//=> { 'user': 'barney', 'age': 36, 'active': true }
```
---
| **Like us a lot?** Help others know why you like us! **Review this package on [pkgreview.dev](https://pkgreview.dev/npm/find-where)** | âž¡ | [](https://pkgreview.dev/npm/find-where) |
| ----------------------------------------------------------------------------------------------------------------------------------------- | --- | --------------------------------------------------------------------------------------------------------------------- |
## API
### findWhere(collection, properties)
#### collection
Type: `array`
Default: `none`
The array to iterate over.
#### properties
Type: `object`
Default: `none`
The key-value pairs to match.
## License
MIT