filter-anything

Filter anything ⚔️

npm i filter-anything

Filter out object props based on "fillables" and "guard". A simple & small integration.

Motivation

I created this package because I needed:

• be able to filter out object props based on just what we need - aka "fillables"
• be able to filter out object props based on what we don't need - aka "guarded" props
• supports for nested properties
• supports wildcards * for nested properties

Meet the family

• filter-anything ⚔️
• merge-anything 🥡
• find-and-replace-anything 🎣
• compare-anything 🛰
• copy-anything 🎭
• flatten-anything 🏏
• is-what 🙉

Usage

Fillable

With fillable pass an array of keys of an object - the props which may stay.

import { fillable } from 'filter-anything'

const squirtle = { id: '007', name: 'Squirtle', type: 'water' }

const withoutId = fillable(squirtle, ['name', 'type'])
// returns { name: 'Squirtle', type: 'water' }

Guard

With guard pass an array of keys of an object - the props which should be removed.

import { guard } from 'filter-anything'

const squirtle = { id: '007', name: 'Squirtle', type: 'water' }

const withoutId = guard(squirtle, ['name', 'type'])
// returns { name: 'Squirtle', type: 'water' }

TypeScript

TypeScript users will love this, because, as you can see, the result has the correct type automatically!

Nested props

In the example below we want to get rid of the nested property called "discard".

const doc = { items: { keep: '📌', discard: '✂️' } }

fillable(doc, ['items.keep'])
// returns {items: {keep: '📌'}}

guard(doc, ['items.discard'])
// returns {items: {keep: '📌'}}

Please note that TypeScript users will need to cast the result when using nested props.

Wildcards

Yes! You can also work with wildcards by using * in the path.

const doc = {
  '123': { keep: '📌', discard: '✂️' },
  '456': { keep: '📌', discard: '✂️' },
}
// use wildcard *
guard(doc, ['*.discard'])
// returns {
//   '123': {keep: '📌'},
//   '456': {keep: '📌'}
// }

Please note that TypeScript users will need to cast the result when using wildcards props.

Feel free to open issues for any requests, questions or bugs!