head.js 415 B

123456789101112131415161718192021222324
  1. /**
  2. * Gets the first element of `array`.
  3. *
  4. * @static
  5. * @memberOf _
  6. * @since 0.1.0
  7. * @alias first
  8. * @category Array
  9. * @param {Array} array The array to query.
  10. * @returns {*} Returns the first element of `array`.
  11. * @example
  12. *
  13. * _.head([1, 2, 3]);
  14. * // => 1
  15. *
  16. * _.head([]);
  17. * // => undefined
  18. */
  19. function head(array) {
  20. return (array && array.length) ? array[0] : undefined;
  21. }
  22. module.exports = head;