https://github.com/jocafa/Nonsense

Generate repeatable random data in JS
https://github.com/jocafa/Nonsense

Last synced: 3 days ago
JSON representation

Generate repeatable random data in JS

• Host: GitHub
• URL: https://github.com/jocafa/Nonsense
• Owner: jocafa
• Created: 2010-12-28T02:01:50.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2019-10-07T08:21:09.000Z (about 5 years ago)
• Last Synced: 2024-10-26T13:17:10.475Z (18 days ago)
• Language: JavaScript
• Homepage:
• Size: 185 KB
• Stars: 179
• Watchers: 9
• Forks: 10
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
Nonsense

========

Generate repeatable random data in JS

Inspired by [Faker.js](http://github.com/Marak/Faker.js)

Uses slightly modified [Alea PRNG](http://baagoe.org/en/wiki/Alea)

## Getting started

For the server, install Nonsense via [npm][npm].

```shell

npm install Nonsense

```

For the browser, download [Nonsense.js][nonsense.js], and include it as a script tag.

```html

  var ns = new Nonsense();

  ns.integer(); // Random integer between 0 and 2^32

```

[npm]: https://npmjs.org/

[nonsense.js]: https://raw.github.com/jocafa/Nonsense/master/Nonsense.js

## Usage

### Instantiation

To create a new Nonsense instance, do `var ns = new Nonsense();`. You can pass any number of arbitrary arguments to the `Nonsense()` constructor to be used as seed data. If you don't pass anything, it will just use the default.

### Seeding

If you want to reset the seed of an instance you already have, call `ns.sow()` and pass in the seed data you want to use. The constructor calls `sow()` internally on instantiation.

### Numbers

  - `integer()` - returns a random integer between 0 and 2^32

  - `frac()` - returns a random real number between 0 and 1

  - `real()` - returns a random real number between 0 and 2^32

  - `integerInRange(min, max)` - returns a random integer between min and max

  - `realInRange(min, max)` - returns a random real number between min and max

  - `normal()` - returns a random real number between -1 and 1

### Utilities

  - `uuid()` - returns a valid v4 UUID hex string

  - `pick(array)` - returns a random member of `array`

  - `weightedPick(array)` - returns a random member of `array`, favoring the earlier entries

  - `timestamp(min, max)` - returns a random timestamp between min and max, or between the beginning of 2000 and the end of 2020 if min and max aren't specified

### Language

  - `word()` - returns a random word of lipsum

  - `words(n)` - returns `n` random words of lipsum, 3 if not specified

  - `sentence()` - returns a random lipsum sentence

  - `sentences(n)` - returns `n` random lipsum sentences, 3 if not specified

### Miscellaneous

  - `firstName()` - returns a random common first name

  - `lastName()` - returns a random common last name

  - `name()` - returns a random first and last name

  - `jobTitle()` - returns a random job title

  - `buzzPhrase()` - returns a random web 2.0 business plan... 

License

-------

Do whatever you want with this code. The consequenses of your actions are your own responsibility.