mesqueeb / path-to-prop

Retrieves a property from an object based on a path.to.that.prop

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Path to prop 🛤

Total Downloads Latest Stable Version

npm i path-to-prop

Retrieves a property from an object based on a 'path/to.that.prop'

  • Supports paths with both / and . to separate props
  • Safely typed (with TypeScript) - returns unknown

Usage

import { getProp } from 'path-to-prop'

getProp({ nested: { prop: 1 } }, 'nested.prop') // 1

getProp({ nested: { prop: 1 } }, 'nested') // { prop: 1 }

You can use / or . to access nested props:

const obj = {a: {b: {c: {d: {e: 1}}}}}
const path = 'a/b/c.d.e'

getProp(obj, path)
  // returns 1

getProp(obj, 'nonexistent.prop')
  // returns undefined

When you have / or . in your prop names, use an array:

const obj = {'a/b': {'c.d': 1}}

getProp(obj, ['a/b', 'c.d'])
  // returns 1

About

Retrieves a property from an object based on a path.to.that.prop

License:MIT License


Languages

Language:TypeScript 92.5%Language:JavaScript 7.5%