# random-value-generator
> A simple, zero-dependency package that can generate random values.
Latest version **0.2.0** (published 2019-04-29) · MIT license · 0 weekly downloads
## Install
```sh
npm install random-value-generator
pnpm add random-value-generator
yarn add random-value-generator
bun add random-value-generator
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support; pre 1.0.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 0.2.0 |
| Published | 2019-04-29 |
| First published | 2019-03-10 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8.0.0 |
| Dependencies | 0 |
| Unpacked size | 120.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | vanishedvan |
| Maintainers | vanishedvan |
| Keywords | random, value, generator, generation |
## Links
- npm: https://www.npmjs.com/package/random-value-generator
- Repository: https://github.com/vanishedvan/random-value-generator
- Issues: https://github.com/vanishedvan/random-value-generator/issues
- npm.io page: https://npm.io/package/random-value-generator
## Recent versions
- 0.2.0 (latest) — 2019-04-29
- 0.1.3 — 2019-03-24
- 0.1.2 — 2019-03-12
- 0.1.1 — 2019-03-10
- 0.0.1 — 2019-03-10
## README
# [random-value-generator][NPM Package]
## Badges
[](https://discord.gg/QgxZuHk) [](/LICENSE) [][NPM Package] [][NPM Package] [](https://nodejs.org/) [](https://travis-ci.com/vanishedvan/random-value-generator) [](https://github.com/vanishedvan/random-value-generator)
[][NPM Package]
## Introduction
A simple, zero-dependency package that can generate random\* values.
\*: This package does NOT provide cryptographically secure random value generation!
## List of functions
```
- randomNumber(max);
- randomInteger(max);
- randomBoolean();
- randomString(len);
- randomHash(len);
- randomEmoji();
```
Please note that `max` is the maximum value of the returned number, and `len` is the length of the returned string. Both kinds of parameters **MUST** be numbers.
## For the Web
[UNPKG](https://unpkg.com/) can be used as CDN to deliver the script.
Loading the script:
```
```
Alternatively, script utilizing ES Module can be used:
```
```
## Installation
Install the module with your terminal/console using:
```
npm i random-value-generator
```
Defining the module in your code:
* CommonJS:
```
const random = require("random-value-generator");
```
* ES:
```
import random from "random-value-generator/index.mjs";
```
## Examples
[Try the online demo](https://lightwayup.github.io/random-value-generator/).
```
/**
* Logs a random number.
*/
console.log(random.randomNumber(max));
/**
* Logs a random integer.
*/
console.log(random.randomInteger(max));
/**
* Logs a random boolean. - true or false
*/
console.log(random.randomBoolean());
/**
* Logs a random string consisting alphanumeric and special characters.
*/
console.log(random.randomString(len));
/**
* Logs a random string consisting alphanumeric characters.
*/
console.log(random.randomHash(len));
/**
* Logs a random emoji.
*/
console.log(random.randomEmoji());
```
## API Documentations
[View API documentations](/API_DOCS.md).
## Changelog
[View changelog](/CHANGELOG.md).
## Building from Source
[View build instructions](/BUILD_INSTRUCTIONS.md).
## Links
NPM: https://www.npmjs.com/package/random-value-generator
Discord: https://discord.gg/QgxZuHk
## License
This project is licensed under [MIT License](/LICENSE).
> Copyright (c) 2019 vanished
>
> Permission is hereby granted, free of charge, to any person obtaining a copy
> of this software and associated documentation files (the "Software"), to deal
> in the Software without restriction, including without limitation the rights
> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
> copies of the Software, and to permit persons to whom the Software is
> furnished to do so, subject to the following conditions:
>
> The above copyright notice and this permission notice shall be included in all
> copies or substantial portions of the Software.
>
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
> SOFTWARE.
[NPM Package]: https://www.npmjs.com/package/random-value-generator
---
_Source: https://npm.io/package/random-value-generator · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._