Skip to main content

dropWhile

_.dropWhile(predicate, array) # Ⓢ [Ⓣ][1] Ⓝ

Creates a slice of array excluding elements dropped from the beginning.



Elements are dropped until predicate returns falsey. The predicate is



invoked with three arguments: (value, index, array).

Since​

3.0.0

Arguments​

  1. predicate (Function): The function invoked per iteration.
  2. array (Array): The array to query.

Returns​

(Array): Returns the slice of array.

Example​

var users = [
  { 'user': 'barney',  'active': false },
  { 'user': 'fred',    'active': false },
  { 'user': 'pebbles', 'active': true }
];

_.dropWhile(function(o) { return !o.active; }, users);
// => objects for ['pebbles']

// The `_.matches` iteratee shorthand.
_.dropWhile({ 'user': 'barney', 'active': false }, users);
// => objects for ['fred', 'pebbles']

// The `_.matchesProperty` iteratee shorthand.
_.dropWhile(['active', false], users);
// => objects for ['pebbles']

// The `_.property` iteratee shorthand.
_.dropWhile('active', users);
// => objects for ['barney', 'fred', 'pebbles']