|
|
|
|
|
# Nano ID
|
|
|
|
|
|
|
|
|
|
|
|
<img src="https://ai.github.io/nanoid/logo.svg" align="right"
|
|
|
|
|
|
alt="Nano ID logo by Anton Lovchikov" width="180" height="94">
|
|
|
|
|
|
|
|
|
|
|
|
**English** | [Русский](./README.ru.md) | [简体中文](./README.zh-CN.md)
|
|
|
|
|
|
|
|
|
|
|
|
A tiny, secure, URL-friendly, unique string ID generator for JavaScript.
|
|
|
|
|
|
|
|
|
|
|
|
> “An amazing level of senseless perfectionism,
|
|
|
|
|
|
> which is simply impossible not to respect.”
|
|
|
|
|
|
|
|
|
|
|
|
* **Small.** 108 bytes (minified and gzipped). No dependencies.
|
|
|
|
|
|
[Size Limit] controls the size.
|
|
|
|
|
|
* **Fast.** It is 2 times faster than UUID.
|
|
|
|
|
|
* **Safe.** It uses hardware random generator. Can be used in clusters.
|
|
|
|
|
|
* **Short IDs.** It uses a larger alphabet than UUID (`A-Za-z0-9_-`).
|
|
|
|
|
|
So ID size was reduced from 36 to 21 symbols.
|
|
|
|
|
|
* **Portable.** Nano ID was ported
|
|
|
|
|
|
to [19 programming languages](#other-programming-languages).
|
|
|
|
|
|
|
|
|
|
|
|
```js
|
|
|
|
|
|
import { nanoid } from 'nanoid'
|
|
|
|
|
|
model.id = nanoid() //=> "V1StGXR8_Z5jdHi6B-myT"
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
Supports modern browsers, IE [with Babel], Node.js and React Native.
|
|
|
|
|
|
|
|
|
|
|
|
[online tool]: https://gitpod.io/#https://github.com/ai/nanoid/
|
|
|
|
|
|
[with Babel]: https://developer.epages.com/blog/coding/how-to-transpile-node-modules-with-babel-and-webpack-in-a-monorepo/
|
|
|
|
|
|
[Size Limit]: https://github.com/ai/size-limit
|
|
|
|
|
|
|
|
|
|
|
|
<a href="https://evilmartians.com/?utm_source=nanoid">
|
|
|
|
|
|
<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg"
|
|
|
|
|
|
alt="Sponsored by Evil Martians" width="236" height="54">
|
|
|
|
|
|
</a>
|
|
|
|
|
|
|
|
|
|
|
|
## Docs
|
|
|
|
|
|
Read **[full docs](https://github.com/ai/nanoid#readme)** on GitHub.
|
