match-key

1.1.0 • Public • Published

match-key NPM version

Get a property from an object with the first key that matches the given glob pattern, function, regex or string.

This returns one property. If you want to filter an object use [filter-object].

Install with npm

$ npm i match-key --save

Usage

var matchKey = require('match-key');
matchKey(object, pattern, options);

Params:

  • object: The object to search
  • pattern: The pattern to match against. This may be string, function, glob pattern, or regex.
  • options: options to pass to micromatch

Valid patterns

String:

matchKey({a: 'b', c: 'd'}, 'a');
//=> {a: 'b'}

Function:

matchKey({a: 'b', c: 'd'}, function (key) {
  return key === 'a'
});
//=> {'a': 'b'}

Glob pattern:

matchKey(o, '*');
//=> {a: 'b'}
 
matchKey(o, '*c');
//=> {c: 'd'}

Regular expression:

matchKey({a: 'b', aa: 'bb'}, /\w{2}/);
//=> {aa: 'bb'}

Related

  • has-glob: Returns true if an array has a glob pattern. | homepage
  • is-glob: Returns true if the given string looks like a glob pattern. | homepage
  • is-match: Create a matching function from a glob pattern, regex, string, array, object or function. | homepage
  • micromatch: Glob matching for javascript/node.js. A drop-in replacement and faster alternative to minimatch and multimatch. Just… more | homepage

Running tests

Install dev dependencies:

$ npm i -d && npm test

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Author

Jon Schlinkert

License

Copyright © 2015 Jon Schlinkert Released under the MIT license.


This file was generated by verb-cli on September 08, 2015.

Package Sidebar

Install

npm i match-key

Weekly Downloads

0

Version

1.1.0

License

MIT

Last publish

Collaborators

  • doowb
  • jonschlinkert