Security News
ESLint is Now Language-Agnostic: Linting JSON, Markdown, and Beyond
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
filter-where
Advanced tools
Filter an array using any combination of scalars, object queries, functions or regular expressions.
Filter an array using any combination of scalars, object queries, functions or regular expressions.
function
⏏Kind: Exported function
Param | Type | Description |
---|---|---|
query | any | Array.<any> | one or more queries |
Example Say you have a recordset:
> data = [
{ name: 'Dana', age: 30 },
{ name: 'Yana', age: 20 },
{ name: 'Zhana', age: 10 }
]
You can return records with properties matching an exact value:
> data.filter(where({ age: 10 }))
[ { name: 'Zhana', age: 10 } ]
or where NOT the value (prefix the property name with !
)
> data.filter(where({ '!age': 10 }))
[ { name: 'Dana', age: 30 }, { name: 'Yana', age: 20 } ]
match using a function:
> function over10(age){ return age > 10; }
> data.filter(where({ age: over10 }))
[ { name: 'Dana', age: 30 }, { name: 'Yana', age: 20 } ]
match using a regular expression
> data.filter(where({ name: /ana/ }))
[ { name: 'Dana', age: 30 },
{ name: 'Yana', age: 20 },
{ name: 'Zhana', age: 10 } ]
You can query to any arbitrary depth. So with deeper data, like this:
> deepData = [
{ name: 'Dana', favourite: { colour: 'light red' } },
{ name: 'Yana', favourite: { colour: 'dark red' } },
{ name: 'Zhana', favourite: { colour: [ 'white', 'red' ] } }
]
get records with favourite.colour
values matching /red/
> deepData.filter(where({ favourite: { colour: /red/ } }))
[ { name: 'Dana', favourite: { colour: 'light red' } },
{ name: 'Yana', favourite: { colour: 'dark red' } } ]
if the value you're looking for maybe part of an array, prefix the property name with +
. Now Zhana is included:
> deepData.filter(where({ favourite: { '+colour': /red/ } }))
[ { name: 'Dana', favourite: { colour: 'light red' } },
{ name: 'Yana', favourite: { colour: 'dark red' } },
{ name: 'Zhana', favourite: { colour: [ 'white', 'red' ] } } ]
you can combine any of the above by supplying an array of queries. Records will be returned if any of the queries match:
> var nameBeginsWithY = { name: /^Y/ }
> var faveColourIncludesWhite = { favourite: { '+colour': 'white' } }
> deepData.filter(where([ nameBeginsWithY, faveColourIncludesWhite ]))
[ { name: 'Yana', favourite: { colour: 'dark red' } },
{ name: 'Zhana', favourite: { colour: [ 'white', 'red' ] } } ]
© 2016 Lloyd Brookes 75pound@gmail.com. Documented by jsdoc-to-markdown.
FAQs
Filter an array using any combination of scalars, object queries, functions or regular expressions.
The npm package filter-where receives a total of 492 weekly downloads. As such, filter-where popularity was classified as not popular.
We found that filter-where demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
ESLint has added JSON and Markdown linting support with new officially-supported plugins, expanding its versatility beyond JavaScript.
Security News
Members Hub is conducting large-scale campaigns to artificially boost Discord server metrics, undermining community trust and platform integrity.
Security News
NIST has failed to meet its self-imposed deadline of clearing the NVD's backlog by the end of the fiscal year. Meanwhile, CVE's awaiting analysis have increased by 33% since June.