Travis build: 1340

README.md

@@ -274,6 +274,8 @@ average(1, 2, 3);
 
 * [`defaults`](#defaults)
 * [`equals`](#equals-)
+* [`findKey`](#findkey)
+* [`findLastKey`](#findlastkey)
 * [`forOwn`](#forown)
 * [`forOwnRight`](#forownright)
 * [`functions`](#functions)
@@ -4240,6 +4242,67 @@ equals({ a: [2, { e: 3 }], b: [4], c: 'foo' }, { a: [2, { e: 3 }], b: [4], c: 'f
 <br>[⬆ Back to top](#table-of-contents)
 
 
+### findKey
+
+Returns the first key that satisfies the provided testing function. Otherwise `undefined` is returned.
+
+Use `Object.keys(obj)` to get all the properties of the object, `Array.find()` to test the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.
+
+```js
+const findKey = (obj, fn) => Object.keys(obj).find(key => fn(obj[key], key, obj));
+```
+
+<details>
+<summary>Examples</summary>
+
+```js
+findKey(
+  {
+    barney: { age: 36, active: true },
+    fred: { age: 40, active: false },
+    pebbles: { age: 1, active: true }
+  },
+  o => o['active']
+); // 'barney'
+```
+
+</details>
+
+<br>[⬆ Back to top](#table-of-contents)
+
+
+### findLastKey
+
+Returns the last key that satisfies the provided testing function. Otherwise `undefined` is returned.
+
+Use `Object.keys(obj)` to get all the properties of the object, `Array.reverse()` to reverse their order and `Array.find()` to test the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.
+
+```js
+const findLastKey = (obj, fn) =>
+  Object.keys(obj)
+    .reverse()
+    .find(key => fn(obj[key], key, obj));
+```
+
+<details>
+<summary>Examples</summary>
+
+```js
+findLastKey(
+  {
+    barney: { age: 36, active: true },
+    fred: { age: 40, active: false },
+    pebbles: { age: 1, active: true }
+  },
+  o => o['active']
+); // 'pebbles'
+```
+
+</details>
+
+<br>[⬆ Back to top](#table-of-contents)
+
+
 ### forOwn
 
 Iterates over all own properties of an object, running a callback for each one.

snippets/findKey.md

@@ -5,10 +5,16 @@ Returns the first key that satisfies the provided testing function. Otherwise `u
 Use `Object.keys(obj)` to get all the properties of the object, `Array.find()` to test the provided function for each key-value pair. The callback receives three arguments - the value, the key and the object.
 
 ```js
-const findKey = (obj, fn) =>
+const findKey = (obj, fn) => Object.keys(obj).find(key => fn(obj[key], key, obj));
-  Object.keys(obj).find(key => fn(obj[key], key, obj));
 ```
 
 ```js
-findKey({barney: { age: 36, active: true }, fred: { age: 40, active: false }, pebbles: { age: 1, active: true }}, o => o['active']); // 'barney'
+findKey(
+  {
+    barney: { age: 36, active: true },
+    fred: { age: 40, active: false },
+    pebbles: { age: 1, active: true }
+  },
+  o => o['active']
+); // 'barney'
 ```

snippets/findLastKey.md

@@ -6,9 +6,18 @@ Use `Object.keys(obj)` to get all the properties of the object, `Array.reverse()
 
 ```js
 const findLastKey = (obj, fn) =>
-  Object.keys(obj).reverse().find(key => fn(obj[key], key, obj));
+  Object.keys(obj)
+    .reverse()
+    .find(key => fn(obj[key], key, obj));
 ```
 
 ```js
-findLastKey({barney: { age: 36, active: true }, fred: { age: 40, active: false }, pebbles: { age: 1, active: true }}, o => o['active']); // 'pebbles'
+findLastKey(
+  {
+    barney: { age: 36, active: true },
+    fred: { age: 40, active: false },
+    pebbles: { age: 1, active: true }
+  },
+  o => o['active']
+); // 'pebbles'
 ```