diff --git a/README.md b/README.md index 4e745e089d..1d27926035 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# lodash v3.0.0 +# lodash v3.0.1 The [modern build](https://github.com/lodash/lodash/wiki/Build-Differences) of [lodash](https://lodash.com/) with packages for [Bower](http://bower.io/), [Component](http://component.github.io/), & [Volo](http://volojs.org/). @@ -12,8 +12,8 @@ $ lodash modern -o ./lodash.js lodash is also available in a variety of other builds & module formats. * npm packages for [modern](https://www.npmjs.com/package/lodash), [compatibility](https://www.npmjs.com/package/lodash-compat), & [per method](https://www.npmjs.com/browse/keyword/lodash-modularized) builds - * AMD modules for [modern](https://github.com/lodash/lodash/tree/3.0.0-amd) & [compatibility](https://github.com/lodash/lodash-compat/tree/3.0.0-amd) builds - * ES modules for the [modern](https://github.com/lodash/lodash/tree/3.0.0-es) build + * AMD modules for [modern](https://github.com/lodash/lodash/tree/3.0.1-amd) & [compatibility](https://github.com/lodash/lodash-compat/tree/3.0.1-amd) builds + * ES modules for the [modern](https://github.com/lodash/lodash/tree/3.0.1-es) build ## Further Reading diff --git a/bower.json b/bower.json index 4d4c03dc1f..511afe435a 100644 --- a/bower.json +++ b/bower.json @@ -1,6 +1,6 @@ { "name": "lodash", - "version": "3.0.0", + "version": "3.0.1", "main": "lodash.js", "ignore": [ ".*", diff --git a/component.json b/component.json index d0a294d924..79f3606746 100644 --- a/component.json +++ b/component.json @@ -1,7 +1,7 @@ { "name": "lodash", "repo": "lodash/lodash", - "version": "3.0.0", + "version": "3.0.1", "description": "The modern build of lodash.", "license": "MIT", "main": "lodash.js", diff --git a/doc/README.md b/doc/README.md index 65ed048c32..c13ab2a51a 100644 --- a/doc/README.md +++ b/doc/README.md @@ -1,10 +1,10 @@ -# lodash v3.0.0 +# lodash v3.0.1 -## `Array` +## `Array` * `_.chunk` * `_.compact` * `_.difference` @@ -49,7 +49,7 @@ -## `Chain` +## `Chain` * `_` * `_.chain` * `_.tap` @@ -65,7 +65,7 @@ -## `Collection` +## `Collection` * `_.all` -> `every` * `_.any` -> `some` * `_.at` @@ -111,14 +111,14 @@ -## `Date` +## `Date` * `_.now` -## `Function` +## `Function` * `_.after` * `_.ary` * `_.backflow` -> `flowRight` @@ -147,7 +147,7 @@ -## `Lang` +## `Lang` * `_.clone` * `_.cloneDeep` * `_.isArguments` @@ -178,14 +178,14 @@ -## `Number` +## `Number` * `_.random` -## `Object` +## `Object` * `_.assign` * `_.create` * `_.defaults` @@ -216,7 +216,7 @@ -## `String` +## `String` * `_.camelCase` * `_.capitalize` * `_.deburr` @@ -243,7 +243,7 @@ -## `Utility` +## `Utility` * `_.attempt` * `_.callback` * `_.constant` @@ -264,14 +264,14 @@ -## `Methods` +## `Methods` * `_.templateSettings.imports._` -## `Properties` +## `Properties` * `_.VERSION` * `_.support` * `_.support.argsTag` @@ -305,7 +305,7 @@ ### `_.chunk(array, [size=1])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4096 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4103 "View in source") [Ⓣ][1] Creates an array of elements split into groups the length of `size`. If `collection` can't be split evenly, the final chunk will be the remaining @@ -333,7 +333,7 @@ _.chunk(['a', 'b', 'c', 'd'], 3); ### `_.compact(array)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4127 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4134 "View in source") [Ⓣ][1] Creates an array with all falsey values removed. The values `false`, `null`, `0`, `""`, `undefined`, and `NaN` are falsey. @@ -356,11 +356,13 @@ _.compact([0, 1, false, 2, '', 3]); ### `_.difference(array, [values])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4162 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4169 "View in source") [Ⓣ][1] Creates an array excluding all values of the provided arrays using `SameValueZero` for equality comparisons. - *Note:** `SameValueZero` comparisons are like strict equality comparisons, +
+
+**Note:** `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -384,7 +386,7 @@ _.difference([1, 2, 3], [5, 2, 10]); ### `_.drop(array, [n=1])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4200 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4207 "View in source") [Ⓣ][1] Creates a slice of `array` with `n` elements dropped from the beginning. @@ -416,7 +418,7 @@ _.drop([1, 2, 3], 0); ### `_.dropRight(array, [n=1])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4236 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4243 "View in source") [Ⓣ][1] Creates a slice of `array` with `n` elements dropped from the end. @@ -448,15 +450,17 @@ _.dropRight([1, 2, 3], 0); ### `_.dropRightWhile(array, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4288 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4295 "View in source") [Ⓣ][1] Creates a slice of `array` excluding elements dropped from the end. Elements are dropped until `predicate` returns falsey. The predicate is bound to `thisArg` and invoked with three arguments; (value, index, array). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -495,15 +499,17 @@ _.pluck(_.dropRightWhile(users, { 'status': 'away' }), 'user'); ### `_.dropWhile(array, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4338 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4345 "View in source") [Ⓣ][1] Creates a slice of `array` excluding elements dropped from the beginning. Elements are dropped until `predicate` returns falsey. The predicate is bound to `thisArg` and invoked with three arguments; (value, index, array). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -542,14 +548,16 @@ _.pluck(_.dropWhile(users, { 'status': 'busy' }), 'user'); ### `_.findIndex(array, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4388 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4395 "View in source") [Ⓣ][1] This method is like `_.find` except that it returns the index of the first element `predicate` returns truthy for, instead of the element itself. - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -588,14 +596,16 @@ _.findIndex(users, 'active'); ### `_.findLastIndex(array, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4440 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4447 "View in source") [Ⓣ][1] This method is like `_.findIndex` except that it iterates over elements of `collection` from right to left. - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -634,7 +644,7 @@ _.findLastIndex(users, 'active'); ### `_.first(array)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4468 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4475 "View in source") [Ⓣ][1] Gets the first element of `array`. @@ -659,7 +669,7 @@ _.first([]); ### `_.flatten(array, [isDeep])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4492 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4499 "View in source") [Ⓣ][1] Flattens a nested array. If `isDeep` is `true` the array is recursively flattened, otherwise it is only flattened a single level. @@ -687,7 +697,7 @@ _.flatten([1, [2], [3, [[4]]]], true); ### `_.flattenDeep(array)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4513 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4520 "View in source") [Ⓣ][1] Recursively flattens a nested array. @@ -709,13 +719,15 @@ _.flattenDeep([1, [2], [3, [[4]]]]); ### `_.indexOf(array, value, [fromIndex=0])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4550 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4557 "View in source") [Ⓣ][1] Gets the index at which the first occurrence of `value` is found in `array` using `SameValueZero` for equality comparisons. If `fromIndex` is negative, it is used as the offset from the end of `array`. If `array` is sorted providing `true` for `fromIndex` performs a faster binary search. - *Note:** `SameValueZero` comparisons are like strict equality comparisons, +
+
+**Note:** `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -748,7 +760,7 @@ _.indexOf([4, 4, 5, 5, 6, 6], 5, true); ### `_.initial(array)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4579 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4586 "View in source") [Ⓣ][1] Gets all but the last element of `array`. @@ -770,11 +782,13 @@ _.initial([1, 2, 3]); ### `_.intersection([arrays])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4602 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4609 "View in source") [Ⓣ][1] Creates an array of unique values in all provided arrays using `SameValueZero` for equality comparisons. - *Note:** `SameValueZero` comparisons are like strict equality comparisons, +
+
+**Note:** `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -797,7 +811,7 @@ _.intersection([1, 2, 3], [5, 2, 1, 4], [2, 1]); ### `_.last(array)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4657 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4664 "View in source") [Ⓣ][1] Gets the last element of `array`. @@ -819,7 +833,7 @@ _.last([1, 2, 3]); ### `_.lastIndexOf(array, value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4687 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4694 "View in source") [Ⓣ][1] This method is like `_.indexOf` except that it iterates over elements of `array` from right to left. @@ -852,13 +866,17 @@ _.lastIndexOf([4, 4, 5, 5, 6, 6], 5, true); ### `_.pull(array, [values])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4734 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4741 "View in source") [Ⓣ][1] Removes all provided values from `array` using `SameValueZero` for equality comparisons. - *Notes:** -- Unlike `_.without`, this method mutates `array`. -- `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, +
+
+**Notes:** +
+* Unlike `_.without`, this method mutates `array`. +
+* `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -883,12 +901,14 @@ console.log(array); ### `_.pullAt(array, [indexes])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4779 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4786 "View in source") [Ⓣ][1] Removes elements from `array` corresponding to the given indexes and returns an array of the removed elements. Indexes may be specified as an array of indexes or as individual arguments. - *Note:** Unlike `_.at`, this method mutates `array`. +
+
+**Note:** Unlike `_.at`, this method mutates `array`. #### Arguments 1. `array` *(Array)*: The array to modify. @@ -915,19 +935,23 @@ console.log(evens); ### `_.remove(array, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4817 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4824 "View in source") [Ⓣ][1] Removes all elements from `array` that `predicate` returns truthy for and returns an array of the removed elements. The predicate is bound to `thisArg` and invoked with three arguments; (value, index, array). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. - *Note:** Unlike `_.filter`, this method mutates `array`. +
+
+**Note:** Unlike `_.filter`, this method mutates `array`. #### Arguments 1. `array` *(Array)*: The array to modify. @@ -955,7 +979,7 @@ console.log(evens); ### `_.rest(array)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4848 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4855 "View in source") [Ⓣ][1] Gets all but the first element of `array`. @@ -977,10 +1001,12 @@ _.rest([1, 2, 3]); ### `_.slice(array, [start=0])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4866 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4873 "View in source") [Ⓣ][1] Creates a slice of `array` from `start` up to, but not including, `end`. - *Note:** This function is used instead of `Array#slice` to support node +
+
+**Note:** This function is used instead of `Array#slice` to support node lists in IE < 9 and to ensure dense arrays are returned. #### Arguments @@ -998,17 +1024,19 @@ lists in IE < 9 and to ensure dense arrays are returned. ### `_.sortedIndex(array, value, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4923 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4930 "View in source") [Ⓣ][1] Uses a binary search to determine the lowest index at which `value` should be inserted into `array` in order to maintain its sort order. If an iteratee function is provided it is invoked for `value` and each element of `array` to compute their sort ranking. The iteratee is bound to `thisArg` and invoked with one argument; (value). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -1050,7 +1078,7 @@ _.sortedIndex([{ 'x': 30 }, { 'x': 50 }], { 'x': 40 }, 'x'); ### `_.sortedLastIndex(array, value, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4951 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4958 "View in source") [Ⓣ][1] This method is like `_.sortedIndex` except that it returns the highest index at which `value` should be inserted into `array` in order to @@ -1078,7 +1106,7 @@ _.sortedLastIndex([4, 4, 5, 5, 6, 6], 5); ### `_.take(array, [n=1])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L4983 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L4990 "View in source") [Ⓣ][1] Creates a slice of `array` with `n` elements taken from the beginning. @@ -1110,7 +1138,7 @@ _.take([1, 2, 3], 0); ### `_.takeRight(array, [n=1])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5019 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5026 "View in source") [Ⓣ][1] Creates a slice of `array` with `n` elements taken from the end. @@ -1142,15 +1170,17 @@ _.takeRight([1, 2, 3], 0); ### `_.takeRightWhile(array, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5071 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5078 "View in source") [Ⓣ][1] Creates a slice of `array` with elements taken from the end. Elements are taken until `predicate` returns falsey. The predicate is bound to `thisArg` and invoked with three arguments; (value, index, array). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -1189,15 +1219,17 @@ _.pluck(_.takeRightWhile(users, { 'status': 'away' }), 'user'); ### `_.takeWhile(array, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5121 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5128 "View in source") [Ⓣ][1] Creates a slice of `array` with elements taken from the beginning. Elements are taken until `predicate` returns falsey. The predicate is bound to `thisArg` and invoked with three arguments; (value, index, array). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -1236,11 +1268,13 @@ _.pluck(_.takeWhile(users, { 'status': 'busy' }), 'user'); ### `_.union([arrays])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5151 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5158 "View in source") [Ⓣ][1] Creates an array of unique values, in order, of the provided arrays using `SameValueZero` for equality comparisons. - *Note:** `SameValueZero` comparisons are like strict equality comparisons, +
+
+**Note:** `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -1263,7 +1297,7 @@ _.union([1, 2, 3], [5, 2, 1, 4], [2, 1]); ### `_.uniq(array, [isSorted], [iteratee], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5203 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5210 "View in source") [Ⓣ][1] Creates a duplicate-value-free version of an array using `SameValueZero` for equality comparisons. Providing `true` for `isSorted` performs a faster @@ -1271,14 +1305,18 @@ search algorithm for sorted arrays. If an iteratee function is provided it is invoked for each value in the array to generate the criterion by which uniqueness is computed. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index, array). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. - *Note:** `SameValueZero` comparisons are like strict equality comparisons, +
+
+**Note:** `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -1316,7 +1354,7 @@ _.uniq([{ 'x': 1 }, { 'x': 2 }, { 'x': 1 }], 'x'); ### `_.unzip(array)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5241 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5248 "View in source") [Ⓣ][1] This method is like `_.zip` except that it accepts an array of grouped elements and creates an array regrouping the elements to their pre-`_.zip` @@ -1343,11 +1381,13 @@ _.unzip(zipped); ### `_.without(array, [values])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5272 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5279 "View in source") [Ⓣ][1] Creates an array excluding all provided values using `SameValueZero` for equality comparisons. - *Note:** `SameValueZero` comparisons are like strict equality comparisons, +
+
+**Note:** `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -1371,7 +1411,7 @@ _.without([1, 2, 1, 0, 3, 1, 4], 0, 1); ### `_.xor([arrays])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5294 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5301 "View in source") [Ⓣ][1] Creates an array that is the symmetric difference of the provided arrays. See [Wikipedia](https://en.wikipedia.org/wiki/Symmetric_difference) for @@ -1398,7 +1438,7 @@ _.xor([1, 2, 5], [2, 3, 5], [3, 4, 5]); ### `_.zip([arrays])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5324 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5331 "View in source") [Ⓣ][1] Creates an array of grouped elements, the first of which contains the first elements of the given arrays, the second of which contains the second elements @@ -1422,7 +1462,7 @@ _.zip(['fred', 'barney'], [30, 40], [true, false]); ### `_.zipObject(props, [values=[]])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5351 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5358 "View in source") [Ⓣ][1] Creates an object composed from arrays of property names and values. Provide either a single two dimensional array, e.g. `[[key1, value1], [key2, value2]]` @@ -1453,7 +1493,7 @@ _.zipObject(['fred', 'barney'], [30, 40]); ### `._(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L919 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L919 "View in source") [Ⓣ][1] Creates a `lodash` object which wraps `value` to enable intuitive chaining. Methods that operate on and return arrays, collections, and functions can @@ -1462,24 +1502,29 @@ automatically end the chain returning the unwrapped value. Explicit chaining may be enabled using `_.chain`. The execution of chained methods is lazy, that is, execution is deferred until `_#value` is implicitly or explicitly called. - +
+
Lazy evaluation allows several methods to support shortcut fusion. Shortcut fusion is an optimization that merges iteratees to avoid creating intermediate arrays and reduce the number of iteratee executions. - +
+
Chaining is supported in custom builds as long as the `_#value` method is directly or indirectly included in the build. - -In addition to lodash methods, wrappers also have the following `Array` methods: +
+
+In addition to lodash methods, wrappers also have the following `Array` methods:
`concat`, `join`, `pop`, `push`, `reverse`, `shift`, `slice`, `sort`, `splice`, and `unshift` - -The wrapper functions that support shortcut fusion are: +
+
+The wrapper functions that support shortcut fusion are:
`drop`, `dropRight`, `dropRightWhile`, `dropWhile`, `filter`, `first`, `initial`, `last`, `map`, `pluck`, `reject`, `rest`, `reverse`, `slice`, `take`, `takeRight`, `takeRightWhile`, `takeWhile`, and `where` - -The chainable wrapper functions are: +
+
+The chainable wrapper functions are:
`after`, `ary`, `assign`, `at`, `before`, `bind`, `bindAll`, `bindKey`, `callback`, `chain`, `chunk`, `compact`, `concat`, `constant`, `countBy`, `create`, `curry`, `debounce`, `defaults`, `defer`, `delay`, `difference`, @@ -1495,8 +1540,9 @@ The chainable wrapper functions are: `takeWhile`, `tap`, `throttle`, `thru`, `times`, `toArray`, `toPlainObject`, `transform`, `union`, `uniq`, `unshift`, `unzip`, `values`, `valuesIn`, `where`, `without`, `wrap`, `xor`, `zip`, and `zipObject` - -The wrapper functions that are **not** chainable by default are: +
+
+The wrapper functions that are **not** chainable by default are:
`attempt`, `camelCase`, `capitalize`, `clone`, `cloneDeep`, `deburr`, `endsWith`, `escape`, `escapeRegExp`, `every`, `find`, `findIndex`, `findKey`, `findLast`, `findLastIndex`, `findLastKey`, `findWhere`, `first`, `has`, @@ -1510,7 +1556,8 @@ The wrapper functions that are **not** chainable by default are: `shift`, `size`, `snakeCase`, `some`, `sortedIndex`, `sortedLastIndex`, `startsWith`, `template`, `trim`, `trimLeft`, `trimRight`, `trunc`, `unescape`, `uniqueId`, `value`, and `words` - +
+
The wrapper function `sample` will return a wrapped value when `n` is provided, otherwise an unwrapped value is returned. @@ -1544,7 +1591,7 @@ _.isArray(squares.value()); ### `_.chain(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5396 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5403 "View in source") [Ⓣ][1] Creates a `lodash` object that wraps `value` with explicit method chaining enabled. @@ -1577,7 +1624,7 @@ var youngest = _.chain(users) ### `_.tap(value, interceptor, [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5423 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5430 "View in source") [Ⓣ][1] This method invokes `interceptor` and returns `value`. The interceptor is bound to `thisArg` and invoked with one argument; (value). The purpose of @@ -1607,7 +1654,7 @@ _([1, 2, 3]) ### `_.thru(value, interceptor, [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5446 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5453 "View in source") [Ⓣ][1] This method is like `_.tap` except that it returns the result of `interceptor`. @@ -1634,7 +1681,7 @@ _([1, 2, 3]) ### `_.prototype.chain()` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5475 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5482 "View in source") [Ⓣ][1] Enables explicit method chaining on the wrapper object. @@ -1666,11 +1713,13 @@ _(users).chain() ### `_.prototype.reverse()` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5499 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5506 "View in source") [Ⓣ][1] Reverses the wrapped array so the first element becomes the last, the second element becomes the second to last, and so on. - *Note:** This method mutates the wrapped array. +
+
+**Note:** This method mutates the wrapped array. #### Returns *(Object)*: Returns the new reversed `lodash` object. @@ -1692,7 +1741,7 @@ console.log(array); ### `_.prototype.toString()` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5521 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5531 "View in source") [Ⓣ][1] Produces the result of coercing the unwrapped value to a string. @@ -1711,7 +1760,7 @@ _([1, 2, 3]).toString(); ### `_.prototype.value()` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5538 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5548 "View in source") [Ⓣ][1] Executes the chained sequence to extract the unwrapped value. @@ -1736,7 +1785,7 @@ _([1, 2, 3]).value(); ### `_.at(collection, [props])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5564 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5574 "View in source") [Ⓣ][1] Creates an array of elements corresponding to the given keys, or indexes, of `collection`. Keys may be specified as individual arguments or as arrays @@ -1764,17 +1813,19 @@ _.at(['fred', 'barney', 'pebbles'], 0, 2); ### `_.countBy(collection, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5657 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5667 "View in source") [Ⓣ][1] Creates an object composed of keys generated from the results of running each element of `collection` through `iteratee`. The corresponding value of each key is the number of times the key was returned by `iteratee`. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -1805,15 +1856,17 @@ _.countBy(['one', 'two', 'three'], 'length'); ### `_.every(collection, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5702 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5712 "View in source") [Ⓣ][1] Checks if `predicate` returns truthy for **all** elements of `collection`. The predicate is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -1852,15 +1905,17 @@ _.every(users, { 'age': 36 }); ### `_.filter(collection, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5750 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5760 "View in source") [Ⓣ][1] Iterates over elements of `collection`, returning an array of all elements `predicate` returns truthy for. The predicate is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -1898,15 +1953,17 @@ _.pluck(_.filter(users, { 'age': 36 }), 'user'); ### `_.find(collection, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5797 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5807 "View in source") [Ⓣ][1] Iterates over elements of `collection`, returning the first element `predicate` returns truthy for. The predicate is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -1945,7 +2002,7 @@ _.result(_.find(users, 'active'), 'user'); ### `_.findLast(collection, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5824 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5834 "View in source") [Ⓣ][1] This method is like `_.find` except that it iterates over elements of `collection` from right to left. @@ -1970,7 +2027,7 @@ _.findLast([1, 2, 3, 4], function(n) { return n % 2 == 1; }); ### `_.findWhere(collection, source)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5853 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5863 "View in source") [Ⓣ][1] Performs a deep comparison between each element in `collection` and the source object, returning the first element that has equivalent property @@ -2003,13 +2060,15 @@ _.result(_.findWhere(users, { 'age': 40 }), 'user'); ### `_.forEach(collection, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5883 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5893 "View in source") [Ⓣ][1] Iterates over elements of `collection` invoking `iteratee` for each element. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). Iterator functions may exit iteration early by explicitly returning `false`. - *Note:** As with other "Collections" methods, objects with a `length` property +
+
+**Note:** As with other "Collections" methods, objects with a `length` property are iterated like arrays. To avoid this behavior `_.forIn` or `_.forOwn` may be used for object iteration. @@ -2023,7 +2082,7 @@ may be used for object iteration. #### Example ```js -_([1, 2, 3]).forEach(function(n) { console.log(n); }); +_([1, 2, 3]).forEach(function(n) { console.log(n); }).value(); // => logs each value from left to right and returns the array _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, function(n, key) { console.log(n, key); }); @@ -2036,7 +2095,7 @@ _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, function(n, key) { console.log(n, ### `_.forEachRight(collection, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5906 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5916 "View in source") [Ⓣ][1] This method is like `_.forEach` except that it iterates over elements of `collection` from right to left. @@ -2061,17 +2120,19 @@ _([1, 2, 3]).forEachRight(function(n) { console.log(n); }).join(','); ### `_.groupBy(collection, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5947 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5957 "View in source") [Ⓣ][1] Creates an object composed of keys generated from the results of running each element of `collection` through `iteratee`. The corresponding value of each key is an array of the elements responsible for generating the key. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2103,12 +2164,14 @@ _.groupBy(['one', 'two', 'three'], 'length'); ### `_.includes(collection, target, [fromIndex=0])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5604 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L5614 "View in source") [Ⓣ][1] Checks if `value` is in `collection` using `SameValueZero` for equality comparisons. If `fromIndex` is negative, it is used as the offset from the end of `collection`. - *Note:** `SameValueZero` comparisons are like strict equality comparisons, +
+
+**Note:** `SameValueZero` comparisons are like strict equality comparisons, e.g. `===`, except that `NaN` matches `NaN`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-samevaluezero) for more details. @@ -2142,17 +2205,19 @@ _.includes('pebbles', 'eb'); ### `_.indexBy(collection, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L5994 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6004 "View in source") [Ⓣ][1] Creates an object composed of keys generated from the results of running each element of `collection` through `iteratee`. The corresponding value of each key is the last element responsible for generating the key. The iteratee function is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2188,7 +2253,7 @@ _.indexBy(keyData, function(object) { return this.fromCharCode(object.code); }, ### `_.invoke(collection, methodName, [args])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6020 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6030 "View in source") [Ⓣ][1] Invokes the method named by `methodName` on each element in `collection`, returning an array of the results of each invoked method. Any additional @@ -2218,15 +2283,17 @@ _.invoke([123, 456], String.prototype.split, ''); ### `_.map(collection, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6063 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6073 "View in source") [Ⓣ][1] Creates an array of values by running each element in `collection` through `iteratee`. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2263,17 +2330,19 @@ _.map(users, 'user'); ### `_.max(collection, [iteratee], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6112 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6122 "View in source") [Ⓣ][1] Gets the maximum value of `collection`. If `collection` is empty or falsey `-Infinity` is returned. If an iteratee function is provided it is invoked for each value in `collection` to generate the criterion by which the value is ranked. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2313,17 +2382,19 @@ _.max(users, 'age'); ### `_.min(collection, [iteratee], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6157 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6167 "View in source") [Ⓣ][1] Gets the minimum value of `collection`. If `collection` is empty or falsey `Infinity` is returned. If an iteratee function is provided it is invoked for each value in `collection` to generate the criterion by which the value is ranked. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2363,16 +2434,18 @@ _.min(users, 'age'); ### `_.partition(collection, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6203 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6213 "View in source") [Ⓣ][1] Creates an array of elements split into two groups, the first of which contains elements `predicate` returns truthy for, while the second of which contains elements `predicate` returns falsey for. The predicate is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2414,7 +2487,7 @@ _.map(_.partition(users, 'active'), function(array) { return _.pluck(array, 'use ### `_.pluck(collection, key)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6230 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6240 "View in source") [Ⓣ][1] Gets the value of `key` from all elements in `collection`. @@ -2446,7 +2519,7 @@ _.pluck(userIndex, 'age'); ### `_.reduce(collection, [iteratee=_.identity], [accumulator], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6262 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6272 "View in source") [Ⓣ][1] Reduces `collection` to a value which is the accumulated result of running each element in `collection` through `iteratee`, where each successive @@ -2482,7 +2555,7 @@ var mapped = _.reduce({ 'a': 1, 'b': 2, 'c': 3 }, function(result, n, key) { ### `_.reduceRight(collection, [iteratee=_.identity], [accumulator], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6286 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6296 "View in source") [Ⓣ][1] This method is like `_.reduce` except that it iterates over elements of `collection` from right to left. @@ -2509,14 +2582,16 @@ _.reduceRight(array, function(flattened, other) { return flattened.concat(other) ### `_.reject(collection, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6329 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6339 "View in source") [Ⓣ][1] The opposite of `_.filter`; this method returns the elements of `collection` that `predicate` does **not** return truthy for. - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2554,7 +2629,7 @@ _.pluck(_.reject(users, { 'age': 36 }), 'user'); ### `_.sample(collection, [n])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6355 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6365 "View in source") [Ⓣ][1] Gets a random element or `n` random elements from a collection. @@ -2580,7 +2655,7 @@ _.sample([1, 2, 3, 4], 2); ### `_.shuffle(collection)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6381 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6391 "View in source") [Ⓣ][1] Creates an array of shuffled values, using a version of the Fisher-Yates shuffle. See [Wikipedia](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle) @@ -2604,7 +2679,7 @@ _.shuffle([1, 2, 3, 4]); ### `_.size(collection)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6418 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6428 "View in source") [Ⓣ][1] Gets the size of `collection` by returning `collection.length` for array-like values or the number of own enumerable properties for objects. @@ -2633,16 +2708,18 @@ _.size('pebbles'); ### `_.some(collection, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6465 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6475 "View in source") [Ⓣ][1] Checks if `predicate` returns truthy for **any** element of `collection`. The function returns as soon as it finds a passing value and does not iterate over the entire collection. The predicate is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2681,17 +2758,19 @@ _.some(users, { 'age': 1 }); ### `_.sortBy(collection, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6514 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6524 "View in source") [Ⓣ][1] Creates an array of elements, sorted in ascending order by the results of running each element in a collection through `iteratee`. This method performs a stable sort, that is, it preserves the original sort order of equal elements. The `iteratee` is bound to `thisArg` and invoked with three arguments; (value, index|key, collection). - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -2729,7 +2808,7 @@ _.pluck(_.sortBy(users, 'user'), 'user'); ### `_.sortByAll(collection, props)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6552 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6562 "View in source") [Ⓣ][1] This method is like `_.sortBy` except that it sorts by property names instead of an iteratee function. @@ -2760,7 +2839,7 @@ _.map(_.sortByAll(users, ['user', 'age']), _.values); ### `_.where(collection, source)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6601 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6611 "View in source") [Ⓣ][1] Performs a deep comparison between each element in `collection` and the source object, returning an array of all elements that have equivalent @@ -2802,7 +2881,7 @@ _.pluck(_.where(users, { 'status': 'busy' }), 'user'); ### `_.now` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6619 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6629 "View in source") [Ⓣ][1] Gets the number of milliseconds that have elapsed since the Unix epoch (1 January 1970 00:00:00 UTC). @@ -2825,7 +2904,7 @@ _.defer(function(stamp) { console.log(_.now() - stamp); }, _.now()); ### `_.after(n, func)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6648 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6658 "View in source") [Ⓣ][1] The opposite of `_.before`; this method creates a function that invokes `func` once it is called `n` or more times. @@ -2857,7 +2936,7 @@ _.forEach(saves, function(type) { ### `_.ary(func)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6682 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6692 "View in source") [Ⓣ][1] Creates a function that accepts up to `n` arguments ignoring any additional arguments. @@ -2881,7 +2960,7 @@ _.map(['6', '8', '10'], _.ary(parseInt, 1)); ### `_.before(n, func)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6706 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6716 "View in source") [Ⓣ][1] Creates a function that invokes `func`, with the `this` binding and arguments of the created function, while it is called less than `n` times. Subsequent @@ -2906,15 +2985,18 @@ jQuery('#add').on('click', _.before(5, addContactToList)); ### `_.bind(func, thisArg, [args])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6762 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6772 "View in source") [Ⓣ][1] Creates a function that invokes `func` with the `this` binding of `thisArg` and prepends any additional `_.bind` arguments to those provided to the bound function. - +
+
The `_.bind.placeholder` value, which defaults to `_` in monolithic builds, may be used as a placeholder for partially applied arguments. - *Note:** Unlike native `Function#bind` this method does not set the `length` +
+
+**Note:** Unlike native `Function#bind` this method does not set the `length` property of bound functions. #### Arguments @@ -2949,13 +3031,15 @@ bound('hi'); ### `_.bindAll(object, [methodNames])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6799 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6809 "View in source") [Ⓣ][1] Binds methods of an object to the object itself, overwriting the existing method. Method names may be specified as individual arguments or as arrays of method names. If no method names are provided all enumerable function properties, own and inherited, of `object` are bound. - *Note:** This method does not set the `length` property of bound functions. +
+
+**Note:** This method does not set the `length` property of bound functions. #### Arguments 1. `object` *(Object)*: The object to bind and assign the bound methods to. @@ -2982,16 +3066,18 @@ jQuery('#docs').on('click', view.onClick); ### `_.bindKey(object, key, [args])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6851 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6861 "View in source") [Ⓣ][1] Creates a function that invokes the method at `object[key]` and prepends any additional `_.bindKey` arguments to those provided to the bound function. - +
+
This method differs from `_.bind` by allowing bound functions to reference methods that may be redefined or don't yet exist. See [Peter Michaux's article](http://michaux.ca/articles/lazy-function-definition-pattern) for more details. - +
+
The `_.bindKey.placeholder` value, which defaults to `_` in monolithic builds, may be used as a placeholder for partially applied arguments. @@ -3035,17 +3121,20 @@ bound('hi'); ### `_.curry(func)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6902 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6912 "View in source") [Ⓣ][1] Creates a function that accepts one or more arguments of `func` that when called either invokes `func` returning its result, if all `func` arguments have been provided, or returns a function that accepts one or more of the remaining `func` arguments, and so on. The arity of `func` may be specified if `func.length` is not sufficient. - +
+
The `_.curry.placeholder` value, which defaults to `_` in monolithic builds, may be used as a placeholder for provided arguments. - *Note:** This method does not set the `length` property of curried functions. +
+
+**Note:** This method does not set the `length` property of curried functions. #### Arguments 1. `func` *(Function)*: The function to curry. @@ -3082,14 +3171,17 @@ curried(1)(_, 3)(2); ### `_.curryRight(func)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L6948 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L6958 "View in source") [Ⓣ][1] This method is like `_.curry` except that arguments are applied to `func` in the manner of `_.partialRight` instead of `_.partial`. - +
+
The `_.curryRight.placeholder` value, which defaults to `_` in monolithic builds, may be used as a placeholder for provided arguments. - *Note:** This method does not set the `length` property of curried functions. +
+
+**Note:** This method does not set the `length` property of curried functions. #### Arguments 1. `func` *(Function)*: The function to curry. @@ -3126,7 +3218,7 @@ curried(3)(1, _)(2); ### `_.debounce(func, wait, [options], [options.leading=false], [options.maxWait], [options.trailing=true])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7019 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7029 "View in source") [Ⓣ][1] Creates a function that delays invoking `func` until after `wait` milliseconds have elapsed since the last time it was invoked. The created function comes @@ -3134,10 +3226,13 @@ with a `cancel` method to cancel delayed invocations. Provide an options object to indicate that `func` should be invoked on the leading and/or trailing edge of the `wait` timeout. Subsequent calls to the debounced function return the result of the last `func` invocation. - *Note:** If `leading` and `trailing` options are `true`, `func` is invoked +
+
+**Note:** If `leading` and `trailing` options are `true`, `func` is invoked on the trailing edge of the timeout only if the the debounced function is invoked more than once during the `wait` timeout. - +
+
See [David Corbacho's article](http://drupalmotion.com/article/debounce-and-throttle-visual-explanation) for details over the differences between `_.debounce` and `_.throttle`. @@ -3193,7 +3288,7 @@ delete models.todo; ### `_.defer(func, [args])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7148 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7158 "View in source") [Ⓣ][1] Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to `func` when it is invoked. @@ -3217,7 +3312,7 @@ _.defer(function(text) { console.log(text); }, 'deferred'); ### `_.delay(func, wait, [args])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7168 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7178 "View in source") [Ⓣ][1] Invokes `func` after `wait` milliseconds. Any additional arguments are provided to `func` when it is invoked. @@ -3242,7 +3337,7 @@ _.delay(function(text) { console.log(text); }, 1000, 'later'); ### `_.flow([funcs])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7196 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7206 "View in source") [Ⓣ][1] Creates a function that returns the result of invoking the provided functions with the `this` binding of the created function, where each @@ -3275,7 +3370,7 @@ addSquare(1, 2); ### `_.flowRight([funcs])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7241 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7251 "View in source") [Ⓣ][1] This method is like `_.flow` except that it creates a function that invokes the provided functions from right to left. @@ -3307,7 +3402,7 @@ addSquare(1, 2); ### `_.memoize(func, [resolver])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7315 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7325 "View in source") [Ⓣ][1] Creates a function that memoizes the result of `func`. If `resolver` is provided it determines the cache key for storing the result based on the @@ -3315,7 +3410,9 @@ arguments provided to the memoized function. By default, the first argument provided to the memoized function is coerced to a string and used as the cache key. The `func` is invoked with the `this` binding of the memoized function. - *Note:** The cache is exposed as the `cache` property on the memoized +
+
+**Note:** The cache is exposed as the `cache` property on the memoized function. Its creation may be customized by replacing the `_.memoize.Cache` constructor with one whose instances implement the ES `Map` method interface of `get`, `has`, and `set`. See the @@ -3339,7 +3436,7 @@ upperCase('fred'); // => 'FRED' // modifying the result cache -upperCase.cache.set('fred, 'BARNEY'); +upperCase.cache.set('fred', 'BARNEY'); upperCase('fred'); // => 'BARNEY' @@ -3368,7 +3465,7 @@ identity(other); ### `_.negate(predicate)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7353 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7363 "View in source") [Ⓣ][1] Creates a function that negates the result of the predicate `func`. The `func` predicate is invoked with the `this` binding and arguments of the @@ -3396,7 +3493,7 @@ _.filter([1, 2, 3, 4, 5, 6], _.negate(isEven)); ### `_.once(func)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7380 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7390 "View in source") [Ⓣ][1] Creates a function that is restricted to invoking `func` once. Repeat calls to the function return the value of the first call. The `func` is invoked @@ -3422,15 +3519,18 @@ initialize(); ### `_.partial(func, [args])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7416 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7426 "View in source") [Ⓣ][1] Creates a function that invokes `func` with `partial` arguments prepended to those provided to the new function. This method is like `_.bind` except it does **not** alter the `this` binding. - +
+
The `_.partial.placeholder` value, which defaults to `_` in monolithic builds, may be used as a placeholder for partially applied arguments. - *Note:** This method does not set the `length` property of partially +
+
+**Note:** This method does not set the `length` property of partially applied functions. #### Arguments @@ -3462,14 +3562,17 @@ greetFred('hi'); ### `_.partialRight(func, [args])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7454 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7464 "View in source") [Ⓣ][1] This method is like `_.partial` except that partially applied arguments are appended to those provided to the new function. - +
+
The `_.partialRight.placeholder` value, which defaults to `_` in monolithic builds, may be used as a placeholder for partially applied arguments. - *Note:** This method does not set the `length` property of partially +
+
+**Note:** This method does not set the `length` property of partially applied functions. #### Arguments @@ -3501,7 +3604,7 @@ sayHelloTo('fred'); ### `_.rearg(func, indexes)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7487 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7497 "View in source") [Ⓣ][1] Creates a function that invokes `func` with arguments arranged according to the specified indexes where the argument value at the first index is @@ -3535,7 +3638,7 @@ map(function(n) { return n * 3; }, [1, 2, 3]); ### `_.throttle(func, wait, [options], [options.leading=true], [options.trailing=true])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7530 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7540 "View in source") [Ⓣ][1] Creates a function that only invokes `func` at most once per every `wait` milliseconds. The created function comes with a `cancel` method to cancel @@ -3543,10 +3646,13 @@ delayed invocations. Provide an options object to indicate that `func` should be invoked on the leading and/or trailing edge of the `wait` timeout. Subsequent calls to the throttled function return the result of the last `func` call. - *Note:** If `leading` and `trailing` options are `true`, `func` is invoked +
+
+**Note:** If `leading` and `trailing` options are `true`, `func` is invoked on the trailing edge of the timeout only if the the throttled function is invoked more than once during the `wait` timeout. - +
+
See [David Corbacho's article](http://drupalmotion.com/article/debounce-and-throttle-visual-explanation) for details over the differences between `_.throttle` and `_.debounce`. @@ -3579,7 +3685,7 @@ jQuery(window).on('popstate', throttled.cancel); ### `_.wrap(value, wrapper)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7570 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7580 "View in source") [Ⓣ][1] Creates a function that provides `value` to the wrapper function as its first argument. Any additional arguments provided to the function are @@ -3615,14 +3721,16 @@ p('fred, barney, & pebbles'); ### `_.clone(value, [isDeep], [customizer], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7626 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7636 "View in source") [Ⓣ][1] Creates a clone of `value`. If `isDeep` is `true` nested objects are cloned, otherwise they are assigned by reference. If `customizer` is provided it is invoked to produce the cloned values. If `customizer` returns `undefined` cloning is handled by the method instead. The `customizer` is bound to `thisArg` and invoked with two argument; (value [, index|key, object]). - *Note:** This method is loosely based on the structured clone algorithm. +
+
+**Note:** This method is loosely based on the structured clone algorithm. The enumerable properties of `arguments` objects and objects created by constructors other than `Object` are cloned to plain `Object` objects. An empty object is returned for uncloneable values such as functions, DOM nodes, @@ -3672,13 +3780,15 @@ body.childNodes.length; ### `_.cloneDeep(value, [customizer], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7680 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7690 "View in source") [Ⓣ][1] Creates a deep clone of `value`. If `customizer` is provided it is invoked to produce the cloned values. If `customizer` returns `undefined` cloning is handled by the method instead. The `customizer` is bound to `thisArg` and invoked with two argument; (value [, index|key, object]). - *Note:** This method is loosely based on the structured clone algorithm. +
+
+**Note:** This method is loosely based on the structured clone algorithm. The enumerable properties of `arguments` objects and objects created by constructors other than `Object` are cloned to plain `Object` objects. An empty object is returned for uncloneable values such as functions, DOM nodes, @@ -3723,7 +3833,7 @@ body.childNodes.length; ### `_.isArguments(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7701 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7711 "View in source") [Ⓣ][1] Checks if `value` is classified as an `arguments` object. @@ -3748,7 +3858,7 @@ _.isArguments([1, 2, 3]); ### `_.isArray(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7730 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7740 "View in source") [Ⓣ][1] Checks if `value` is classified as an `Array` object. @@ -3773,7 +3883,7 @@ _.isArray([1, 2, 3]); ### `_.isBoolean(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7750 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7760 "View in source") [Ⓣ][1] Checks if `value` is classified as a boolean primitive or object. @@ -3798,7 +3908,7 @@ _.isBoolean(null); ### `_.isDate(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7770 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7780 "View in source") [Ⓣ][1] Checks if `value` is classified as a `Date` object. @@ -3823,7 +3933,7 @@ _.isDate('Mon April 23 2012'); ### `_.isElement(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7790 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7800 "View in source") [Ⓣ][1] Checks if `value` is a DOM element. @@ -3848,7 +3958,7 @@ _.isElement(''); ### `_.isEmpty(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7828 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7838 "View in source") [Ⓣ][1] Checks if a value is empty. A value is considered empty unless it is an `arguments` object, array, string, or jQuery-like collection with a length @@ -3884,14 +3994,16 @@ _.isEmpty({ 'a': 1 }); ### `_.isEqual(value, other, [customizer], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7880 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7890 "View in source") [Ⓣ][1] Performs a deep comparison between two values to determine if they are equivalent. If `customizer` is provided it is invoked to compare values. If `customizer` returns `undefined` comparisons are handled by the method instead. The `customizer` is bound to `thisArg` and invoked with three arguments; (value, other [, index|key]). - *Note:** This method supports comparing arrays, booleans, `Date` objects, +
+
+**Note:** This method supports comparing arrays, booleans, `Date` objects, numbers, `Object` objects, regexes, and strings. Functions and DOM nodes are **not** supported. Provide a customizer function to extend support for comparing other values. @@ -3932,7 +4044,7 @@ _.isEqual(array, other, function(value, other) { ### `_.isError(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7906 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7916 "View in source") [Ⓣ][1] Checks if `value` is an `Error`, `EvalError`, `RangeError`, `ReferenceError`, `SyntaxError`, `TypeError`, or `URIError` object. @@ -3958,10 +4070,12 @@ _.isError(Error); ### `_.isFinite(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7939 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7949 "View in source") [Ⓣ][1] Checks if `value` is a finite primitive number. - *Note:** This method is based on ES `Number.isFinite`. See the +
+
+**Note:** This method is based on ES `Number.isFinite`. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-number.isfinite) for more details. @@ -3995,7 +4109,7 @@ _.isFinite(Infinity); ### `_.isFunction(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7959 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L7969 "View in source") [Ⓣ][1] Checks if `value` is classified as a `Function` object. @@ -4020,14 +4134,16 @@ _.isFunction(/abc/); ### `_.isMatch(source, source, [customizer], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8042 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8052 "View in source") [Ⓣ][1] Performs a deep comparison between `object` and `source` to determine if `object` contains equivalent property values. If `customizer` is provided it is invoked to compare values. If `customizer` returns `undefined` comparisons are handled by the method instead. The `customizer` is bound to `thisArg` and invoked with three arguments; (value, other, index|key). - *Note:** This method supports comparing properties of arrays, booleans, +
+
+**Note:** This method supports comparing properties of arrays, booleans, `Date` objects, numbers, `Object` objects, regexes, and strings. Functions and DOM nodes are **not** supported. Provide a customizer function to extend support for comparing other values. @@ -4067,10 +4183,12 @@ _.isMatch(object, source, function(value, other) { ### `_.isNaN(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8091 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8101 "View in source") [Ⓣ][1] Checks if `value` is `NaN`. - *Note:** This method is not the same as native `isNaN` which returns `true` +
+
+**Note:** This method is not the same as native `isNaN` which returns `true` for `undefined` and other non-numeric values. See the [ES5 spec](https://es5.github.io/#x15.1.2.4) for more details. @@ -4101,7 +4219,7 @@ _.isNaN(undefined); ### `_.isNative(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8113 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8123 "View in source") [Ⓣ][1] Checks if `value` is a native function. @@ -4126,7 +4244,7 @@ _.isNative(_); ### `_.isNull(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8140 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8150 "View in source") [Ⓣ][1] Checks if `value` is `null`. @@ -4151,10 +4269,12 @@ _.isNull(void 0); ### `_.isNumber(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8166 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8176 "View in source") [Ⓣ][1] Checks if `value` is classified as a `Number` primitive or object. - *Note:** To exclude `Infinity`, `-Infinity`, and `NaN`, which are classified +
+
+**Note:** To exclude `Infinity`, `-Infinity`, and `NaN`, which are classified as numbers, use the `_.isFinite` method. #### Arguments @@ -4181,11 +4301,13 @@ _.isNumber('8.4'); ### `_.isObject(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L7996 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8006 "View in source") [Ⓣ][1] Checks if `value` is the language type of `Object`. (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`) - *Note:** See the [ES5 spec](https://es5.github.io/#x8) for more details. +
+
+**Note:** See the [ES5 spec](https://es5.github.io/#x8) for more details. #### Arguments 1. `value` *(*)*: The value to check. @@ -4211,11 +4333,13 @@ _.isObject(1); ### `_.isPlainObject(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8200 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8210 "View in source") [Ⓣ][1] Checks if `value` is a plain object, that is, an object created by the `Object` constructor or one with a `[[Prototype]]` of `null`. - *Note:** This method assumes objects created by the `Object` constructor +
+
+**Note:** This method assumes objects created by the `Object` constructor have no inherited enumerable properties. #### Arguments @@ -4249,7 +4373,7 @@ _.isPlainObject(Object.create(null)); ### `_.isRegExp(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8228 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8238 "View in source") [Ⓣ][1] Checks if `value` is classified as a `RegExp` object. @@ -4274,7 +4398,7 @@ _.isRegExp('/abc/'); ### `_.isString(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8248 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8258 "View in source") [Ⓣ][1] Checks if `value` is classified as a `String` primitive or object. @@ -4299,7 +4423,7 @@ _.isString(1); ### `_.isTypedArray(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8268 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8278 "View in source") [Ⓣ][1] Checks if `value` is classified as a typed array. @@ -4324,7 +4448,7 @@ _.isTypedArray([]); ### `_.isUndefined(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8288 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8298 "View in source") [Ⓣ][1] Checks if `value` is `undefined`. @@ -4349,7 +4473,7 @@ _.isUndefined(null); ### `_.toArray(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8305 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8315 "View in source") [Ⓣ][1] Converts `value` to an array. @@ -4371,7 +4495,7 @@ Converts `value` to an array. ### `_.toPlainObject(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8341 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8351 "View in source") [Ⓣ][1] Converts `value` to a plain object flattening inherited enumerable properties of `value` to own properties of the plain object. @@ -4409,7 +4533,7 @@ _.assign({ 'a': 1 }, _.toPlainObject(new Foo)); ### `_.random([min=0], [max=1], [floating])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9228 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9238 "View in source") [Ⓣ][1] Produces a random number between `min` and `max` (inclusive). If only one argument is provided a number between `0` and the given number is returned. @@ -4451,7 +4575,7 @@ _.random(1.2, 5.2); ### `_.assign(object, [sources], [customizer], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8376 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8386 "View in source") [Ⓣ][1] Assigns own enumerable properties of source object(s) to the destination object. Subsequent sources overwrite property assignments of previous sources. @@ -4488,7 +4612,7 @@ defaults({ 'user': 'barney' }, { 'age': 36 }, { 'user': 'fred' }); ### `_.create(prototype, [properties])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8410 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8420 "View in source") [Ⓣ][1] Creates an object that inherits from the given `prototype` object. If a `properties` object is provided its own enumerable properties are assigned @@ -4528,7 +4652,7 @@ circle instanceof Shape; ### `_.defaults(object, [sources])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8434 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8444 "View in source") [Ⓣ][1] Assigns own enumerable properties of source object(s) to the destination object for all destination properties that resolve to `undefined`. Once a @@ -4553,14 +4677,16 @@ _.defaults({ 'user': 'barney' }, { 'age': 36 }, { 'user': 'fred' }); ### `_.findKey(object, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8482 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8492 "View in source") [Ⓣ][1] This method is like `_.findIndex` except that it returns the key of the first element `predicate` returns truthy for, instead of the element itself. - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -4599,14 +4725,16 @@ _.findKey(users, 'active'); ### `_.findLastKey(object, [predicate=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8526 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8536 "View in source") [Ⓣ][1] This method is like `_.findKey` except that it iterates over elements of a collection in the opposite order. - +
+
If a property name is provided for `predicate` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `predicate` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -4645,7 +4773,7 @@ _.findLastKey(users, 'active'); ### `_.forIn(object, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8558 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8568 "View in source") [Ⓣ][1] Iterates over own and inherited enumerable properties of an object invoking `iteratee` for each property. The `iteratee` is bound to `thisArg` and invoked @@ -4681,7 +4809,7 @@ _.forIn(new Foo, function(value, key) { ### `_.forInRight(object, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8590 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8600 "View in source") [Ⓣ][1] This method is like `_.forIn` except that it iterates over properties of `object` in the opposite order. @@ -4715,7 +4843,7 @@ _.forInRight(new Foo, function(value, key) { ### `_.forOwn(object, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8615 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8625 "View in source") [Ⓣ][1] Iterates over own enumerable properties of an object invoking `iteratee` for each property. The `iteratee` is bound to `thisArg` and invoked with @@ -4744,7 +4872,7 @@ _.forOwn({ '0': 'zero', '1': 'one', 'length': 2 }, function(n, key) { ### `_.forOwnRight(object, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8640 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8650 "View in source") [Ⓣ][1] This method is like `_.forOwn` except that it iterates over properties of `object` in the opposite order. @@ -4771,7 +4899,7 @@ _.forOwnRight({ '0': 'zero', '1': 'one', 'length': 2 }, function(n, key) { ### `_.functions(object)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8660 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8670 "View in source") [Ⓣ][1] Creates an array of function property names from all enumerable properties, own and inherited, of `object`. @@ -4794,7 +4922,7 @@ _.functions(_); ### `_.has(object, key)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8679 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8689 "View in source") [Ⓣ][1] Checks if `key` exists as a direct property of `object` instead of an inherited property. @@ -4818,7 +4946,7 @@ _.has({ 'a': 1, 'b': 2, 'c': 3 }, 'b'); ### `_.invert(object, [multiValue])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8708 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8718 "View in source") [Ⓣ][1] Creates an object composed of the inverted keys and values of `object`. If `object` contains duplicate values, subsequent values overwrite property @@ -4851,10 +4979,12 @@ _.invert({ 'first': 'fred', 'second': 'barney', 'third': 'fred' }, true); ### `_.keys(object)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8762 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8772 "View in source") [Ⓣ][1] Creates an array of the own enumerable property names of `object`. - *Note:** Non-object values are coerced to objects. See the +
+
+**Note:** Non-object values are coerced to objects. See the [ES spec](https://people.mozilla.org/~jorendorff/es6-draft.html#sec-object.keys) for more details. @@ -4886,10 +5016,12 @@ _.keys('hi'); ### `_.keysIn(object)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8796 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8806 "View in source") [Ⓣ][1] Creates an array of the own and inherited enumerable property names of `object`. - *Note:** Non-object values are coerced to objects. +
+
+**Note:** Non-object values are coerced to objects. #### Arguments 1. `object` *(Object)*: The object to inspect. @@ -4916,16 +5048,18 @@ _.keysIn(new Foo); ### `_.mapValues(object, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8890 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8900 "View in source") [Ⓣ][1] Creates an object with the same keys as `object` and values generated by running each own enumerable property of `object` through `iteratee`. The iteratee function is bound to `thisArg` and invoked with three arguments; (value, key, object). - +
+
If a property name is provided for `iteratee` the created "_.property" style callback returns the property value of the given element. - +
+
If an object is provided for `iteratee` the created "_.matches" style callback returns `true` for elements that have the properties of the given object, else `false`. @@ -4959,7 +5093,7 @@ _.mapValues(users, 'age'); ### `_.merge(object, [sources], [customizer], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8946 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8956 "View in source") [Ⓣ][1] Recursively merges own enumerable properties of the source object(s), that don't resolve to `undefined` into the destination object. Subsequent sources @@ -5014,7 +5148,7 @@ _.merge(object, other, function(a, b) { ### `_.omit(object, [predicate], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L8976 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L8986 "View in source") [Ⓣ][1] The opposite of `_.pick`; this method creates an object composed of the own and inherited enumerable properties of `object` that are not omitted. @@ -5049,7 +5183,7 @@ _.omit(object, _.isNumber); ### `_.pairs(object)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9004 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9014 "View in source") [Ⓣ][1] Creates a two dimensional array of the key-value pairs for `object`, e.g. `[[key1, value1], [key2, value2]]`. @@ -5072,7 +5206,7 @@ _.pairs({ 'barney': 36, 'fred': 40 }); ### `_.pick(object, [predicate], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9043 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9053 "View in source") [Ⓣ][1] Creates an object composed of the picked `object` properties. Property names may be specified as individual arguments or as arrays of property @@ -5105,7 +5239,7 @@ _.pick(object, _.isString); ### `_.result(object, key, [defaultValue])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9082 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9092 "View in source") [Ⓣ][1] Resolves the value of property `key` on `object`. If the value of `key` is a function it is invoked with the `this` binding of `object` and its result @@ -5143,7 +5277,7 @@ _.result(object, 'status', _.constant('busy')); ### `_.transform(object, [iteratee=_.identity], [accumulator], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9121 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9131 "View in source") [Ⓣ][1] An alternative to `_.reduce`; this method transforms `object` to a new `accumulator` object which is the result of running each of its own enumerable @@ -5183,10 +5317,12 @@ var mapped = _.transform({ 'a': 1, 'b': 2, 'c': 3 }, function(result, n, key) { ### `_.values(object)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9168 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9178 "View in source") [Ⓣ][1] Creates an array of the own enumerable property values of `object`. - *Note:** Non-object values are coerced to objects. +
+
+**Note:** Non-object values are coerced to objects. #### Arguments 1. `object` *(Object)*: The object to query. @@ -5216,11 +5352,13 @@ _.values('hi'); ### `_.valuesIn(object)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9195 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9205 "View in source") [Ⓣ][1] Creates an array of the own and inherited enumerable property values of `object`. - *Note:** Non-object values are coerced to objects. +
+
+**Note:** Non-object values are coerced to objects. #### Arguments 1. `object` *(Object)*: The object to query. @@ -5253,7 +5391,7 @@ _.valuesIn(new Foo); ### `_.camelCase([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9285 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9295 "View in source") [Ⓣ][1] Converts `string` to camel case. See [Wikipedia](https://en.wikipedia.org/wiki/CamelCase) for more details. @@ -5282,7 +5420,7 @@ _.camelCase('__foo_bar__'); ### `_.capitalize([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9303 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9313 "View in source") [Ⓣ][1] Capitalizes the first character of `string`. @@ -5304,7 +5442,7 @@ _.capitalize('fred'); ### `_.deburr([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9323 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9333 "View in source") [Ⓣ][1] Deburrs `string` by converting latin-1 supplementary letters to basic latin letters. See [Wikipedia](https://en.wikipedia.org/wiki/Latin-1_Supplement_(Unicode_block)#Character_table) @@ -5328,7 +5466,7 @@ _.deburr('déjà vu'); ### `_.endsWith([string=''], [target], [position=string.length])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9349 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9359 "View in source") [Ⓣ][1] Checks if `string` ends with the given target string. @@ -5358,24 +5496,29 @@ _.endsWith('abc', 'b', 2); ### `_.escape([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9390 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9400 "View in source") [Ⓣ][1] Converts the characters "&", "<", ">", '"', "'", and '`', in `string` to their corresponding HTML entities. - *Note:** No other characters are escaped. To escape additional characters +
+
+**Note:** No other characters are escaped. To escape additional characters use a third-party library like [_he_](https://mths.be/he). - +
+
Though the ">" character is escaped for symmetry, characters like ">" and "/" don't require escaping in HTML and have no special meaning unless they're part of a tag or unquoted attribute value. See [Mathias Bynens's article](https://mathiasbynens.be/notes/ambiguous-ampersands) (under "semi-related fun fact") for more details. - +
+
Backticks are escaped because in Internet Explorer < 9, they can break out of attribute values or HTML comments. See [#102](https://html5sec.org/#102), [#108](https://html5sec.org/#108), and [#133](https://html5sec.org/#133) of the [HTML5 Security Cheatsheet](https://html5sec.org/) for more details. - +
+
When working with HTML you should always quote attribute values to reduce XSS vectors. See [Ryan Grove's article](http://wonko.com/post/html-escaping) for more details. @@ -5398,7 +5541,7 @@ _.escape('fred, barney, & pebbles'); ### `_.escapeRegExp([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9412 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9422 "View in source") [Ⓣ][1] Escapes the `RegExp` special characters "\", "^", "$", ".", "|", "?", "*", "+", "(", ")", "[", "]", "{" and "}" in `string`. @@ -5421,10 +5564,10 @@ _.escapeRegExp('[lodash](https://lodash.com/)'); ### `_.kebabCase([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9440 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9450 "View in source") [Ⓣ][1] Converts `string` to kebab case (a.k.a. spinal case). -See [Wikipedia](https://en.wikipedia.org/wiki/Letter_case#Computers) for +See [Wikipedia](https://en.wikipedia.org/wiki/Letter_case#Special_case_styles) for more details. #### Arguments @@ -5451,7 +5594,7 @@ _.kebabCase('__foo_bar__'); ### `_.pad([string=''], [length=0], [chars=' '])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9467 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9477 "View in source") [Ⓣ][1] Pads `string` on the left and right sides if it is shorter then the given padding length. The `chars` string may be truncated if the number of padding @@ -5483,7 +5626,7 @@ _.pad('abc', 3); ### `_.padLeft([string=''], [length=0], [chars=' '])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9506 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9516 "View in source") [Ⓣ][1] Pads `string` on the left side if it is shorter then the given padding length. The `chars` string may be truncated if the number of padding @@ -5515,7 +5658,7 @@ _.padLeft('abc', 3); ### `_.padRight([string=''], [length=0], [chars=' '])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9534 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9544 "View in source") [Ⓣ][1] Pads `string` on the right side if it is shorter then the given padding length. The `chars` string may be truncated if the number of padding @@ -5547,12 +5690,14 @@ _.padRight('abc', 3); ### `_.parseInt(string, [radix])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9562 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9572 "View in source") [Ⓣ][1] Converts `string` to an integer of the specified radix. If `radix` is `undefined` or `0`, a `radix` of `10` is used unless `value` is a hexadecimal, in which case a `radix` of `16` is used. - *Note:** This method aligns with the ES5 implementation of `parseInt`. +
+
+**Note:** This method aligns with the ES5 implementation of `parseInt`. See the [ES5 spec](https://es5.github.io/#E) for more details. #### Arguments @@ -5577,7 +5722,7 @@ _.map(['6', '08', '10'], _.parseInt); ### `_.repeat([string=''], [n=0])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9604 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9614 "View in source") [Ⓣ][1] Repeats the given string `n` times. @@ -5606,7 +5751,7 @@ _.repeat('abc', 0); ### `_.snakeCase([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9644 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9654 "View in source") [Ⓣ][1] Converts `string` to snake case. See [Wikipedia](https://en.wikipedia.org/wiki/Snake_case) for more details. @@ -5635,7 +5780,7 @@ _.snakeCase('fooBar'); ### `_.startsWith([string=''], [target], [position=0])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9669 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9679 "View in source") [Ⓣ][1] Checks if `string` starts with the given target string. @@ -5665,20 +5810,24 @@ _.startsWith('abc', 'b', 1); ### `_.template([string=''], [options], [options.escape], [options.evaluate], [options.imports], [options.interpolate], [options.sourceURL], [options.variable])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9771 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9781 "View in source") [Ⓣ][1] Creates a compiled template function that can interpolate data properties in "interpolate" delimiters, HTML-escape interpolated data properties in "escape" delimiters, and execute JavaScript in "evaluate" delimiters. Data properties may be accessed as free variables in the template. If a setting object is provided it takes precedence over `_.templateSettings` values. - *Note:** In the development build `_.template` utilizes sourceURLs for easier debugging. +
+
+**Note:** In the development build `_.template` utilizes sourceURLs for easier debugging. See the [HTML5 Rocks article on sourcemaps](http://www.html5rocks.com/en/tutorials/developertools/sourcemaps/#toc-sourceurl) for more details. - +
+
For more information on precompiling templates see [lodash's custom builds documentation](https://lodash.com/custom-builds). - +
+
For more information on Chrome extension sandboxes see [Chrome's extensions documentation](https://developer.chrome.com/extensions/sandboxingEval). @@ -5768,7 +5917,7 @@ fs.writeFileSync(path.join(cwd, 'jst.js'), '\ ### `_.trim([string=''], [chars=whitespace])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9898 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9908 "View in source") [Ⓣ][1] Removes leading and trailing whitespace or specified characters from `string`. @@ -5797,7 +5946,7 @@ _.map([' foo ', ' bar '], _.trim); ### `_.trimLeft([string=''], [chars=whitespace])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9929 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9939 "View in source") [Ⓣ][1] Removes leading whitespace or specified characters from `string`. @@ -5823,7 +5972,7 @@ _.trimLeft('-_-abc-_-', '_-'); ### `_.trimRight([string=''], [chars=whitespace])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L9959 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L9969 "View in source") [Ⓣ][1] Removes trailing whitespace or specified characters from `string`. @@ -5849,7 +5998,7 @@ _.trimRight('-_-abc-_-', '_-'); ### `_.trunc([string=''], [options], [options.length=30], [options.omission='...'], [options.separator])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10003 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10013 "View in source") [Ⓣ][1] Truncates `string` if it is longer than the given maximum string length. The last characters of the truncated string are replaced with the omission @@ -5889,12 +6038,14 @@ _.trunc('hi-diddly-ho there, neighborino', { 'omission': ' [...]' }); ### `_.unescape([string=''])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10073 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10083 "View in source") [Ⓣ][1] The inverse of `_.escape`; this method converts the HTML entities `&`, `<`, `>`, `"`, `'`, and ``` in `string` to their corresponding characters. - *Note:** No other HTML entities are unescaped. To unescape additional HTML +
+
+**Note:** No other HTML entities are unescaped. To unescape additional HTML entities use a third-party library like [_he_](https://mths.be/he). #### Arguments @@ -5915,7 +6066,7 @@ _.unescape('fred, barney, & pebbles'); ### `_.words([string=''], [pattern])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10098 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10108 "View in source") [Ⓣ][1] Splits `string` into an array of its words. @@ -5947,7 +6098,7 @@ _.words('fred, barney, & pebbles', /[^, ]+/g); ### `_.attempt(func)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10128 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10138 "View in source") [Ⓣ][1] Attempts to invoke `func`, returning either the result or the caught error object. @@ -5976,7 +6127,7 @@ if (_.isError(elements)) { ### `_.callback([func=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10171 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10181 "View in source") [Ⓣ][1] Creates a function bound to an optional `thisArg`. If `func` is a property name the created callback returns the property value for a given element. @@ -6018,7 +6169,7 @@ _.filter(users, 'age__gt36'); ### `_.constant(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10193 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10203 "View in source") [Ⓣ][1] Creates a function that returns `value`. @@ -6042,7 +6193,7 @@ getter() === object; ### `_.identity(value)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10213 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10223 "View in source") [Ⓣ][1] This method returns the first argument provided to it. @@ -6065,7 +6216,7 @@ _.identity(object) === object; ### `_.matches(source)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10242 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10252 "View in source") [Ⓣ][1] Creates a function which performs a deep comparison between a given object and `source`, returning `true` if the given object has equivalent property @@ -6099,7 +6250,7 @@ _.find(users, matchesAge); ### `_.mixin([object=this], source, [options], [options.chain=true])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10279 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10289 "View in source") [Ⓣ][1] Adds all own enumerable function properties of a source object to the destination object. If `object` is a function then methods are added to @@ -6140,7 +6291,7 @@ _('fred').vowels(); ### `_.noConflict()` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10342 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10352 "View in source") [Ⓣ][1] Reverts the `_` variable to its previous value and returns a reference to the `lodash` function. @@ -6159,7 +6310,7 @@ var lodash = _.noConflict(); ### `_.noop()` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10359 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10369 "View in source") [Ⓣ][1] A no-operation function. @@ -6176,7 +6327,7 @@ _.noop(object) === undefined; ### `_.property(key)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10386 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10396 "View in source") [Ⓣ][1] Creates a function which returns the property value of `key` on a given object. @@ -6208,7 +6359,7 @@ _.pluck(_.sortBy(users, getName), 'user'); ### `_.propertyOf(object)` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10409 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10419 "View in source") [Ⓣ][1] The inverse of `_.property`; this method creates a function which returns the property value of a given key on `object`. @@ -6236,7 +6387,7 @@ _.sortBy(['a', 'b', 'c'], _.propertyOf(object)); ### `_.range([start=0], end, [step=1])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10447 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10457 "View in source") [Ⓣ][1] Creates an array of numbers (positive and/or negative) progressing from `start` up to, but not including, `end`. If `start` is less than `end` a @@ -6277,7 +6428,7 @@ _.range(0); ### `_.runInContext([context=root])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L689 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L689 "View in source") [Ⓣ][1] Create a new pristine `lodash` function using the given `context` object. @@ -6321,7 +6472,7 @@ var defer = _.runInContext({ 'setTimeout': setImmediate }).defer; ### `_.times(n, [iteratee=_.identity], [thisArg])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10496 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10506 "View in source") [Ⓣ][1] Invokes the iteratee function `n` times, returning an array of the results of each invocation. The `iteratee` is bound to `thisArg` and invoked with @@ -6353,7 +6504,7 @@ _.times(3, function(n) { this.cast(n); }, mage); ### `_.uniqueId([prefix])` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10534 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10544 "View in source") [Ⓣ][1] Generates a unique ID. If `prefix` is provided the ID is appended to it. @@ -6384,7 +6535,7 @@ _.uniqueId(); ### `_.templateSettings.imports._` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1163 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1163 "View in source") [Ⓣ][1] A reference to the `lodash` function. @@ -6401,7 +6552,7 @@ A reference to the `lodash` function. ### `_.VERSION` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L10794 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L10804 "View in source") [Ⓣ][1] (string): The semantic version number. @@ -6412,7 +6563,7 @@ A reference to the `lodash` function. ### `_.support` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L952 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L952 "View in source") [Ⓣ][1] (Object): An object environment feature flags. @@ -6423,7 +6574,7 @@ A reference to the `lodash` function. ### `_.support.argsTag` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L969 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L969 "View in source") [Ⓣ][1] (boolean): Detect if the `toStringTag` of `arguments` objects is resolvable (all but Firefox < 4, IE < 9). @@ -6435,7 +6586,7 @@ A reference to the `lodash` function. ### `_.support.enumErrorProps` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L978 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L978 "View in source") [Ⓣ][1] (boolean): Detect if `name` or `message` properties of `Error.prototype` are enumerable by default (IE < 9, Safari < 5.1). @@ -6447,10 +6598,11 @@ enumerable by default (IE < 9, Safari < 5.1). ### `_.support.enumPrototypes` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L992 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L992 "View in source") [Ⓣ][1] (boolean): Detect if `prototype` properties are enumerable by default. - +
+
Firefox < 3.6, Opera > 9.50 - Opera < 11.60, and Safari < 5.1 (if the prototype or a property on the prototype has been set) incorrectly set the `[[Enumerable]]` value of a function's `prototype` @@ -6463,7 +6615,7 @@ property to `true`. ### `_.support.funcDecomp` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1002 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1002 "View in source") [Ⓣ][1] (boolean): Detect if functions can be decompiled by `Function#toString` (all but Firefox OS certified apps, older Opera mobile browsers, and @@ -6476,7 +6628,7 @@ the PlayStation 3; forced `false` for Windows 8 apps). ### `_.support.funcNames` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1010 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1010 "View in source") [Ⓣ][1] (boolean): Detect if `Function#name` is supported (all but IE). @@ -6487,7 +6639,7 @@ the PlayStation 3; forced `false` for Windows 8 apps). ### `_.support.nodeTag` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1018 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1018 "View in source") [Ⓣ][1] (boolean): Detect if the `toStringTag` of DOM nodes is resolvable (all but IE < 9). @@ -6498,11 +6650,12 @@ the PlayStation 3; forced `false` for Windows 8 apps). ### `_.support.nonEnumShadows` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1039 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1039 "View in source") [Ⓣ][1] (boolean): Detect if properties shadowing those on `Object.prototype` are non-enumerable. - +
+
In IE < 9 an object's own properties, shadowing non-enumerable ones, are made non-enumerable as well (a.k.a the JScript `[[DontEnum]]` bug). @@ -6513,7 +6666,7 @@ are made non-enumerable as well (a.k.a the JScript `[[DontEnum]]` bug). ### `_.support.nonEnumStrings` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1027 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1027 "View in source") [Ⓣ][1] (boolean): Detect if string indexes are non-enumerable (IE < 9, RingoJS, Rhino, Narwhal). @@ -6525,7 +6678,7 @@ are made non-enumerable as well (a.k.a the JScript `[[DontEnum]]` bug). ### `_.support.ownLast` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1047 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1047 "View in source") [Ⓣ][1] (boolean): Detect if own properties are iterated after inherited properties (IE < 9). @@ -6536,11 +6689,12 @@ are made non-enumerable as well (a.k.a the JScript `[[DontEnum]]` bug). ### `_.support.spliceObjects` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1062 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1062 "View in source") [Ⓣ][1] (boolean): Detect if `Array#shift` and `Array#splice` augment array-like objects correctly. - +
+
Firefox < 10, compatibility modes of IE 8, and IE < 9 have buggy Array `shift()` and `splice()` functions that fail to remove the last element, `value[0]`, of array-like objects even though the `length` property is set to `0`. @@ -6554,10 +6708,11 @@ is buggy regardless of mode in IE < 9. ### `_.support.unindexedChars` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1073 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1073 "View in source") [Ⓣ][1] (boolean): Detect lack of support for accessing string characters by index. - +
+
IE < 8 can't access characters by index. IE 8 can only access characters by index on string literals, not string objects. @@ -6568,7 +6723,7 @@ by index on string literals, not string objects. ### `_.templateSettings` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1115 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1115 "View in source") [Ⓣ][1] (Object): By default, the template delimiters used by lodash are like those in embedded Ruby (ERB). Change the following template settings to use @@ -6581,7 +6736,7 @@ alternative delimiters. ### `_.templateSettings.escape` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1123 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1123 "View in source") [Ⓣ][1] (RegExp): Used to detect `data` property values to be HTML-escaped. @@ -6592,7 +6747,7 @@ alternative delimiters. ### `_.templateSettings.evaluate` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1131 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1131 "View in source") [Ⓣ][1] (RegExp): Used to detect code to be evaluated. @@ -6603,7 +6758,7 @@ alternative delimiters. ### `_.templateSettings.imports` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1155 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1155 "View in source") [Ⓣ][1] (Object): Used to import variables into the compiled template. @@ -6614,7 +6769,7 @@ alternative delimiters. ### `_.templateSettings.interpolate` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1139 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1139 "View in source") [Ⓣ][1] (RegExp): Used to detect `data` property values to inject. @@ -6625,7 +6780,7 @@ alternative delimiters. ### `_.templateSettings.variable` -# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.0/lodash.src.js#L1147 "View in source") [Ⓣ][1] +# [Ⓢ](https://github.com/lodash/lodash/blob/3.0.1/lodash.src.js#L1147 "View in source") [Ⓣ][1] (string): Used to reference the data object in the template text. diff --git a/lodash.js b/lodash.js index b2efca473f..1baaa037b3 100644 --- a/lodash.js +++ b/lodash.js @@ -1,6 +1,6 @@ /** * @license - * lodash 3.0.0 (Custom Build) + * lodash 3.0.1 (Custom Build) * Build: `lodash modern -o ./lodash.js` * Copyright 2012-2015 The Dojo Foundation * Based on Underscore.js 1.7.0 @@ -13,7 +13,7 @@ var undefined; /** Used as the semantic version number. */ - var VERSION = '3.0.0'; + var VERSION = '3.0.1'; /** Used to compose bitmasks for wrapper metadata. */ var BIND_FLAG = 1, @@ -1060,11 +1060,14 @@ * @returns {Object} Returns the new reversed `LazyWrapper` object. */ function lazyReverse() { - var filtered = this.filtered, - result = filtered ? new LazyWrapper(this) : this.clone(); - - result.dir = this.dir * -1; - result.filtered = filtered; + if (this.filtered) { + var result = new LazyWrapper(this); + result.dir = -1; + result.filtered = true; + } else { + result = this.clone(); + result.dir *= -1; + } return result; } @@ -1083,12 +1086,12 @@ } var dir = this.dir, isRight = dir < 0, - length = array.length, - view = getView(0, length, this.views), + view = getView(0, array.length, this.views), start = view.start, end = view.end, + length = end - start, dropCount = this.dropCount, - takeCount = nativeMin(end - start, this.takeCount - dropCount), + takeCount = nativeMin(length, this.takeCount - dropCount), index = isRight ? end : start - 1, iteratees = this.iteratees, iterLength = iteratees ? iteratees.length : 0, @@ -1124,7 +1127,7 @@ result[resIndex++] = value; } } - return isRight ? result.reverse() : result; + return result; } /*------------------------------------------------------------------------*/ @@ -1645,7 +1648,7 @@ // Handle "_.property" and "_.matches" style callback shorthands. return type == 'object' ? baseMatches(func, !argCount) - : baseProperty(argCount ? baseToString(func) : func); + : baseProperty(func + ''); } /** @@ -2375,6 +2378,9 @@ ? toPlainObject(value) : (isPlainObject(value) ? value : {}); } + else { + isCommon = false; + } } // Add the source value to the stack of traversed objects and associate // it with its merged value. @@ -2496,7 +2502,8 @@ if (end < 0) { end += length; } - length = start > end ? 0 : (end - start); + length = start > end ? 0 : (end - start) >>> 0; + start >>>= 0; var result = Array(length); while (++index < length) { @@ -3103,7 +3110,7 @@ return ''; } var padLength = length - strLength; - chars = chars == null ? ' ' : baseToString(chars); + chars = chars == null ? ' ' : (chars + ''); return repeat(chars, ceil(padLength / chars.length)).slice(0, padLength); } @@ -3296,7 +3303,7 @@ case stringTag: // Coerce regexes to strings and treat strings primitives and string // objects as equal. See https://es5.github.io/#x15.10.6.4 for more details. - return object == baseToString(other); + return object == (other + ''); } return false; } @@ -5314,6 +5321,9 @@ function wrapperReverse() { var value = this.__wrapped__; if (value instanceof LazyWrapper) { + if (this.__actions__.length) { + value = new LazyWrapper(this); + } return new LodashWrapper(value.reverse()); } return this.thru(function(value) { @@ -5689,7 +5699,7 @@ * @returns {Array|Object|string} Returns `collection`. * @example * - * _([1, 2, 3]).forEach(function(n) { console.log(n); }); + * _([1, 2, 3]).forEach(function(n) { console.log(n); }).value(); * // => logs each value from left to right and returns the array * * _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, function(n, key) { console.log(n, key); }); @@ -7105,7 +7115,7 @@ * // => 'FRED' * * // modifying the result cache - * upperCase.cache.set('fred, 'BARNEY'); + * upperCase.cache.set('fred', 'BARNEY'); * upperCase('fred'); * // => 'BARNEY' * @@ -9193,7 +9203,7 @@ /** * Converts `string` to kebab case (a.k.a. spinal case). - * See [Wikipedia](https://en.wikipedia.org/wiki/Letter_case#Computers) for + * See [Wikipedia](https://en.wikipedia.org/wiki/Letter_case#Special_case_styles) for * more details. * * @static @@ -10677,7 +10687,8 @@ // Add `LazyWrapper` methods to `lodash.prototype`. baseForOwn(LazyWrapper.prototype, function(func, methodName) { - var retUnwrapped = /^(?:first|last)$/.test(methodName); + var lodashFunc = lodash[methodName], + retUnwrapped = /^(?:first|last)$/.test(methodName); lodash.prototype[methodName] = function() { var value = this.__wrapped__, @@ -10690,12 +10701,12 @@ if (retUnwrapped && !chainAll) { return onlyLazy ? func.call(value) - : lodash[methodName](this.value()); + : lodashFunc.call(lodash, this.value()); } var interceptor = function(value) { var otherArgs = [value]; push.apply(otherArgs, args); - return lodash[methodName].apply(lodash, otherArgs); + return lodashFunc.apply(lodash, otherArgs); }; if (isLazy || isArray(value)) { var wrapper = onlyLazy ? value : new LazyWrapper(this), diff --git a/lodash.min.js b/lodash.min.js index 296b019b9f..63ec153771 100644 --- a/lodash.min.js +++ b/lodash.min.js @@ -1,85 +1,85 @@ /** * @license - * lodash 3.0.0 (Custom Build) lodash.com/license | Underscore.js 1.7.0 underscorejs.org/LICENSE + * lodash 3.0.1 (Custom Build) lodash.com/license | Underscore.js 1.7.0 underscorejs.org/LICENSE * Build: `lodash modern -o ./lodash.js` */ ;(function(){function n(n,t){if(n!==t){var r=n===n,e=t===t;if(n>t||!r||typeof n=="undefined"&&e)return 1;if(n=n&&9<=n&&13>=n||32==n||160==n||5760==n||6158==n||8192<=n&&(8202>=n||8232==n||8233==n||8239==n||8287==n||12288==n||65279==n) +}function i(n,t){for(var r=n.length;r--&&-1=n&&9<=n&&13>=n||32==n||160==n||5760==n||6158==n||8192<=n&&(8202>=n||8232==n||8233==n||8239==n||8287==n||12288==n||65279==n) }function v(n,t){for(var r=-1,e=n.length,u=-1,o=[];++re&&(e=u)}return e}function Yt(n,t,r,e){var u=-1,o=n.length;for(e&&o&&(r=n[++u]);++ue&&(e=u)}return e}function Yt(n,t,r,e){var u=-1,o=n.length;for(e&&o&&(r=n[++u]);++ui(r,f)&&u.push(f);return u}function or(n,t){var r=n?n.length:0;if(!ue(r))return gr(n,t);for(var e=-1,u=se(n);++ei(r,f)&&u.push(f);return u}function or(n,t){var r=n?n.length:0;if(!ue(r))return gr(n,t);for(var e=-1,u=se(n);++et&&(t=-t>u?0:u+t),r=typeof r=="undefined"||r>u?u:+r||0,0>r&&(r+=u),u=t>r?0:r-t,r=mu(u);++eu(f,s)&&((r||a)&&f.push(s),c.push(l))}return c}function Or(n,t){for(var r=-1,e=t.length,u=mu(e);++r>>1,i=n[o]; -(r?i<=t:it&&(t=-t>u?0:u+t),r=typeof r=="undefined"||r>u?u:+r||0,0>r&&(r+=u),u=t>r?0:r-t>>>0,t>>>=0,r=mu(u);++eu(f,s)&&((r||a)&&f.push(s),l.push(c))}return l}function Or(n,t){for(var r=-1,e=t.length,u=mu(e);++r>>1,i=n[o]; +(r?i<=t:it||null==r)return r;if(3=o&&a<=i&&(e=O&&t>u||e>u&&t>=O)||o)&&(t&x&&(r[2]=p[2],a|=e&x?0:j),(e=p[3])&&(u=r[3],r[3]=u?Fr(u,e,p[4]):zt(e),r[4]=u?v(r[3],B):zt(p[4])),(e=p[5])&&(u=r[5],r[5]=u?Ur(u,e,p[6]):zt(e),r[6]=u?v(r[5],B):zt(p[6])),(e=p[7])&&(r[7]=zt(e)),t&C&&(r[8]=null==r[8]?p[8]:uo(r[8],p[8])),null==r[9]&&(r[9]=p[9]),r[0]=p[0],r[1]=a),t=r[1],a=r[9]}return r[9]=null==a?f?0:n.length:eo(a-c,0)||0,(p?bo:Ao)(t==x?Br(r[0],r[2]):t!=R&&t!=(x|R)||r[4].length?qr.apply(null,r):Kr.apply(null,r),r) -}function Yr(n,t,r,e,u,o,i){var a=-1,f=n.length,c=t.length,l=true;if(f!=c&&(!u||c<=f))return false;for(;l&&++au)||i===e&&i===o)&&(u=i,o=n) +}function Br(n,t){function r(){return(this instanceof r?e:n).apply(t,arguments)}var e=Dr(n);return r}function zr(n){return function(t){var r=-1;t=cu(ou(t));for(var e=t.length,u="";++r=o&&a<=i&&(e=O&&t>u||e>u&&t>=O)||o)&&(t&x&&(r[2]=p[2],a|=e&x?0:j),(e=p[3])&&(u=r[3],r[3]=u?Fr(u,e,p[4]):zt(e),r[4]=u?v(r[3],B):zt(p[4])),(e=p[5])&&(u=r[5],r[5]=u?Ur(u,e,p[6]):zt(e),r[6]=u?v(r[5],B):zt(p[6])),(e=p[7])&&(r[7]=zt(e)),t&C&&(r[8]=null==r[8]?p[8]:uo(r[8],p[8])),null==r[9]&&(r[9]=p[9]),r[0]=p[0],r[1]=a),t=r[1],a=r[9]}return r[9]=null==a?f?0:n.length:eo(a-l,0)||0,(p?bo:Ao)(t==x?Br(r[0],r[2]):t!=R&&t!=(x|R)||r[4].length?qr.apply(null,r):Kr.apply(null,r),r) +}function Yr(n,t,r,e,u,o,i){var a=-1,f=n.length,l=t.length,c=true;if(f!=l&&(!u||l<=f))return false;for(;c&&++au)||i===e&&i===o)&&(u=i,o=n) }),o}function Xr(n,t,r){var e=Wt.callback||pu,e=e===pu?tr:e;return r?e(n,t,r):e}function Hr(n,r,e){var u=Wt.indexOf||de,u=u===de?t:u;return n?u(n,r,e):u}function Qr(n){var t=n.length,r=new n.constructor(t);return t&&"string"==typeof n[0]&&Nu.call(n,"index")&&(r.index=n.index,r.input=n.input),r}function ne(n){return n=n.constructor,typeof n=="function"&&n instanceof n||(n=ku),new n}function te(n,t,r){var e=n.constructor;switch(t){case J:return Nr(n);case M:case q:return new e(+n);case X:case H:case Q:case nt:case tt:case rt:case et:case ut:case ot:return t=n.buffer,new e(r?Nr(t):t,n.byteOffset,n.length); case V:case G:return new e(n);case Z:var u=new e(n.source,yt.exec(n));u.lastIndex=n.lastIndex}return u}function re(n,t){return n=+n,t=null==t?vo:t,-1t?0:t)):[]}function he(n,t,r){var e=n?n.length:0;return e?((r?ee(n,t,r):null==t)&&(t=1),t=e-(+t||0),Er(n,0,0>t?0:t)):[]}function ge(n,t,r){var e=-1,u=n?n.length:0;for(t=Xr(t,r,3);++ee?eo(u+e,0):e||0;else if(e)return e=Tr(n,r),n=n[e],(r===r?r===n:n!==n)?e:-1; -return t(n,r,e)}function ye(n){return pe(n,1)}function _e(n,r,e,u){if(!n||!n.length)return[];typeof r!="boolean"&&null!=r&&(u=e,e=ee(n,r,u)?null:r,r=false);var o=Xr();if((o!==tr||null!=e)&&(e=o(e,u,3)),r&&Hr()==t){r=e;var i;e=-1,u=n.length;for(var o=-1,a=[];++e>>0,e=mu(r);++tr?eo(e+r,0):r||0:0,typeof n=="string"||!To(n)&&Qe(n)?rarguments.length,or)}function Te(n,t,r,e){return(To(n)?Zt:kr)(n,Xr(t,e,4),r,3>arguments.length,ir)}function Se(n,t,r){return(r?ee(n,t,r):null==t)?(n=le(n),t=n.length,0t?0:+t||0,n.length),n) -}function We(n){n=le(n);for(var t=-1,r=n.length,e=mu(r);++t=r||r>t?(a&&Mu(a),r=p,a=s=p=b,r&&(h=Co(),f=n.apply(l,i),s||a||(i=l=null))):s=Zu(e,r)}function u(){s&&Mu(s),a=s=p=b,(v||g!==t)&&(h=Co(),f=n.apply(l,i),s||a||(i=l=null)) -}function o(){if(i=arguments,c=Co(),l=this,p=v&&(s||!d),false===g)var r=d&&!s;else{a||d||(h=c);var o=g-(c-h),y=0>=o||o>g;y?(a&&(a=Mu(a)),h=c,f=n.apply(l,i)):a||(a=Zu(u,o))}return y&&s?s=Mu(s):s||t===g||(s=Zu(e,t)),r&&(y=true,f=n.apply(l,i)),!y||s||a||(i=l=null),f}var i,a,f,c,l,s,p,h=0,g=false,v=true;if(!Ze(n))throw new Iu($);if(t=0>t?0:t,true===r)var d=true,v=false;else Ge(r)&&(d=r.leading,g="maxWait"in r&&eo(+r.maxWait||0,t),v="trailing"in r?r.trailing:v);return o.cancel=function(){s&&Mu(s),a&&Mu(a),a=s=p=b},o}function De(){var n=arguments,t=n.length-1; +return t(n,r,e)}function ye(n){return pe(n,1)}function _e(n,r,e,u){if(!n||!n.length)return[];typeof r!="boolean"&&null!=r&&(u=e,e=ee(n,r,u)?null:r,r=false);var o=Xr();if((o!==tr||null!=e)&&(e=o(e,u,3)),r&&Hr()==t){r=e;var i;e=-1,u=n.length;for(var o=-1,a=[];++e>>0,e=mu(r);++tr?eo(e+r,0):r||0:0,typeof n=="string"||!To(n)&&Qe(n)?rarguments.length,or)}function Te(n,t,r,e){return(To(n)?Zt:kr)(n,Xr(t,e,4),r,3>arguments.length,ir)}function Se(n,t,r){return(r?ee(n,t,r):null==t)?(n=ce(n),t=n.length,0t?0:+t||0,n.length),n) +}function We(n){n=ce(n);for(var t=-1,r=n.length,e=mu(r);++t=r||r>t?(a&&Mu(a),r=p,a=s=p=b,r&&(h=Co(),f=n.apply(c,i),s||a||(i=c=null))):s=Zu(e,r)}function u(){s&&Mu(s),a=s=p=b,(v||g!==t)&&(h=Co(),f=n.apply(c,i),s||a||(i=c=null)) +}function o(){if(i=arguments,l=Co(),c=this,p=v&&(s||!d),false===g)var r=d&&!s;else{a||d||(h=l);var o=g-(l-h),y=0>=o||o>g;y?(a&&(a=Mu(a)),h=l,f=n.apply(c,i)):a||(a=Zu(u,o))}return y&&s?s=Mu(s):s||t===g||(s=Zu(e,t)),r&&(y=true,f=n.apply(c,i)),!y||s||a||(i=c=null),f}var i,a,f,l,c,s,p,h=0,g=false,v=true;if(!Ze(n))throw new Iu($);if(t=0>t?0:t,true===r)var d=true,v=false;else Ge(r)&&(d=r.leading,g="maxWait"in r&&eo(+r.maxWait||0,t),v="trailing"in r?r.trailing:v);return o.cancel=function(){s&&Mu(s),a&&Mu(a),a=s=p=b},o}function De(){var n=arguments,t=n.length-1; if(0>t)return function(){};if(!qt(n,Ze))throw new Iu($);return function(){for(var r=t,e=n[r].apply(this,arguments);r--;)e=n[r].call(this,e);return e}}function Me(n,t){function r(){var e=r.cache,u=t?t.apply(this,arguments):arguments[0];if(e.has(u))return e.get(u);var o=n.apply(this,arguments);return e.set(u,o),o}if(!Ze(n)||t&&!Ze(t))throw new Iu($);return r.cache=new Me.Cache,r}function qe(n){var t=Er(arguments,1),r=v(t,qe.placeholder);return Vr(n,R,null,t,r)}function Pe(n){var t=Er(arguments,1),r=v(t,Pe.placeholder); return Vr(n,I,null,t,r)}function Ke(n){return ue(h(n)?n.length:b)&&Uu.call(n)==z||false}function Ve(n){return n&&1===n.nodeType&&h(n)&&-1t||!n||!to(t))return r;do t%2&&(r+=n),t=qu(t/2),n+=n;while(t);return r}function cu(n,t,r){var u=n;return(n=e(n))?(r?ee(u,t,r):null==t)?n.slice(d(n),y(n)+1):(t=e(t),n.slice(o(n,t),i(n,t)+1)):n}function lu(n,t,r){return r&&ee(n,t,r)&&(t=null),n=e(n),n.match(t||Rt)||[] +return u}function uu(n){return Or(n,Fo(n))}function ou(n){return(n=e(n))&&n.replace(wt,l)}function iu(n){return(n=e(n))&&jt.test(n)?n.replace(At,"\\$&"):n}function au(n,t,r){return r&&ee(n,t,r)&&(t=0),ao(n,t)}function fu(n,t){var r="";if(n=e(n),t=+t,1>t||!n||!to(t))return r;do t%2&&(r+=n),t=qu(t/2),n+=n;while(t);return r}function lu(n,t,r){var u=n;return(n=e(n))?(r?ee(u,t,r):null==t)?n.slice(d(n),y(n)+1):(t=e(t),n.slice(o(n,t),i(n,t)+1)):n}function cu(n,t,r){return r&&ee(n,t,r)&&(t=null),n=e(n),n.match(t||Rt)||[] }function su(n){try{return n()}catch(t){return Ye(t)?t:wu(t)}}function pu(n,t,r){return r&&ee(n,t,r)&&(t=null),tr(n,t)}function hu(n){return function(){return n}}function gu(n){return n}function vu(n){return wr(n,true)}function du(n,t,r){if(null==r){var e=Ge(t),u=e&&Fo(t);((u=u&&u.length&&dr(t,u))?u.length:e)||(u=false,r=t,t=n,n=this)}u||(u=dr(t,Fo(t)));var o=true,e=-1,i=Ze(n),a=u.length;false===r?o=false:Ge(r)&&"chain"in r&&(o=r.chain);for(;++e>>1,go=Hu?Hu.BYTES_PER_ELEMENT:0,vo=Au.pow(2,53)-1,yo=Xu&&new Xu,_o=Wt.support={};!function(n){_o.funcDecomp=!Je(g.WinRTError)&&kt.test(m),_o.funcNames=typeof xu.name=="string";try{_o.dom=11===Tu.createDocumentFragment().nodeType +}catch(r){}return t}(),Qu=Je(Qu=mu.isArray)&&Qu,no=Je(no=ku.create)&&no,to=g.isFinite,ro=Je(ro=ku.keys)&&ro,eo=Au.max,uo=Au.min,oo=Je(oo=bu.now)&&oo,io=Je(io=ju.isFinite)&&io,ao=g.parseInt,fo=Au.random,lo=ju.NEGATIVE_INFINITY,co=ju.POSITIVE_INFINITY,so=Au.pow(2,32)-1,po=so-1,ho=so>>>1,go=Hu?Hu.BYTES_PER_ELEMENT:0,vo=Au.pow(2,53)-1,yo=Xu&&new Xu,_o=Wt.support={};!function(n){_o.funcDecomp=!Je(g.WinRTError)&&kt.test(m),_o.funcNames=typeof xu.name=="string";try{_o.dom=11===Tu.createDocumentFragment().nodeType }catch(t){_o.dom=false}try{_o.nonEnumArgs=!Vu.call(arguments,1)}catch(r){_o.nonEnumArgs=true}}(0,0),Wt.templateSettings={escape:ht,evaluate:gt,interpolate:vt,variable:"",imports:{_:Wt}};var mo=function(){function n(){}return function(t){if(Ge(t)){n.prototype=t;var r=new n;n.prototype=null}return r||g.Object()}}(),bo=yo?function(n,t){return yo.set(n,t),n}:gu;zu||(Nr=Bu&&Ju?function(n){var t=n.byteLength,r=Hu?qu(t/go):0,e=r*go,u=new Bu(t);if(r){var o=new Hu(u,0,r);o.set(new Hu(n,0,r))}return t!=e&&(o=new Ju(u,e),o.set(new Ju(n,e))),u -}:hu(null));var wo=no&&Yu?function(n){return new Lt(n)}:hu(null),xo=yo?function(n){return yo.get(n)}:yu,Ao=function(){var n=0,t=0;return function(r,e){var u=Co(),o=N-(u-t);if(t=u,0=W)return r}else n=0;return bo(r,e)}}(),jo=Lr(function(n,t,r){Nu.call(n,r)?++n[r]:n[r]=1}),ko=Lr(function(n,t,r){Nu.call(n,r)?n[r].push(t):n[r]=[t]}),Eo=Lr(function(n,t,r){n[r]=t}),Ro=Mr(Vt),Io=Mr(function(n){for(var t=-1,r=n.length,e=lo;++t=W)return r}else n=0;return bo(r,e)}}(),jo=Lr(function(n,t,r){Nu.call(n,r)?++n[r]:n[r]=1}),ko=Lr(function(n,t,r){Nu.call(n,r)?n[r].push(t):n[r]=[t]}),Eo=Lr(function(n,t,r){n[r]=t}),Ro=Mr(Vt),Io=Mr(function(n){for(var t=-1,r=n.length,e=co;++t--n?t.apply(this,arguments):void 0}},Wt.ary=function(n,t,r){return r&&ee(n,t,r)&&(t=null),t=n&&null==t?n.length:eo(+t||0,0),Vr(n,C,null,null,null,null,t) -},Wt.assign=No,Wt.at=function(n){return ue(n?n.length:0)&&(n=le(n)),Qt(n,lr(arguments,false,false,1))},Wt.before=Fe,Wt.bind=Ue,Wt.bindAll=function(n){for(var t=n,r=1(s?Bt(s,a):o(l,a))){for(r=e;--r;){var p=u[r];if(0>(p?Bt(p,a):o(n[r],a)))continue n}s&&s.push(a),l.push(a)}return l},Wt.invert=function(n,t,r){r&&ee(n,t,r)&&(t=null),r=-1; -for(var e=Fo(n),u=e.length,o={};++rt?0:t)):[]},Wt.takeRight=function(n,t,r){var e=n?n.length:0;return e?((r?ee(n,t,r):null==t)&&(t=1),t=e-(+t||0),Er(n,0>t?0:t)):[] +},Wt.functions=ru,Wt.groupBy=ko,Wt.indexBy=Eo,Wt.initial=function(n){return he(n,1)},Wt.intersection=function(){for(var n=[],r=-1,e=arguments.length,u=[],o=Hr(),i=o==t;++r(s?Bt(s,a):o(c,a))){for(r=e;--r;){var p=u[r];if(0>(p?Bt(p,a):o(n[r],a)))continue n}s&&s.push(a),c.push(a)}return c},Wt.invert=function(n,t,r){r&&ee(n,t,r)&&(t=null),r=-1; +for(var e=Fo(n),u=e.length,o={};++rt?0:t)):[]},Wt.takeRight=function(n,t,r){var e=n?n.length:0;return e?((r?ee(n,t,r):null==t)&&(t=1),t=e-(+t||0),Er(n,0>t?0:t)):[] },Wt.takeRightWhile=function(n,t,r){var e=n?n.length:0;if(!e)return[];for(t=Xr(t,r,3);e--&&t(n[e],e,n););return Er(n,e+1)},Wt.takeWhile=function(n,t,r){var e=n?n.length:0;if(!e)return[];var u=-1;for(t=Xr(t,r,3);++un||!to(n))return[];var e=-1,u=mu(uo(n,so));for(t=Wr(t,r,1);++en||!to(n))return[];var e=-1,u=mu(uo(n,so));for(t=Wr(t,r,1);++er?0:+r||0,u))-t.length,0<=r&&n.indexOf(t,r)==r},Wt.escape=function(n){return(n=e(n))&&pt.test(n)?n.replace(lt,l):n},Wt.escapeRegExp=iu,Wt.every=je,Wt.find=Ee,Wt.findIndex=ge,Wt.findKey=function(n,t,r){return t=Xr(t,r,3),cr(n,t,gr,true) -},Wt.findLast=function(n,t,r){return t=Xr(t,r,3),cr(n,t,ir)},Wt.findLastIndex=function(n,t,r){var e=n?n.length:0;for(t=Xr(t,r,3);e--;)if(t(n[e],e,n))return e;return-1},Wt.findLastKey=function(n,t,r){return t=Xr(t,r,3),cr(n,t,vr,true)},Wt.findWhere=function(n,t){return Ee(n,vu(t))},Wt.first=ve,Wt.has=function(n,t){return n?Nu.call(n,t):false},Wt.identity=gu,Wt.includes=Ae,Wt.indexOf=de,Wt.isArguments=Ke,Wt.isArray=To,Wt.isBoolean=function(n){return true===n||false===n||h(n)&&Uu.call(n)==M||false},Wt.isDate=function(n){return h(n)&&Uu.call(n)==q||false +},Wt.clone=function(n,t,r,e){return typeof t!="boolean"&&null!=t&&(e=r,r=ee(n,t,e)?null:t,t=false),r=typeof r=="function"&&Wr(r,e,1),rr(n,t,r)},Wt.cloneDeep=function(n,t,r){return t=typeof t=="function"&&Wr(t,r,1),rr(n,true,t)},Wt.deburr=ou,Wt.endsWith=function(n,t,r){n=e(n),t+="";var u=n.length;return r=(typeof r=="undefined"?u:uo(0>r?0:+r||0,u))-t.length,0<=r&&n.indexOf(t,r)==r},Wt.escape=function(n){return(n=e(n))&&pt.test(n)?n.replace(ct,c):n},Wt.escapeRegExp=iu,Wt.every=je,Wt.find=Ee,Wt.findIndex=ge,Wt.findKey=function(n,t,r){return t=Xr(t,r,3),lr(n,t,gr,true) +},Wt.findLast=function(n,t,r){return t=Xr(t,r,3),lr(n,t,ir)},Wt.findLastIndex=function(n,t,r){var e=n?n.length:0;for(t=Xr(t,r,3);e--;)if(t(n[e],e,n))return e;return-1},Wt.findLastKey=function(n,t,r){return t=Xr(t,r,3),lr(n,t,vr,true)},Wt.findWhere=function(n,t){return Ee(n,vu(t))},Wt.first=ve,Wt.has=function(n,t){return n?Nu.call(n,t):false},Wt.identity=gu,Wt.includes=Ae,Wt.indexOf=de,Wt.isArguments=Ke,Wt.isArray=To,Wt.isBoolean=function(n){return true===n||false===n||h(n)&&Uu.call(n)==M||false},Wt.isDate=function(n){return h(n)&&Uu.call(n)==q||false },Wt.isElement=Ve,Wt.isEmpty=function(n){if(null==n)return true;var t=n.length;return ue(t)&&(To(n)||Qe(n)||Ke(n)||h(n)&&Ze(n.splice))?!t:!Fo(n).length},Wt.isEqual=function(n,t,r,e){return r=typeof r=="function"&&Wr(r,e,3),!r&&oe(n)&&oe(t)?n===t:(e=r?r(n,t):b,typeof e=="undefined"?_r(n,t,r):!!e)},Wt.isError=Ye,Wt.isFinite=So,Wt.isFunction=Ze,Wt.isMatch=function(n,t,r,e){var u=Fo(t),o=u.length;if(r=typeof r=="function"&&Wr(r,e,3),!r&&1==o){var i=u[0];if(e=t[i],oe(e))return null!=n&&e===n[i]&&Nu.call(n,i) }for(var i=mu(o),a=mu(o);o--;)e=i[o]=t[u[o]],a[o]=oe(e);return mr(n,u,i,a,r)},Wt.isNaN=function(n){return Xe(n)&&n!=+n},Wt.isNative=Je,Wt.isNull=function(n){return null===n},Wt.isNumber=Xe,Wt.isObject=Ge,Wt.isPlainObject=Wo,Wt.isRegExp=He,Wt.isString=Qe,Wt.isTypedArray=nu,Wt.isUndefined=function(n){return typeof n=="undefined"},Wt.kebabCase=$o,Wt.last=function(n){var t=n?n.length:0;return t?n[t-1]:b},Wt.lastIndexOf=function(n,t,r){var e=n?n.length:0;if(!e)return-1;var u=e;if(typeof r=="number")u=(0>r?eo(e+r,0):uo(r||0,e-1))+1; else if(r)return u=Tr(n,t,true)-1,n=n[u],(t===t?t===n:n!==n)?u:-1;if(t!==t)return p(n,u,true);for(;u--;)if(n[u]===t)return u;return-1},Wt.max=Ro,Wt.min=Io,Wt.noConflict=function(){return g._=Lu,this},Wt.noop=yu,Wt.now=Co,Wt.pad=function(n,t,r){n=e(n),t=+t;var u=n.length;return ur?0:+r||0,n.length),n.lastIndexOf(t,r)==r},Wt.template=function(n,t,r){var u=Wt.templateSettings;r&&ee(n,t,r)&&(t=r=null),n=e(n),t=Ht(Ht({},r||t),u,Xt),r=Ht(Ht({},t.imports),u.imports,Xt);var o,i,a=Fo(r),f=Or(r,a),c=0;r=t.interpolate||xt;var l="__p+='";r=Eu((t.escape||xt).source+"|"+r.source+"|"+(r===vt?dt:xt).source+"|"+(t.evaluate||xt).source+"|$","g"); -var p="sourceURL"in t?"//# sourceURL="+t.sourceURL+"\n":"";if(n.replace(r,function(t,r,e,u,a,f){return e||(e=u),l+=n.slice(c,f).replace(Et,s),r&&(o=true,l+="'+__e("+r+")+'"),a&&(i=true,l+="';"+a+";\n__p+='"),e&&(l+="'+((__t=("+e+"))==null?'':__t)+'"),c=f+t.length,t}),l+="';",(t=t.variable)||(l="with(obj){"+l+"}"),l=(i?l.replace(it,""):l).replace(at,"$1").replace(ft,"$1;"),l="function("+(t||"obj")+"){"+(t?"":"obj||(obj={});")+"var __t,__p=''"+(o?",__e=_.escape":"")+(i?",__j=Array.prototype.join;function print(){__p+=__j.call(arguments,'')}":";")+l+"return __p}",t=su(function(){return xu(a,p+"return "+l).apply(b,f) -}),t.source=l,Ye(t))throw t;return t},Wt.trim=cu,Wt.trimLeft=function(n,t,r){var u=n;return(n=e(n))?n.slice((r?ee(u,t,r):null==t)?d(n):o(n,e(t))):n},Wt.trimRight=function(n,t,r){var u=n;return(n=e(n))?(r?ee(u,t,r):null==t)?n.slice(0,y(n)+1):n.slice(0,i(n,e(t))+1):n},Wt.trunc=function(n,t,r){r&&ee(n,t,r)&&(t=null);var u=T;if(r=S,null!=t)if(Ge(t)){var o="separator"in t?t.separator:o,u="length"in t?+t.length||0:u;r="omission"in t?e(t.omission):r}else u=+t||0;if(n=e(n),u>=n.length)return n;if(u-=r.length,1>u)return r; -if(t=n.slice(0,u),null==o)return t+r;if(He(o)){if(n.slice(u).search(o)){var i,a=n.slice(0,u);for(o.global||(o=Eu(o.source,(yt.exec(o)||"")+"g")),o.lastIndex=0;n=o.exec(a);)i=n.index;t=t.slice(0,null==i?u:i)}}else n.indexOf(o,u)!=u&&(o=t.lastIndexOf(o),-1r?0:+r||0,n.length),n.lastIndexOf(t,r)==r},Wt.template=function(n,t,r){var u=Wt.templateSettings;r&&ee(n,t,r)&&(t=r=null),n=e(n),t=Ht(Ht({},r||t),u,Xt),r=Ht(Ht({},t.imports),u.imports,Xt);var o,i,a=Fo(r),f=Or(r,a),l=0;r=t.interpolate||xt;var c="__p+='";r=Eu((t.escape||xt).source+"|"+r.source+"|"+(r===vt?dt:xt).source+"|"+(t.evaluate||xt).source+"|$","g"); +var p="sourceURL"in t?"//# sourceURL="+t.sourceURL+"\n":"";if(n.replace(r,function(t,r,e,u,a,f){return e||(e=u),c+=n.slice(l,f).replace(Et,s),r&&(o=true,c+="'+__e("+r+")+'"),a&&(i=true,c+="';"+a+";\n__p+='"),e&&(c+="'+((__t=("+e+"))==null?'':__t)+'"),l=f+t.length,t}),c+="';",(t=t.variable)||(c="with(obj){"+c+"}"),c=(i?c.replace(it,""):c).replace(at,"$1").replace(ft,"$1;"),c="function("+(t||"obj")+"){"+(t?"":"obj||(obj={});")+"var __t,__p=''"+(o?",__e=_.escape":"")+(i?",__j=Array.prototype.join;function print(){__p+=__j.call(arguments,'')}":";")+c+"return __p}",t=su(function(){return xu(a,p+"return "+c).apply(b,f) +}),t.source=c,Ye(t))throw t;return t},Wt.trim=lu,Wt.trimLeft=function(n,t,r){var u=n;return(n=e(n))?n.slice((r?ee(u,t,r):null==t)?d(n):o(n,e(t))):n},Wt.trimRight=function(n,t,r){var u=n;return(n=e(n))?(r?ee(u,t,r):null==t)?n.slice(0,y(n)+1):n.slice(0,i(n,e(t))+1):n},Wt.trunc=function(n,t,r){r&&ee(n,t,r)&&(t=null);var u=T;if(r=S,null!=t)if(Ge(t)){var o="separator"in t?t.separator:o,u="length"in t?+t.length||0:u;r="omission"in t?e(t.omission):r}else u=+t||0;if(n=e(n),u>=n.length)return n;if(u-=r.length,1>u)return r; +if(t=n.slice(0,u),null==o)return t+r;if(He(o)){if(n.slice(u).search(o)){var i,a=n.slice(0,u);for(o.global||(o=Eu(o.source,(yt.exec(o)||"")+"g")),o.lastIndex=0;n=o.exec(a);)i=n.index;t=t.slice(0,null==i?u:i)}}else n.indexOf(o,u)!=u&&(o=t.lastIndexOf(o),-1u.dir,i.push({iteratee:Xr(n,e,3),type:t}),u }}),Mt(["drop","take"],function(n,t){var r=n+"Count",e=n+"While";Ft.prototype[n]=function(e){e=null==e?1:eo(+e||0,0);var u=this.clone();if(u.filtered){var o=u[r];u[r]=t?uo(o,e):o+e}else(u.views||(u.views=[])).push({size:e,type:n+(0>u.dir?"Right":"")});return u},Ft.prototype[n+"Right"]=function(t){return this.reverse()[n](t).reverse()},Ft.prototype[n+"RightWhile"]=function(n,t){return this.reverse()[e](n,t).reverse()}}),Mt(["first","last"],function(n,t){var r="take"+(t?"Right":"");Ft.prototype[n]=function(){return this[r](1).value()[0] }}),Mt(["initial","rest"],function(n,t){var r="drop"+(t?"":"Right");Ft.prototype[n]=function(){return this[r](1)}}),Mt(["pluck","where"],function(n,t){var r=t?"filter":"map",e=t?vu:_u;Ft.prototype[n]=function(n){return this[r](e(n))}}),Ft.prototype.dropWhile=function(n,t){var r,e,u=0>this.dir;return n=Xr(n,t,3),this.filter(function(t,o,i){return r=r&&(u?oe),e=o,r||(r=!n(t,o,i))})},Ft.prototype.reject=function(n,t){return n=Xr(n,t,3),this.filter(function(t,r,e){return!n(t,r,e)})},Ft.prototype.slice=function(n,t){n=null==n?0:+n||0; -var r=0>n?this.takeRight(-n):this.drop(n);return typeof t!="undefined"&&(t=+t||0,r=0>t?r.dropRight(-t):r.take(t-n)),r},gr(Ft.prototype,function(n,t){var r=/^(?:first|last)$/.test(t);Wt.prototype[t]=function(){function e(n){return n=[n],Ku.apply(n,o),Wt[t].apply(Wt,n)}var u=this.__wrapped__,o=arguments,i=this.__chain__,a=!!this.__actions__.length,f=u instanceof Ft,c=f&&!a;return r&&!i?c?n.call(u):Wt[t](this.value()):f||To(u)?(u=n.apply(c?u:new Ft(this),o),r||!a&&!u.actions||(u.actions||(u.actions=[])).push({func:xe,args:[e],thisArg:Wt}),new Nt(u,i)):this.thru(e) +var r=0>n?this.takeRight(-n):this.drop(n);return typeof t!="undefined"&&(t=+t||0,r=0>t?r.dropRight(-t):r.take(t-n)),r},gr(Ft.prototype,function(n,t){var r=Wt[t],e=/^(?:first|last)$/.test(t);Wt.prototype[t]=function(){function t(n){return n=[n],Ku.apply(n,o),r.apply(Wt,n)}var u=this.__wrapped__,o=arguments,i=this.__chain__,a=!!this.__actions__.length,f=u instanceof Ft,l=f&&!a;return e&&!i?l?n.call(u):r.call(Wt,this.value()):f||To(u)?(u=n.apply(l?u:new Ft(this),o),e||!a&&!u.actions||(u.actions||(u.actions=[])).push({func:xe,args:[t],thisArg:Wt}),new Nt(u,i)):this.thru(t) }}),Mt("concat join pop push shift sort splice unshift".split(" "),function(n){var t=Ou[n],r=/^(?:push|sort|unshift)$/.test(n)?"tap":"thru",e=/^(?:join|pop|shift)$/.test(n);Wt.prototype[n]=function(){var n=arguments;return e&&!this.__chain__?t.apply(this.value(),n):this[r](function(r){return t.apply(r,n)})}}),Ft.prototype.clone=function(){var n=this.actions,t=this.iteratees,r=this.views,e=new Ft(this.wrapped);return e.actions=n?zt(n):null,e.dir=this.dir,e.dropCount=this.dropCount,e.filtered=this.filtered,e.iteratees=t?zt(t):null,e.takeCount=this.takeCount,e.views=r?zt(r):null,e -},Ft.prototype.reverse=function(){var n=this.filtered,t=n?new Ft(this):this.clone();return t.dir=-1*this.dir,t.filtered=n,t},Ft.prototype.value=function(){var n=this.wrapped.value();if(!To(n))return Cr(n,this.actions);var t,r=this.dir,e=0>r,u=n.length;t=u;for(var o=this.views,i=0,a=-1,f=o?o.length:0;++a"'`]/g,st=RegExp(ct.source),pt=RegExp(lt.source),ht=/<%-([\s\S]+?)%>/g,gt=/<%([\s\S]+?)%>/g,vt=/<%=([\s\S]+?)%>/g,dt=/\$\{([^\\}]*(?:\\.[^\\}]*)*)\}/g,yt=/\w*$/,_t=/^\s*function[ \n\r\t]+\w/,mt=/^0[xX]/,bt=/^\[object .+?Constructor\]$/,wt=/[\xc0-\xd6\xd8-\xde\xdf-\xf6\xf8-\xff]/g,xt=/($^)/,At=/[.*+?^${}()|[\]\/\\]/g,jt=RegExp(At.source),kt=/\bthis\b/,Et=/['\n\r\u2028\u2029\\]/g,Rt=RegExp("[A-Z\\xc0-\\xd6\\xd8-\\xde]{2,}(?=[A-Z\\xc0-\\xd6\\xd8-\\xde][a-z\\xdf-\\xf6\\xf8-\\xff]+)|[A-Z\\xc0-\\xd6\\xd8-\\xde]?[a-z\\xdf-\\xf6\\xf8-\\xff]+|[A-Z\\xc0-\\xd6\\xd8-\\xde]+|[0-9]+","g"),It=" \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000",Ot="Array ArrayBuffer Date Error Float32Array Float64Array Function Int8Array Int16Array Int32Array Math Number Object RegExp Set String _ clearTimeout document isFinite parseInt setTimeout TypeError Uint8Array Uint8ClampedArray Uint16Array Uint32Array WeakMap window WinRTError".split(" "),Ct={}; +},Ft.prototype.reverse=function(){if(this.filtered){var n=new Ft(this);n.dir=-1,n.filtered=true}else n=this.clone(),n.dir*=-1;return n},Ft.prototype.value=function(){var n=this.wrapped.value();if(!To(n))return Cr(n,this.actions);var t,r=this.dir,e=0>r;t=n.length;for(var u=this.views,o=0,i=-1,a=u?u.length:0;++i"'`]/g,st=RegExp(lt.source),pt=RegExp(ct.source),ht=/<%-([\s\S]+?)%>/g,gt=/<%([\s\S]+?)%>/g,vt=/<%=([\s\S]+?)%>/g,dt=/\$\{([^\\}]*(?:\\.[^\\}]*)*)\}/g,yt=/\w*$/,_t=/^\s*function[ \n\r\t]+\w/,mt=/^0[xX]/,bt=/^\[object .+?Constructor\]$/,wt=/[\xc0-\xd6\xd8-\xde\xdf-\xf6\xf8-\xff]/g,xt=/($^)/,At=/[.*+?^${}()|[\]\/\\]/g,jt=RegExp(At.source),kt=/\bthis\b/,Et=/['\n\r\u2028\u2029\\]/g,Rt=RegExp("[A-Z\\xc0-\\xd6\\xd8-\\xde]{2,}(?=[A-Z\\xc0-\\xd6\\xd8-\\xde][a-z\\xdf-\\xf6\\xf8-\\xff]+)|[A-Z\\xc0-\\xd6\\xd8-\\xde]?[a-z\\xdf-\\xf6\\xf8-\\xff]+|[A-Z\\xc0-\\xd6\\xd8-\\xde]+|[0-9]+","g"),It=" \t\x0b\f\xa0\ufeff\n\r\u2028\u2029\u1680\u180e\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u202f\u205f\u3000",Ot="Array ArrayBuffer Date Error Float32Array Float64Array Function Int8Array Int16Array Int32Array Math Number Object RegExp Set String _ clearTimeout document isFinite parseInt setTimeout TypeError Uint8Array Uint8ClampedArray Uint16Array Uint32Array WeakMap window WinRTError".split(" "),Ct={}; Ct[X]=Ct[H]=Ct[Q]=Ct[nt]=Ct[tt]=Ct[rt]=Ct[et]=Ct[ut]=Ct[ot]=true,Ct[z]=Ct[D]=Ct[J]=Ct[M]=Ct[q]=Ct[P]=Ct[K]=Ct["[object Map]"]=Ct[V]=Ct[Y]=Ct[Z]=Ct["[object Set]"]=Ct[G]=Ct["[object WeakMap]"]=false;var Tt={};Tt[z]=Tt[D]=Tt[J]=Tt[M]=Tt[q]=Tt[X]=Tt[H]=Tt[Q]=Tt[nt]=Tt[tt]=Tt[V]=Tt[Y]=Tt[Z]=Tt[G]=Tt[rt]=Tt[et]=Tt[ut]=Tt[ot]=true,Tt[P]=Tt[K]=Tt["[object Map]"]=Tt["[object Set]"]=Tt["[object WeakMap]"]=false;var St={leading:false,maxWait:0,trailing:false},Wt={"\xc0":"A","\xc1":"A","\xc2":"A","\xc3":"A","\xc4":"A","\xc5":"A","\xe0":"a","\xe1":"a","\xe2":"a","\xe3":"a","\xe4":"a","\xe5":"a","\xc7":"C","\xe7":"c","\xd0":"D","\xf0":"d","\xc8":"E","\xc9":"E","\xca":"E","\xcb":"E","\xe8":"e","\xe9":"e","\xea":"e","\xeb":"e","\xcc":"I","\xcd":"I","\xce":"I","\xcf":"I","\xec":"i","\xed":"i","\xee":"i","\xef":"i","\xd1":"N","\xf1":"n","\xd2":"O","\xd3":"O","\xd4":"O","\xd5":"O","\xd6":"O","\xd8":"O","\xf2":"o","\xf3":"o","\xf4":"o","\xf5":"o","\xf6":"o","\xf8":"o","\xd9":"U","\xda":"U","\xdb":"U","\xdc":"U","\xf9":"u","\xfa":"u","\xfb":"u","\xfc":"u","\xdd":"Y","\xfd":"y","\xff":"y","\xc6":"Ae","\xe6":"ae","\xde":"Th","\xfe":"th","\xdf":"ss"},Nt={"&":"&","<":"<",">":">",'"':""","'":"'","`":"`"},Ft={"&":"&","<":"<",">":">",""":'"',"'":"'","`":"`"},Ut={"function":true,object:true},Lt={"\\":"\\","'":"'","\n":"n","\r":"r","\u2028":"u2028","\u2029":"u2029"},$t=Ut[typeof window]&&window!==(this&&this.window)?window:this,Bt=Ut[typeof exports]&&exports&&!exports.nodeType&&exports,Ut=Ut[typeof module]&&module&&!module.nodeType&&module,zt=Bt&&Ut&&typeof global=="object"&&global; !zt||zt.global!==zt&&zt.window!==zt&&zt.self!==zt||($t=zt);var zt=Ut&&Ut.exports===Bt&&Bt,Dt=m();typeof define=="function"&&typeof define.amd=="object"&&define.amd?($t._=Dt, define(function(){return Dt})):Bt&&Ut?zt?(Ut.exports=Dt)._=Dt:Bt._=Dt:$t._=Dt}).call(this); \ No newline at end of file diff --git a/lodash.src.js b/lodash.src.js index 8eba47acba..0fc2c68a9d 100644 --- a/lodash.src.js +++ b/lodash.src.js @@ -1,6 +1,6 @@ /** * @license - * lodash 3.0.0 + * lodash 3.0.1 * Copyright 2012-2015 The Dojo Foundation * Based on Underscore.js 1.7.0 * Copyright 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors @@ -12,7 +12,7 @@ var undefined; /** Used as the semantic version number. */ - var VERSION = '3.0.0'; + var VERSION = '3.0.1'; /** Used to compose bitmasks for wrapper metadata. */ var BIND_FLAG = 1, @@ -520,7 +520,7 @@ */ var isHostObject = (function() { try { - baseToString({ 'toString': 0 }); + Object({ 'toString': 0 } + ''); } catch(e) { return function() { return false; }; } @@ -1216,11 +1216,14 @@ * @returns {Object} Returns the new reversed `LazyWrapper` object. */ function lazyReverse() { - var filtered = this.filtered, - result = filtered ? new LazyWrapper(this) : this.clone(); - - result.dir = this.dir * -1; - result.filtered = filtered; + if (this.filtered) { + var result = new LazyWrapper(this); + result.dir = -1; + result.filtered = true; + } else { + result = this.clone(); + result.dir *= -1; + } return result; } @@ -1239,12 +1242,12 @@ } var dir = this.dir, isRight = dir < 0, - length = array.length, - view = getView(0, length, this.views), + view = getView(0, array.length, this.views), start = view.start, end = view.end, + length = end - start, dropCount = this.dropCount, - takeCount = nativeMin(end - start, this.takeCount - dropCount), + takeCount = nativeMin(length, this.takeCount - dropCount), index = isRight ? end : start - 1, iteratees = this.iteratees, iterLength = iteratees ? iteratees.length : 0, @@ -1280,7 +1283,7 @@ result[resIndex++] = value; } } - return isRight ? result.reverse() : result; + return result; } /*------------------------------------------------------------------------*/ @@ -1801,7 +1804,7 @@ // Handle "_.property" and "_.matches" style callback shorthands. return type == 'object' ? baseMatches(func, !argCount) - : baseProperty(argCount ? baseToString(func) : func); + : baseProperty(func + ''); } /** @@ -2534,6 +2537,9 @@ ? toPlainObject(value) : (isPlainObject(value) ? value : {}); } + else { + isCommon = false; + } } // Add the source value to the stack of traversed objects and associate // it with its merged value. @@ -2655,7 +2661,8 @@ if (end < 0) { end += length; } - length = start > end ? 0 : (end - start); + length = start > end ? 0 : (end - start) >>> 0; + start >>>= 0; var result = Array(length); while (++index < length) { @@ -3262,7 +3269,7 @@ return ''; } var padLength = length - strLength; - chars = chars == null ? ' ' : baseToString(chars); + chars = chars == null ? ' ' : (chars + ''); return repeat(chars, ceil(padLength / chars.length)).slice(0, padLength); } @@ -3455,7 +3462,7 @@ case stringTag: // Coerce regexes to strings and treat strings primitives and string // objects as equal. See https://es5.github.io/#x15.10.6.4 for more details. - return object == baseToString(other); + return object == (other + ''); } return false; } @@ -5499,6 +5506,9 @@ function wrapperReverse() { var value = this.__wrapped__; if (value instanceof LazyWrapper) { + if (this.__actions__.length) { + value = new LazyWrapper(this); + } return new LodashWrapper(value.reverse()); } return this.thru(function(value) { @@ -5874,7 +5884,7 @@ * @returns {Array|Object|string} Returns `collection`. * @example * - * _([1, 2, 3]).forEach(function(n) { console.log(n); }); + * _([1, 2, 3]).forEach(function(n) { console.log(n); }).value(); * // => logs each value from left to right and returns the array * * _.forEach({ 'one': 1, 'two': 2, 'three': 3 }, function(n, key) { console.log(n, key); }); @@ -7290,7 +7300,7 @@ * // => 'FRED' * * // modifying the result cache - * upperCase.cache.set('fred, 'BARNEY'); + * upperCase.cache.set('fred', 'BARNEY'); * upperCase('fred'); * // => 'BARNEY' * @@ -9418,7 +9428,7 @@ /** * Converts `string` to kebab case (a.k.a. spinal case). - * See [Wikipedia](https://en.wikipedia.org/wiki/Letter_case#Computers) for + * See [Wikipedia](https://en.wikipedia.org/wiki/Letter_case#Special_case_styles) for * more details. * * @static @@ -10902,7 +10912,8 @@ // Add `LazyWrapper` methods to `lodash.prototype`. baseForOwn(LazyWrapper.prototype, function(func, methodName) { - var retUnwrapped = /^(?:first|last)$/.test(methodName); + var lodashFunc = lodash[methodName], + retUnwrapped = /^(?:first|last)$/.test(methodName); lodash.prototype[methodName] = function() { var value = this.__wrapped__, @@ -10915,12 +10926,12 @@ if (retUnwrapped && !chainAll) { return onlyLazy ? func.call(value) - : lodash[methodName](this.value()); + : lodashFunc.call(lodash, this.value()); } var interceptor = function(value) { var otherArgs = [value]; push.apply(otherArgs, args); - return lodash[methodName].apply(lodash, otherArgs); + return lodashFunc.apply(lodash, otherArgs); }; if (isLazy || isArray(value)) { var wrapper = onlyLazy ? value : new LazyWrapper(this), diff --git a/package.json b/package.json index 3db59bb096..af5396d7b0 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "lodash", - "version": "3.0.0", + "version": "3.0.1", "main": "lodash.src.js", "private": true, "devDependencies": { diff --git a/test/test.js b/test/test.js index 1da01683af..ca393e0851 100644 --- a/test/test.js +++ b/test/test.js @@ -5153,6 +5153,14 @@ deepEqual(actual, { 'a': 2 }); }); + test('`_.' + methodName + '` should not treat `object` as `source`', 1, function() { + function Foo() {} + Foo.prototype.a = 1; + + var actual = func(new Foo, { 'b': 2 }); + ok(!_.has(actual, 'a')); + }); + test('`_.' + methodName + '` should not treat the second argument as a `customizer` callback', 2, function() { function callback() {} callback.b = 2; @@ -5368,6 +5376,7 @@ test('should not check for inherited properties', 1, function() { function Foo() {} Foo.prototype.a = 1; + strictEqual(_.has(new Foo, 'a'), false); }); @@ -5768,6 +5777,25 @@ skipTest(2); } }); + + test('should work in a lazy chain sequence', 2, function() { + if (!isNpm) { + var array = [1, 2, 3], + values = []; + + var actual = _(array).initial().filter(function(value) { + values.push(value); + return false; + }) + .value(); + + deepEqual(actual, []); + deepEqual(values, [1, 2]); + } + else { + skipTest(2); + } + }); }()); /*--------------------------------------------------------------------------*/ @@ -8987,6 +9015,21 @@ deepEqual(actual, { 'a': 1 }); }); + test('should not not error on DOM elements', 1, function() { + var object1 = { 'el': document && document.createElement('div') }, + object2 = { 'el': document && document.createElement('div') }, + pairs = [[{}, object1], [object2, object1]], + expected = _.map(pairs, _.constant(true)); + + var actual = _.map(pairs, function(pair) { + try { + return _.merge(pair[0], pair[1]).el === pair[1].el; + } catch(e) {} + }); + + deepEqual(actual, expected); + }); + test('should handle merging if `customizer` returns `undefined`', 2, function() { var actual = _.merge({ 'a': { 'b': [1, 1] } }, { 'a': { 'b': [0] } }, _.noop); deepEqual(actual, { 'a': { 'b': [0, 1] } }); @@ -10585,9 +10628,23 @@ deepEqual(_.uniq(actual).sort(), [0, 1]); }); + test('should support a `min` and `max` argument', 1, function() { + var min = 5, + max = 10; + + ok(_.some(array, function() { + var result = _.random(min, max); + return result >= min && result <= max; + })); + }); + test('should support not providing a `max` argument', 1, function() { + var min = 0, + max = 5; + ok(_.some(array, function() { - return _.random(5) !== 5; + var result = _.random(max); + return result >= min && result <= max; })); }); @@ -10596,7 +10653,8 @@ max = Math.pow(2, 62); ok(_.every(array, function() { - return _.random(min, max) >= min; + var result = _.random(min, max); + return result >= min && result <= max; })); ok(_.some(array, function() { @@ -11271,6 +11329,25 @@ } }); + test('should work in a lazy chain sequence', 2, function() { + if (!isNpm) { + var array = [1, 2, 3], + values = []; + + var actual = _(array).rest().filter(function(value) { + values.push(value); + return false; + }) + .value(); + + deepEqual(actual, []); + deepEqual(values, [2, 3]); + } + else { + skipTest(2); + } + }); + test('should be aliased', 1, function() { strictEqual(_.tail, _.rest); }); @@ -11637,8 +11714,8 @@ }); test('should coerce `start` and `end` to finite numbers', 1, function() { - var actual = [_.slice(array, '0', 1), _.slice(array, 0, '1'), _.slice(array, '1'), _.slice(array, NaN, 1), _.slice(array, 1, NaN)]; - deepEqual(actual, [[1], [1], [2, 3], [1], []]); + var actual = [_.slice(array, 0.1, 1.1), _.slice(array, '0', 1), _.slice(array, 0, '1'), _.slice(array, '1'), _.slice(array, NaN, 1), _.slice(array, 1, NaN)]; + deepEqual(actual, [[1], [1], [1], [2, 3], [1], []]); }); test('should work as an iteratee for `_.map`', 2, function() { @@ -14200,6 +14277,16 @@ } }); + test('should work in a lazy chain sequence', 1, function() { + if (!isNpm) { + var actual = _([1, 2, 3, null]).map(_.identity).reverse().value(); + deepEqual(actual, [null, 3, 2, 1]); + } + else { + skipTest(); + } + }); + test('should be lazy when in a lazy chain sequence', 2, function() { if (!isNpm) { var spy = { @@ -14220,6 +14307,21 @@ skipTest(2); } }); + + test('should would in a hybrid chain sequence', 2, function() { + if (!isNpm) { + var array = [1, 2, 3, null], + actual = _(array).map(_.identity).compact().reverse().value(); + + deepEqual(actual, [3, 2, 1]); + + actual = _([1, 2, 3, null]).map(_.identity).compact().pull(1).push(4).reverse().value() + deepEqual(actual, [4, 3, 2]); + } + else { + skipTest(2); + } + }); }()); /*--------------------------------------------------------------------------*/