This is a fork

This fork contains a german locale for these data types:

• first name (1.6k female and 1.2k male)
• gender title
• last name (3.4k names)
• streetnames (7.2k real names)
• cities with postcal codes (13.7k real combinations)
• phone numbers for geographic area codes and non-geographic area codes (mobile)
• states (Bundesländer)
• date formats: europe = DD.MM.YYYY and iso = YYYY-MM-DD
• month name
• ssn (Rentenversicherungsnummer)

Examples

first

chance.first({nationality: 'de'})
// 'Ilsa'

last

chance.last({nationality: 'de'})
// 'Buschmann

name

chance.name({nationality: 'de'})
// 'Liselotte Klee'

gender

chance.gender({nationality: 'de'})
// 'Mann'

ssn

chance.ssn({nationality: 'de'})
// '36718897P510'

street

chance.street({country: 'de'})
// 'Beckerstraße'

city

chance.city({country: 'de'})
// 'Gerstungen'

zip

chance.zip({country: 'de'})
// '12529'

postal

chance.postal({country: 'de'})
// '55483 Krummenau'

phone

chance.phone({country: 'de'})
// '0447 5059231'

chance.phone({mobile: true, country: 'de'})
// '0155 6431902'

state

chance.state({country: 'de', full: true})
// 'Thüringen'

month

chance.month({country: 'de'})
// 'Juli'

date

chance.date({string: true, type: 'iso'})
// '2026-04-16'

chance.date({string: true, type: 'europe'})
// '30.11.2038'

File size disclamer

File size of the minified file is now 737kB due to real real streets, cities and postal combinations

Chance

Chance - Random generator helper for JavaScript

Homepage: http://chancejs.com

Many more details on http://chancejs.com but this single library can generate random numbers, characters, strings, names, addresses, dice, and pretty much anything else.

It includes the basic building blocks for all these items and is built on top of a Mersenne Twister so it can generate these things with repeatability, if desired.

Packages

Bower

It can also be used with Bower

bower install chance

then in the HTML of your app:

<!-- Load Chance -->
<script type="text/javascript" src="app/bower_components/chance/chance.min.js"></script>
<script>
    // Use Chance immediately!
    alert(chance.string());
</script>

Component

It can also be used with Component

component install chancejs/chancejs

then in the HTML of your app:

<!-- Load Chance -->
<script type="text/javascript" src="components/chancejs-chancejs/chance.js"></script>
<script>
    // Use Chance immediately!
    alert(chance.string());
</script>

npm

npm install chance

spm

It can also be used with spm.

spm install chance

Usage

Browser

Chance instantiates itself onto the window. This means that in the simplest case you can just include the script tag then use an instance of Chance immediately.

<script src="chance.js"></script>
<script>
    console.log(chance.string());
</script>

More info

CLI

Chance CLI has moved to its own project!

Node.js

And it can be used in Node.js.

var Chance = require('chance'),
    chance = new Chance();

// Get a random zip code
chance.zip();

RequireJS

Chance also includes an AMD define so it can be used with RequireJS.

require(['Chance'], function(Chance) {
    // Instantiate
    var chance = new Chance();
       
    // Then just use it:
    var my_random_integer = chance.integer();
});

Dependent tools

• Chance CLI - Use Chance on the command line.
• Chance Token Replacer - Replace tokens in a string with Chance generated items.
• Dream.js - Lightweight json data generator
• Fake JSON Schema - Use chance generators to populate JSON Schema samples.
• Mocker Data Generator - Minimal JSON data generator.

Know a library that uses Chance that isn't here? Update the README and submit a PR!

Author

Victor Quinn

http://victorquinn.com

Please feel free to reach out to me if you have any questions or suggestions.

Contributors

THANK YOU!

 project  : chancejs
 repo age : 2 years, 8 months
 active   : 165 days
 commits  : 597
 files    : 27
 authors  :
   407	Victor Quinn        68.2%
    26	Oliver Salzburg     4.4%
    13	Tim Petricola       2.2%
    12	Alex DiLiberto      2.0%
    11	davmillar           1.8%
     7	Jan Tojnar          1.2%
     7	AminaG              1.2%
     6	Patrick Mowrer      1.0%
     6	Matt Klaber         1.0%
     5	Michael Cordingley  0.8%
     4	Abhijeet Pawar      0.7%
     4	Kevin Garnett       0.7%
     4	Chris Villarreal    0.7%
     4	Avishaan            0.7%
     4	Dominic Barnes      0.7%
     4	Geoff Russel        0.7%
     3	Nate Clark          0.5%
     3	leesei              0.5%
     3	Alexandr Lozovyuk   0.5%
     3	qjcg                0.5%
     3	Nicholas Johnson    0.5%
     2	SeeSchloss          0.3%
     2	The Usual Coder     0.3%
     2	Andreas Koeberle    0.3%
     2	Franco Victorio     0.3%
     2	dhilipsiva          0.3%
     2	Iskren Chernev      0.3%
     2	Adam Krebs          0.3%
     2	path411             0.3%
     2	shyam               0.3%
     2	somejeff            0.3%
     2	vird                0.3%
     2	xshyamx             0.3%
     2	Kris Van Houten     0.3%
     2	Mihail Petrov       0.3%
     2	Nathan MacInnes     0.3%
     2	Ng Patrick          0.3%
     2	Pascal Borreli      0.3%
     2	Stefan Penner       0.3%
     1	lkptrzk             0.2%
     1	Adam Pointer        0.2%
     1	Billy Moon          0.2%
     1	Bitdeli Chef        0.2%
     1	Brian.Barnett       0.2%
     1	Danny Yates         0.2%
     1	Doug Lawrence       0.2%
     1	Drew Brokke         0.2%
     1	Johannes Stein      0.2%
     1	Matt Altermatt      0.2%
     1	Piotrek Dąbrowski   0.2%
     1	Richard Anaya       0.2%
     1	Ryan Tenney         0.2%
     1	Samuel Greene       0.2%
     1	Tomasz Ducin        0.2%
     1	afc163              0.2%
     1	ddunning            0.2%
     1	flaviolivolsi       0.2%
     1	flrent              0.2%
     1	kiran               0.2%
     1	kkroner             0.2%
     1	mamrehn             0.2%

Contribute!

Be a part of this project! You can run the test using the following.

1. Install dependencies from package.json by running npm install
2. Run the test via npm test
3. Make some fun new modules!

Note: Formerly, there was a develop branch where active development would happen, but now it's all on master baby. Just submit PRs directly to master. Sorry if the develop branch going away caused any trouble, but it was time to rip the bandaid off.

This project is licensed under the MIT License so feel free to hack away :)

Proudly written in Washington, D.C.