mirror of
https://github.com/toss/es-toolkit.git
synced 2024-12-01 02:33:54 +03:00
51 lines
3.0 KiB
Markdown
51 lines
3.0 KiB
Markdown
|
||
|
||
# es-toolkit · [](https://github.com/toss/slash/blob/main/LICENSE) [](https://codecov.io/gh/toss/es-toolkit) [](https://www.npmjs.com/package/es-toolkit) [](https://jsr.io/@es-toolkit/es-toolkit) [](https://discord.gg/vGXbVjP2nY)
|
||
|
||
English | [한국어](https://github.com/toss/es-toolkit/blob/main/README-ko_kr.md) | [简体中文](https://github.com/toss/es-toolkit/blob/main/README-zh_hans.md) | [日本語](https://github.com/toss/es-toolkit/blob/main/README-ja_jp.md)
|
||
|
||
es-toolkit is a state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.
|
||
|
||
- es-toolkit offers a variety of everyday utility functions with modern implementations, such as [debounce](https://es-toolkit.slash.page/reference/function/debounce.html), [delay](https://es-toolkit.slash.page/reference/promise/delay.html), [chunk](https://es-toolkit.slash.page/reference/array/chunk.html), [sum](https://es-toolkit.slash.page/reference/math/sum.html), and [pick](https://es-toolkit.slash.page/reference/object/pick.html).
|
||
- Designed with performance in mind, es-toolkit achieves [2-3× better performance](https://es-toolkit.slash.page/performance.html) in modern JavaScript environments.
|
||
- es-toolkit supports tree shaking out of the box, and [reduces JavaScript code by up to 97%](https://es-toolkit.slash.page/bundle-size.html) compared to other libraries.
|
||
- es-toolkit includes built-in TypeScript support, with straightforward yet robust types. It also provides useful type guards such as [isNotNil](https://es-toolkit.slash.page/reference/predicate/isNotNil.html).
|
||
- es-toolkit is battle-tested with 100% test coverage, ensuring reliability and robustness.
|
||
|
||
## Examples
|
||
|
||
```tsx
|
||
// import from '@es-toolkit/es-toolkit' in jsr.
|
||
import { debounce, chunk } from 'es-toolkit';
|
||
|
||
const debouncedLog = debounce(message => {
|
||
console.log(message);
|
||
}, 300);
|
||
|
||
// This call will be debounced
|
||
debouncedLog('Hello, world!');
|
||
|
||
const array = [1, 2, 3, 4, 5, 6];
|
||
const chunkedArray = chunk(array, 2);
|
||
|
||
console.log(chunkedArray);
|
||
// Output: [[1, 2], [3, 4], [5, 6]]
|
||
```
|
||
|
||
## Contributing
|
||
|
||
We welcome contribution from everyone in the community. Read below for detailed contribution guide.
|
||
|
||
[CONTRIBUTING](https://github.com/toss/es-toolkit/blob/main/.github/CONTRIBUTING.md)
|
||
|
||
## License
|
||
|
||
MIT © Viva Republica, Inc. See [LICENSE](./LICENSE) for details.
|
||
|
||
<a title="Toss" href="https://toss.im">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://static.toss.im/logos/png/4x/logo-toss-reverse.png">
|
||
<img alt="Toss" src="https://static.toss.im/logos/png/4x/logo-toss.png" width="100">
|
||
</picture>
|
||
</a>
|