arrayrandompicker

Select a random item from an array.

Usage no npm install needed!

<script type="module">
  import arrayrandompicker from 'https://cdn.skypack.dev/arrayrandompicker';
</script>

README

Select a random item from an array

Simple code to select a random item from an array of items

let arp = require("arrayrandompicker");
var input = [
                {name: "Ted", age : 34},
                {name: "Jill", age : 49},
                {name: "Harris", age : 19},
                {name: "Yuri", age : 345}
            ]
var output = arp.selectRandomArrayItem(input);

console.log(output);
// {name: "Ted", age : 34}

Or also return the Index of the randomly selected item

let arp = require("arrayrandompicker");
var input = [
                {name: "Ted", age : 34},
                {name: "Jill", age : 49},
                {name: "Harris", age : 19},
                {name: "Yuri", age : 345}
            ]
var output = arp.selectRandomArrayItem(input, true);

console.log(output);
/*
    {
        key: 2,
        value: {name: "Harris", age : 19}
    }
*/ 

Or also return a range items of the randomly selected items

let arp = require("arrayrandompicker");
var input = [
                {name: "Ted", age : 34},
                {name: "Jill", age : 49},
                {name: "Harris", age : 19},
                {name: "Yuri", age : 345}
            ]
var output = arp.selectRandomArrayItem(input, 2);

console.log(output);
/*
    [
        {name: "Jill", age : 49},
        {name: "Yuri", age : 345}
    ] 
*/ 

Or also return a range items of the randomly selected items

let arp = require("arrayrandompicker");
var input = [
                {name: "Ted", age : 34},
                {name: "Jill", age : 49},
                {name: "Harris", age : 19},
                {name: "Yuri", age : 345}
            ]
var output = arp.selectManyRepeatingRandomArrayItems(input, 6);

console.log(output);
/*
    [
        {name: "Ted", age : 34},
        {name: "Jill", age : 49},
        {name: "Harris", age : 19},
        {name: "Yuri", age : 345},
        {name: "Yuri", age : 345},
        {name: "Ted", age : 34}
    ] 
*/ 

I WANT IT ALL option

let arp = require("arrayrandompicker");
var input = [
                {name: "Ted", age : 34},
                {name: "Jill", age : 49},
                {name: "Harris", age : 19},
                {name: "Yuri", age : 345}
            ]
var output = arp.selectRandomArrayItem(input, {range:5,includeIndex:true,allowRepeats:true});

console.log(output);
/*
    [
        {
            key: 2,
            value: {name: "Harris", age : 19}
        },
        {
            key: 0,
            value: {name: "Ted", age : 34}
        },
        {
            key: 0,
            value: {name: "Ted", age : 34}
        },
        {
            key: 2,
            value: {name: "Harris", age : 19}
        },
        {
            key: 3,
            value: {name: "Yuri", age : 345}
        }
    ] 
*/ 

if you like check the rest of my projects at https://github.com/TechDevils and maybe checkout ko-fi