lodash.first - npm Package Compare versions

Comparing version 2.4.1 to 3.0.0

index.js

 /**
- * Lo-Dash 2.4.1 (Custom Build) <http://lodash.com/>
- * Build: `lodash modularize modern exports="npm" -o ./npm/`
- * Copyright 2012-2013 The Dojo Foundation <http://dojofoundation.org/>
- * Based on Underscore.js 1.5.2 <http://underscorejs.org/LICENSE>
- * Copyright 2009-2013 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
- * Available under MIT license <http://lodash.com/license>
+ * lodash 3.0.0 (Custom Build) <https://lodash.com/>
+ * Build: `lodash modern modularize exports="npm" -o ./`
+ * Copyright 2012-2015 The Dojo Foundation <http://dojofoundation.org/>
+ * Based on Underscore.js 1.7.0 <http://underscorejs.org/LICENSE>
+ * Copyright 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
+ * Available under MIT license <https://lodash.com/license>
  */
-var createCallback = require('lodash.createcallback'),
-    slice = require('lodash._slice');
 
-/* Native method shortcuts for methods with the same name as other `lodash` methods */
-var nativeMax = Math.max,
-    nativeMin = Math.min;
-
 /**
- * Gets the first element or first `n` elements of an array. If a callback
- * is provided elements at the beginning of the array are returned as long
- * as the callback returns truey. The callback is bound to `thisArg` and
- * invoked with three arguments; (value, index, array).
+ * Gets the first element of `array`.
  *
- * If a property name is provided for `callback` the created "_.pluck" style
- * callback will return the property value of the given element.
- *
- * If an object is provided for `callback` the created "_.where" style callback
- * will return `true` for elements that have the properties of the given object,
- * else `false`.
- *
  * @static
  * @memberOf _
- * @alias head, take
- * @category Arrays
+ * @alias head
+ * @category Array
  * @param {Array} array The array to query.
- * @param {Function|Object|number|string} [callback] The function called
- *  per element or the number of elements to return. If a property name or
- *  object is provided it will be used to create a "_.pluck" or "_.where"
- *  style callback, respectively.
- * @param {*} [thisArg] The `this` binding of `callback`.
- * @returns {*} Returns the first element(s) of `array`.
+ * @returns {*} Returns the first element of `array`.
  * @example
@@ -45,43 +24,9 @@ *
  *
- * _.first([1, 2, 3], 2);
- * // => [1, 2]
- *
- * _.first([1, 2, 3], function(num) {
- *   return num < 3;
- * });
- * // => [1, 2]
- *
- * var characters = [
- *   { 'name': 'barney',  'blocked': true,  'employer': 'slate' },
- *   { 'name': 'fred',    'blocked': false, 'employer': 'slate' },
- *   { 'name': 'pebbles', 'blocked': true,  'employer': 'na' }
- * ];
- *
- * // using "_.pluck" callback shorthand
- * _.first(characters, 'blocked');
- * // => [{ 'name': 'barney', 'blocked': true, 'employer': 'slate' }]
- *
- * // using "_.where" callback shorthand
- * _.pluck(_.first(characters, { 'employer': 'slate' }), 'name');
- * // => ['barney', 'fred']
+ * _.first([]);
+ * // => undefined
  */
-function first(array, callback, thisArg) {
-  var n = 0,
-      length = array ? array.length : 0;
-
-  if (typeof callback != 'number' && callback != null) {
-    var index = -1;
-    callback = createCallback(callback, thisArg, 3);
-    while (++index < length && callback(array[index], index, array)) {
-      n++;
-    }
-  } else {
-    n = callback;
-    if (n == null || thisArg) {
-      return array ? array[0] : undefined;
-    }
-  }
-  return slice(array, 0, nativeMin(nativeMax(0, n), length));
+function first(array) {
+  return array ? array[0] : undefined;
 }
 
 module.exports = first;

LICENSE.txt

@@ -1,3 +0,3 @@
-Copyright 2012-2013 The Dojo Foundation <http://dojofoundation.org/>
-Based on Underscore.js 1.5.2, copyright 2009-2013 Jeremy Ashkenas,
+Copyright 2012-2015 The Dojo Foundation <http://dojofoundation.org/>
+Based on Underscore.js 1.7.0, copyright 2009-2015 Jeremy Ashkenas,
 DocumentCloud and Investigative Reporters & Editors <http://underscorejs.org/>
@@ -22,2 +22,2 @@
 OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package.json

 {
   "name": "lodash.first",
-  "version": "2.4.1",
-  "description": "The Lo-Dash function `_.first` as a Node.js module generated by lodash-cli.",
-  "homepage": "http://lodash.com/custom-builds",
+  "version": "3.0.0",
+  "description": "The modern build of lodash’s `_.first` as a module.",
+  "homepage": "https://lodash.com/",
+  "icon": "https://lodash.com/icon.svg",
   "license": "MIT",
-  "keywords": ["functional", "lodash", "lodash-modularized", "server", "util"],
+  "keywords": "lodash, lodash-modularized, stdlib, util",
   "author": "John-David Dalton <[e-mail]> (http://allyoucanleet.com/)",
   "contributors": [
     "John-David Dalton <[e-mail]> (http://allyoucanleet.com/)",
+    "Benjamin Tan <[e-mail]> (https://d10.github.io/)",
     "Blaine Bublitz <[e-mail]> (http://www.iceddev.com/)",
     "Kit Cambridge <[e-mail]> (http://kitcambridge.be/)",
-    "Mathias Bynens <[e-mail]> (http://mathiasbynens.be/)"
+    "Mathias Bynens <[e-mail]> (https://mathiasbynens.be/)"
   ],
-  "bugs": "https://github.com/lodash/lodash-cli/issues",
-  "repository": { "type": "git", "url": "https://github.com/lodash/lodash-cli.git" },
-  "dependencies": {
-    "lodash.createcallback": "~2.4.1",
-    "lodash._slice": "~2.4.1"
-  }
+  "repository": "lodash/lodash",
+  "scripts": { "test": "echo \"See https://travis-ci.org/lodash/lodash-cli for testing details.\"" }
 }

README.md

@@ -1,15 +0,20 @@
-# lodash.first v2.4.1
+# lodash.first v3.0.0
 
-The [Lo-Dash](http://lodash.com/) function [`_.first`](http://lodash.com/docs#first) as a [Node.js](http://nodejs.org/) module generated by [lodash-cli](https://npmjs.org/package/lodash-cli).
+The [modern build](https://github.com/lodash/lodash/wiki/Build-Differences) of [lodash’s](https://lodash.com/) `_.first` exported as a [Node.js](http://nodejs.org/)/[io.js](https://iojs.org/) module.
 
-## Author
+## Installation
 
-| [![twitter/jdalton](http://gravatar.com/avatar/299a3d891ff1920b69c364d061007043?s=70)](https://twitter.com/jdalton "Follow @jdalton on Twitter") |
-|---|
-| [John-David Dalton](http://allyoucanleet.com/) |
+Using npm:
 
-## Contributors
+```bash
+$ {sudo -H} npm i -g npm
+$ npm i --save lodash.first
+```
 
-| [![twitter/blainebublitz](http://gravatar.com/avatar/ac1c67fd906c9fecd823ce302283b4c1?s=70)](https://twitter.com/blainebublitz "Follow @BlaineBublitz on Twitter") | [![twitter/kitcambridge](http://gravatar.com/avatar/6662a1d02f351b5ef2f8b4d815804661?s=70)](https://twitter.com/kitcambridge "Follow @kitcambridge on Twitter") | [![twitter/mathias](http://gravatar.com/avatar/24e08a9ea84deb17ae121074d0f17125?s=70)](https://twitter.com/mathias "Follow @mathias on Twitter") |
-|---|---|---|
-| [Blaine Bublitz](http://www.iceddev.com/) | [Kit Cambridge](http://kitcambridge.be/) | [Mathias Bynens](http://mathiasbynens.be/) |
+In Node.js/io.js:
+
+```js
+var first = require('lodash.first');
+```
+
+See the [documentation](https://lodash.com/docs#first) or [package source](https://github.com/lodash/lodash/blob/3.0.0-npm-packages/lodash.first) for more details.

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

No bug tracker

Maintenance

Package does not have a linked bug tracker in package.json.

Found 1 instance in 1 package

No repository

Supply chain risk

Package does not have a linked source code repository. Without this field, a package will have no reference to the location of the source code use to generate the package.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Dependency count

0

decreased by-100%

Number of lines in readme file

21

increased by31.25%

Worsened metrics

Total package byte prevSize

3474

decreased by-44.04%

Lines of code

29

decreased by-64.63%

Number of low supply chain risk alerts

1

increased byInfinity%

Dependency changes

• - Removedlodash._slice@~2.4.1

• - Removedlodash.createcallback@~2.4.1

• - Removedlodash._arraypool@2.4.1(transitive)

• - Removedlodash._basebind@2.4.1(transitive)

• - Removedlodash._basecreate@2.4.1(transitive)

• - Removedlodash._basecreatecallback@2.4.1(transitive)

• - Removedlodash._basecreatewrapper@2.4.1(transitive)

• - Removedlodash._baseisequal@2.4.1(transitive)

• - Removedlodash._createwrapper@2.4.1(transitive)

• - Removedlodash._getarray@2.4.1(transitive)

• - Removedlodash._isnative@2.4.1(transitive)

• - Removedlodash._maxpoolsize@2.4.1(transitive)

• - Removedlodash._objecttypes@2.4.1(transitive)

• - Removedlodash._releasearray@2.4.1(transitive)

• - Removedlodash._setbinddata@2.4.1(transitive)

• - Removedlodash._shimkeys@2.4.1(transitive)

• - Removedlodash._slice@2.4.1(transitive)

• - Removedlodash.bind@2.4.1(transitive)

• - Removedlodash.createcallback@2.4.4(transitive)

• - Removedlodash.forin@2.4.1(transitive)

• - Removedlodash.identity@2.4.1(transitive)

• - Removedlodash.isfunction@2.4.1(transitive)

• - Removedlodash.isobject@2.4.1(transitive)

• - Removedlodash.keys@2.4.1(transitive)

• - Removedlodash.noop@2.4.1(transitive)

• - Removedlodash.property@2.4.1(transitive)

• - Removedlodash.support@2.4.1(transitive)