sindresorhus / unique-random-array

Get consecutively unique elements from an array

unique-random-array

Get consecutively unique elements from an array

Useful for things like slideshows where you don't want to have the same slide twice in a row.

Install

npm install unique-random-array

Usage

import uniqueRandomArray from 'unique-random-array';

const random = uniqueRandomArray([1, 2, 3, 4]);

console.log(random(), random(), random(), random());
//=> 4 2 1 4

API

uniqueRandomArray(array)

Returns a function, that when called, will return a random element that's never the same as the previous, or undefined if the array is empty.

array

Type: unknown[]

Related

• unique-random - Generate random numbers that are consecutively unique
• random-int - Generate a random integer
• random-float - Generate a random float
• random-item - Get a random item from an array
• random-obj-key - Get a random key from an object
• random-obj-prop - Get a random property from an object
• crypto-random-string - Generate a cryptographically strong random string

unique-random-array's Issues

Issue with calling a function multiple times on an empty array

When passing an empty array as an argument, the first call to the function returns undefined, while the second call throws an error. It would be better to throw an error directly when passing an empty array, instead of throwing an error on the second call.

var b = await import("unique-random-array");
undefined
> var c = b.default([])
undefined
> c()
undefined
> c()
Uncaught RangeError: Maximum call stack size exceeded
    at Math.random (<anonymous>)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:6:10)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:9:69)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:9:69)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:9:69)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:9:69)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:9:69)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:9:69)
    at random (file:///Users/smile/Documents/muyu/pdd-pptr/node_modules/.pnpm/[email protected]/node_modules/unique-random/ind
ex.js:9:69)