| 1 | import arraySample from './_arraySample.js';
|
| 2 | import baseSample from './_baseSample.js';
|
| 3 | import isArray from './isArray.js';
|
| 4 |
|
| 5 | /**
|
| 6 | * Gets a random element from `collection`.
|
| 7 | *
|
| 8 | * @static
|
| 9 | * @memberOf _
|
| 10 | * @since 2.0.0
|
| 11 | * @category Collection
|
| 12 | * @param {Array|Object} collection The collection to sample.
|
| 13 | * @returns {*} Returns the random element.
|
| 14 | * @example
|
| 15 | *
|
| 16 | * _.sample([1, 2, 3, 4]);
|
| 17 | * // => 2
|
| 18 | */
|
| 19 | function sample(collection) {
|
| 20 | var func = isArray(collection) ? arraySample : baseSample;
|
| 21 | return func(collection);
|
| 22 | }
|
| 23 |
|
| 24 | export default sample;
|