summaryrefslogtreecommitdiff
path: root/src/node_modules/chance/docs/location/state.md
blob: 81a200b86b54036368038ea395a77cfad662deca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# state

```js
// usage
chance.state()
chance.state({ full: true })
chance.state({ territories: true })
chance.state({ armed_forces: true })
chance.state({ us_states_and_dc: false })
chance.state({ country: 'us' })
```

Return a random state.

```js
chance.state();
=> 'AK'
```

By default, returns only the 2 letter abbreviation for state.

Optionally specify that it ought to return a full state name.

```js
chance.state({ full: true });
=> 'Florida'
```

Optionally add U.S. Territories ('American Samoa', 'Federated States of Micronesia', 'Guam', 'Marshall Islands', 'Northern Mariana Islands', 'Puerto Rico', 'Virgin Islands, U.S.') to the mix of randomly selected items:

```js
chance.state({ territories: true, full: true })
=> 'Guam'
```

Optionally add Armed Forces to the list as well:

```js
chance.state({ armed_forces: true, full: true })
=> 'Armed Forces Pacific'
```

For all U.S. states, territories, and armed forces, specify all of them:

```js
chance.state({ armed_forces: true, territories: true })
=> 'NY'
```

For just territories or armed forces, specify that it ought not return U.S. states:

```js
chance.state({ territories: true, us_states_and_dc: false })
=> 'PR'
```

Optionally specify a country (US specific options are ignored if country is specified and different from `'us'`):

```js
chance.state({ country: 'it', full: true })
=> 'Toscana'
```