Skip to content

Get a property from an object using dot path or Regexp

License

Notifications You must be signed in to change notification settings

trashify/obj-search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔎 obj-search

Get a property from an object using dot path or Regexp.


Built with ❤︎ by Tiaan du Plessis

Table of Contents

Table of Contents
  • Install
  • Usage
  • OSS
  • Contribute
  • License
  • Install

    Install with npm

    $ npm install --save obj-search

    Install with yarn

    $ yarn add obj-search

    Usage

    To use, require/import the module and call the function in the format:

    objSearch(objectToSearch, patternToLookFor, optionalDefaultValue)

    An example of usage:

    const objSearch = require('obj-search')
    const nestedObject = {
      foo: {
        bar: {
          baz: 'Hai',
          foo: 'Hi'
        }
      },
      foos: [
        1,
        2,
        3
      ]
    }
    
    console.log(objSearch(nestedObject, 'foo.bar')) // { baz: 'Hai', foo: 'Hi' }
    console.log(objSearch(nestedObject, 'foo.bar.baz')) // 'Hai'
    console.log(objSearch(nestedObject, /foo/)) // [ { bar: { baz: 'Hai', foo: 'Hi' } }, 'Hi', [ 1, 2, 3 ] ]

    OSS

    obj-search is made possible through Open Source Software. A very special thanks to all the modules used.

    Contributing

    All Contributions are welcome! Please open up an issue if you would like to help out. 😄

    License

    Licensed under the MIT License.