mirror of
https://github.com/whoisclebs/lodash.git
synced 2026-01-31 07:17:50 +00:00
32 lines
686 B
JavaScript
32 lines
686 B
JavaScript
import isIndex from './.internal/isIndex.js'
|
|
|
|
/**
|
|
* Gets the element at index `n` of `array`. If `n` is negative, the nth
|
|
* element from the end is returned.
|
|
*
|
|
* @since 4.11.0
|
|
* @category Array
|
|
* @param {Array} array The array to query.
|
|
* @param {number} [n=0] The index of the element to return.
|
|
* @returns {*} Returns the nth element of `array`.
|
|
* @example
|
|
*
|
|
* const array = ['a', 'b', 'c', 'd']
|
|
*
|
|
* nth(array, 1)
|
|
* // => 'b'
|
|
*
|
|
* nth(array, -2)
|
|
* // => 'c'
|
|
*/
|
|
function nth(array, n) {
|
|
const length = array == null ? 0 : array.length
|
|
if (!length) {
|
|
return
|
|
}
|
|
n += n < 0 ? length : 0
|
|
return isIndex(n, length) ? array[n] : undefined
|
|
}
|
|
|
|
export default nth
|