npmpackage.info

@smakss/random-array-element

Selects a random array element without repetition.

2.0.3

MIT

TypeScript

265.00 B

10,802 1.8

Installations

npm install @smakss/random-array-element

Developer Guide

BETA

Typescript

Yes

Module System

ESM

Min. Node Version

>=18.0.0

Node Version

18.19.0

NPM Version

10.2.3 Pull Requests

Open

5

Total

66

Closed

49

Merged

12

Issues

Open

0

Total

0

Closed

0

Releases

Upgrade dependencies

v2.0.3

Published on 31 Dec 2023

Stable release of 2.0.2

v2.0.2

Published on 28 Nov 2023

Upgrade dependencies

v2.0.2-beta.0

Published on 28 Nov 2023

Update package.json and dependencies

v2.0.1

Published on 16 Nov 2023

Migrate to typescript and enhance DX tools

v2.0.0

Published on 04 Nov 2023

Migrate to typescript

v2.0.0-beta.0

Published on 04 Nov 2023

View all 49 releases

Contributors

Unable to fetch Contributors

View all 1 contributors

Languages

TypeScript

JavaScript

Shell

TypeScript (52.65%)

JavaScript (41.35%)

Shell (6.01%)

Developer

SMAKSS

Download Statistics

Total Downloads

10,802

Last Day

Last Week

Last Month

226

Last Year

1,157

GitHub Statistics

4 Stars

72 Commits

1 Watching

7 Branches

1 Contributors

Bundle Size

399.00 B

Minified

265.00 B

Minified + Gzipped

Bundlephobia

Maintainers

Package Meta Information

Latest Version

2.0.3

Package Id

@smakss/random-array-element@2.0.3

Unpacked Size

14.21 kB

Size

3.64 kB

File Count

NPM Version

10.2.3

Node Version

18.19.0

Publised On

31 Dec 2023

Total Downloads

Cumulative downloads

Total Downloads

10,802

Last day

-67.1%

Compared to previous day

Last week

-35.3%

Compared to previous week

Last month

276.7%

226

Compared to previous month

Last year

-56.9%

1,157

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

@commitlint/cli @commitlint/config-conventional @rollup/plugin-commonjs @rollup/plugin-node-resolve @rollup/plugin-typescript @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint husky lint-staged prettier rollup tslib typescript

Versions

Random Array Element without Repetition

npm NPM npm npm bundle size (scoped)

Selecting a random element from an array is simple with Math.random(). However, if you need to ensure that each element is only selected once until all elements have been chosen, @smakss/random-array-element is the ideal solution. Utilizing closures, this package allows you to initialize a function once and then repeatedly obtain unique, randomly-selected elements from your array, without repeats until the array is exhausted.

Demo

You can check the working demo on RunKit.

Installation

Install the package using npm or Yarn:

1npm i @smakss/random-array-element
2# or
3yarn add @smakss/random-array-element

Usage

To include it with CommonJS module you can do this:

1const randomArrayElement = require('@smakss/random-array-element');

For ECMAScript modules:

1import randomArrayElement from '@smakss/random-array-element';

Example usage:

1// Initialize once for an array
2const getRandomElement = randomArrayElement(['apple', 'banana', 'cherry']);
3
4console.log(getRandomElement()); // Result: 'banana' (example output)
5console.log(getRandomElement()); // Result: 'apple' (example output)
6// ...after all items have been returned, it resets.
7console.log(getRandomElement()); // Result: 'cherry' (example output)
8// ...continues to return a new random item.

If an empty or non-array input is passed, the function will return -1, indicating no selection can be made:

1const getRandomElement = randomArrayElement([]);
2console.log(getRandomElement()); // Result: -1

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines and details.

Code of Conduct

To ensure a welcoming and safe community, our Code of Conduct outlines expected behaviors for all participants.

No vulnerabilities found.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

6

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

Maintained

Determines if the project is "actively maintained".

0

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/ci.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:58: update your workflow using https://app.stepsecurity.io/secureworkflow/SMAKSS/random-array-element/npm-publish.yml/master?enable=pin
Info: 0 out of 13 GitHub-owned GitHubAction dependencies pinned

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

1.8

/10

Last Scanned on 2025-01-27

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More