# pokemon

> Get Pokémon names

Latest version **3.3.1** (published 2026-07-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install pokemon
pnpm add pokemon
yarn add pokemon
bun add pokemon
```

## Health

**Score 55/100 (C)** — status: active.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 3.3.1 |
| Published | 2026-07-13 |
| First published | 2015-03-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=18 |
| Dependencies | 1 |
| Unpacked size | 170.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 508 |
| Author | Sindre Sorhus |
| Maintainers | sindresorhus |
| Keywords | pokemon, names, creatures, words, list, array, random, mock, placeholder, fixture, data |

## Links

- npm: https://www.npmjs.com/package/pokemon
- Repository: https://github.com/sindresorhus/pokemon
- Homepage: https://github.com/sindresorhus/pokemon#readme
- Issues: https://github.com/sindresorhus/pokemon/issues
- Funding: https://github.com/sponsors/sindresorhus
- npm.io page: https://npm.io/package/pokemon

## Dependencies (1)

- [unique-random-array](https://npm.io/package/unique-random-array.md) ^2.0.0

## Alternatives

- [gamedig](https://npm.io/package/gamedig.md) — 29.3K weekly downloads
- [join-monster](https://npm.io/package/join-monster.md) — 12.8K weekly downloads
- [masked](https://npm.io/package/masked.md) — 5.5K weekly downloads
- [@comunica/actor-query-process-explain-logical](https://npm.io/package/@comunica/actor-query-process-explain-logical.md) — 4.7K weekly downloads
- [@veracity/vui](https://npm.io/package/@veracity/vui.md) — 4.6K weekly downloads

## Recent versions

- 3.3.1 (latest) — 2026-07-13
- 3.3.0 — 2025-02-27
- 3.2.2 — 2025-02-21
- 3.2.1 — 2024-07-24
- 3.2.0 — 2024-06-16
- 3.1.0 — 2024-04-11
- 3.0.0 — 2024-02-29
- 2.3.6 — 2023-09-15
- 2.3.5 — 2023-05-06
- 2.3.4 — 2023-01-16
- 2.3.3 — 2022-04-12
- 2.3.2 — 2022-03-23
- 2.3.1 — 2022-02-09
- 2.3.0 — 2021-08-23
- 2.2.0 — 2021-05-31
- … 20 more at https://npm.io/package/pokemon/versions

## README

# pokemon

> Get [Pokémon](https://en.wikipedia.org/wiki/Pok%C3%A9mon) names

The name list is just a [JSON file](data/en.json) and can be used wherever.

![](header.jpg)

## Install

```sh
npm install pokemon
```

## Usage

```js
const pokemon = require('pokemon');

pokemon.all();
//=> ['Bulbasaur', …]

pokemon.random();
//=> 'Snorlax'

pokemon.getName(147);
//=> 'Dratini'

pokemon.getId('Dratini');
//=> 147
```

## API

### .all(language?)

Get all Pokémon names as a `string[]`.

#### language

Type: `string`\
Default: `'en'`

[Language code](#supported-languages) to retrieve the list of Pokémon for.

```js
pokemon.all();
//=> ['Bulbasaur', …]
pokemon.all('de');
//=> ['Bisasam', …]
```

### .random(language?)

Get random Pokémon name.

#### language

Type: `string`\
Default: `'en'`

[Language code](#supported-languages) to retrieve the Pokémon for.

```js
pokemon.random();
//=> 'Vigoroth'
pokemon.random('de');
//=> 'Muntier'
```

### .getName(id, language?)

Get Pokémon name from ID.

#### id

Type: `number`

The ID of a Pokémon, retrieved via `getId()`.

#### language

Type: `string`\
Default: `'en'`

[Language code](#supported-languages) to retrieve the Pokémon for.

```js
pokemon.getName(100);
//=> 'Voltorb'
pokemon.getName(100, 'de');
//=> 'Voltobal'
```

### .getId(name, language?)

Get Pokémon ID from name.

#### name

Type: `string`

The Pokémon name in the `language` locale.

#### language

Type: `string`\
Default: `'en'`

[Language code](#supported-languages) of the localized name.

```js
pokemon.getId('Snorlax');
//=> 143
pokemon.getId('Relaxo', 'de');
//=> 143
```

### .languages: *Set*

```js
pokemon.languages.has('ja');
//=> true
```

## Supported languages

Pokémon names are available for the following languages:

- `de` (German)
- `en` (English)
- `fr` (French)
- `es` (Spanish)
- `ja` (Japanese)
- `ko` (Korean)
- `ru` (Russian)
- `th` (Thai)
- `zh-Hans` (Simplified Chinese)
- `zh-Hant` (Traditional Chinese)

The language codes follow the [IETF BCP 47 standard](https://en.wikipedia.org/wiki/IETF_language_tag).

## Related

- [pokemon-cli](https://github.com/sindresorhus/pokemon-cli) - CLI for this module
- [cat-names](https://github.com/sindresorhus/cat-names) - Get popular cat names
- [dog-names](https://github.com/sindresorhus/dog-names) - Get popular dog names
- [superb](https://github.com/sindresorhus/superb) - Get superb like words
- [superheroes](https://github.com/sindresorhus/superheroes) - Get superhero names
- [supervillains](https://github.com/sindresorhus/supervillains) - Get supervillain names
- [yes-no-words](https://github.com/sindresorhus/yes-no-words) - Get yes/no like words

---
_Source: https://npm.io/package/pokemon · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
