https://github.com/ultirequiem/random_item
🎁 Get a random item from an array
https://github.com/ultirequiem/random_item
array deno javascript random typescript
Last synced: 11 months ago
JSON representation
🎁 Get a random item from an array
- Host: GitHub
- URL: https://github.com/ultirequiem/random_item
- Owner: UltiRequiem
- License: mit
- Created: 2021-10-23T22:09:36.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-01T00:03:15.000Z (about 2 years ago)
- Last Synced: 2025-05-05T19:59:20.337Z (about 1 year ago)
- Topics: array, deno, javascript, random, typescript
- Language: TypeScript
- Homepage: https://random-item.js.org
- Size: 60.5 KB
- Stars: 7
- Watchers: 2
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
# random_item
[](https://codecov.io/gh/ultirequiem/random_item)
[](https://doc.deno.land/https/deno.land/x/random_item/mod.ts)
Get a random item from an array
## Usage
The API is the same on all this platforms ✔️
### [Deno 🦕](https://deno.land/x/random_item)
```typescript
import {
randomItem,
randomMultipleItems,
} from "https://deno.land/x/random_item/mod.ts";
randomItem(["🐴", "🦄", "🌈"]); //=> '🦄'
randomMultipleItems(["🐴", "🦄", "🌈"], 2); //=> ['🌈', '🦄']
randomItem([...new Set(["🐴", "🦄", "🌈"])]); //=> '🌈'
```
### [Node.js 🦖](https://npmjs.com/package/@ultirequiem/random-item)
```ts
import { randomItem, randomMultipleItems } from "@ultirequiem/random-item";
```
### [Browser 🌐](https://developer.mozilla.org/en-US/docs/Glossary/Browser)
You can use any [CDN](https://en.wikipedia.org/wiki/Content_delivery_network) 🔥
Eg 👉
[ESM](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) ↔️
[SkyPack](https://cdn.skypack.dev/@ultirequiem/random-item) 🆚
[Script Tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script)
↔️ [JSDelivr](https://cdn.jsdelivr.net/npm/@ultirequiem/random-item)
## Documentation
Is hosted on
[Deno Doc](https://doc.deno.land/https://deno.land/x/random_item/mod.ts) 📚
## CLI
### Install
- **Deno 🎃**
```sh
deno install https://deno.land/x/random_item/random_item.ts
```
- **Node.js 🐼**
```sh
npm install -g @ultirequiem/random-item
```
### Usage
```sh
random_item --help
```
[A binary for multiple platforms is provided too!](https://github.com/UltiRequiem/random-item/releases/latest)
[Video Showcase](https://youtu.be/LnQduW2ongY)
## Support
Open an Issue, I will check it a soon as possible 👀
If you want to hurry me up a bit
[send me a tweet](https://twitter.com/UltiRequiem) 😆
Consider [supporting me on Patreon](https://patreon.com/UltiRequiem) if you like
my work 🙏
Don't forget to star the repo ⭐
## Versioning
We use [Semantic Versioning](http://semver.org). For the versions available, see
the [tags](https://github.com/UltiRequiem/random_item/tags) 🏷️
## Authors
[Eliaz Bobadilla (a.k.a UltiRequiem)](https://ultirequiem.com) - Creator and
Maintainer 💪
See also the full list of
[contributors](https://github.com/UltiRequiem/random_item/contributors) who
participated in this project ✨
## Licence
Licensed under the MIT License 📄