npmpackage.info

Gathering detailed insights and metrics for @smakss/random-array-element

@smakss/random-array-element - 2.0.3 | npmpackage.info

@smakss/random-array-element

Selects a random array element without repetition.

2.0.3

MIT

TypeScript

265.00 B

11,525 1.7

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

Updated on Dec 31, 2023

Stable release of 2.0.2

v2.0.2

Updated on Nov 28, 2023

Upgrade dependencies

v2.0.2-beta.0

Updated on Nov 28, 2023

Update package.json and dependencies

v2.0.1

Updated on Nov 16, 2023

Migrate to typescript and enhance DX tools

v2.0.0

Updated on Nov 04, 2023

Migrate to typescript

v2.0.0-beta.0

Updated on Nov 04, 2023

View All 49 releases

Languages

TypeScript

JavaScript

Shell

TypeScript (52.65%)

JavaScript (41.35%)

Shell (6.01%)

Developer

SMAKSS

Download Statistics

Total Downloads

11,525

Last Day

Last Week

Last Month

Last Year

1,770

GitHub Statistics

MIT License

4 Stars

72 Commits

1 Watchers

7 Branches

1 Contributors

Updated on Nov 04, 2023

Bundle Size

399.00 B

Minified

265.00 B

Minified + Gzipped

Bundlephobia

Maintainers

View All 1 Contributors

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

Published on

Dec 31, 2023

Total Downloads

Cumulative downloads

Total Downloads

11,525

Last Day

100%

Compared to previous day

Last Week

100%

Compared to previous week

Last Month

-76.1%

Compared to previous month

Last Year

-16.5%

1,770

Compared to previous year

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

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.

5

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

Code-Review

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

0

Dangerous-Workflow

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

0

Maintained

Determines if the project is "actively maintained".

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

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

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

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.7

/10

Last Scanned on 2025-06-30

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