# ahooks

> react hooks library

Latest version **3.10.0** (published 2026-09-06) · MIT license · 0 weekly downloads

## Install

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

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 3.10.0 |
| Published | 2026-09-06 |
| First published | 2020-04-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 8 |
| Unpacked size | 608.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 14972 |
| Maintainers | awmleer, liuyib, taoweng, fan576679268, straw94 |
| Keywords | ahooks, umi hooks, react hooks |

## Links

- npm: https://www.npmjs.com/package/ahooks
- Repository: https://github.com/alibaba/hooks
- Issues: https://github.com/alibaba/hooks/issues
- npm.io page: https://npm.io/package/ahooks

## Dependencies (8)

- [dayjs](https://npm.io/package/dayjs.md) ^1.9.1
- [tslib](https://npm.io/package/tslib.md) ^2.4.1
- [lodash](https://npm.io/package/lodash.md) ^4.17.21
- [js-cookie](https://npm.io/package/js-cookie.md) ^3.0.5
- [screenfull](https://npm.io/package/screenfull.md) ^5.0.0
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) ^7.21.0
- [react-fast-compare](https://npm.io/package/react-fast-compare.md) ^3.2.2
- [resize-observer-polyfill](https://npm.io/package/resize-observer-polyfill.md) ^1.5.1

## Recent versions

- 3.10.0 (latest) — 2026-09-06
- 3.10.0-test.1 (test) — 2026-09-20
- 3.0.0-alpha.18 (next) — 2021-12-06
- 3.0.0-alpha.0 (alpha) — 2021-07-26
- 2.10.10-beta (beta) — 2021-07-23
- 3.9.7 — 2026-03-23
- 3.9.6 — 2025-10-27
- 3.9.5 — 2025-08-31
- 3.9.4 — 2025-08-22
- 3.9.3 — 2025-08-18
- 3.9.2 — 2025-08-18
- 3.9.1 — 2025-08-17
- 3.9.0 — 2025-06-28
- 3.8.5 — 2025-05-19
- 3.8.4 — 2024-12-05
- … 107 more at https://npm.io/package/ahooks/versions

## README

<p align="center">
  <a href="https://ahooks.js.org">
    <img width="200" src="https://ahooks.js.org/logo.svg">
  </a>
</p>

<div align="center">

A high-quality & reliable React Hooks library.

[![NPM version][image-1]][1]
[![NPM downloads][image-2]][2]
[![npm](https://img.shields.io/npm/dw/ahooks-v2?label=downloads%28v2%29)](https://www.npmjs.com/package/ahooks-v2)
[![npm](https://img.shields.io/github/issues/alibaba/hooks)](https://github.com/alibaba/hooks/issues)
[![Coverage Status](https://coveralls.io/repos/github/alibaba/hooks/badge.svg?branch=master)](https://coveralls.io/github/alibaba/hooks?branch=master)
![gzip size](https://img.badgesize.io/https:/unpkg.com/ahooks/dist/ahooks.js?label=gzip%20size&compression=gzip)
[![Percentage of issues still open](http://isitmaintained.com/badge/open/alibaba/hooks.svg)](http://isitmaintained.com/project/alibaba/hooks "Percentage of issues still open")
[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/alibaba/hooks.svg)](http://isitmaintained.com/project/alibaba/hooks "Average time to resolve an issue")
![GitHub](https://img.shields.io/github/license/alibaba/hooks)

English | [简体中文](https://github.com/alibaba/hooks/blob/master/README.zh-CN.md)

</div>

## 📚 Documentation

- [English](https://ahooks.js.org/)
- [中文](https://ahooks.js.org/zh-CN/)

> Notice
>
> `use-url-state` is now published as `@ahooks.js/use-url-state`.
>
> If you are installing or upgrading this package, please use the new package name.

## ✨ Features

- Easy to learn and use
- Supports SSR
- Special treatment for functions, avoid closure problems
- Contains a large number of advanced Hooks that are refined from business scenarios
- Contains a comprehensive collection of basic Hooks
- Written in TypeScript with predictable static types

## 📦 Install

```bash
$ npm install --save ahooks
# or
$ yarn add ahooks
# or
$ pnpm add ahooks
# or
$ bun add ahooks
```

## 🔨 Usage

```ts
import { useRequest } from "ahooks";
```

## 💻 Online Demo

[![Edit demo for ahooks](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/demo-for-ahooks-forked-fg79k?file=/src/App.js)

## 🤝 Contributing

```bash
$ git clone git@github.com:alibaba/hooks.git
$ cd hooks
$ pnpm run init
$ pnpm start
```

Open your browser and visit http://127.0.0.1:8000

We welcome all contributions, please read our [CONTRIBUTING.MD](https://github.com/alibaba/hooks/blob/master/CONTRIBUTING.MD) first, let's build a better hooks library together.

Thanks to all the contributors:

<a href="https://github.com/alibaba/hooks/graphs/contributors">
  <img src="https://opencollective.com/ahooks/contributors.svg?width=960&button=false" alt="contributors" />
</a>

## 👥 Discuss

<img alt="ahooks discussion group 1" draggable="false" src="https://github.com/user-attachments/assets/dda464be-26cf-4c83-8fee-16862fb916cb" width="200" style='display:inline' />
<img alt="ahooks discussion group 2" draggable="false" src="https://github.com/user-attachments/assets/c804a026-3b07-4a20-ad7e-83cf2f86bc9a" width="200" style='display:inline' />
<img alt="ahooks discussion group 3" draggable="false" src="https://github.com/user-attachments/assets/52ac8ef8-6506-4540-a17d-823ae4371b88" width="200" style='display:inline' />

[1]: https://www.npmjs.com/package/ahooks
[2]: https://npmjs.org/package/ahooks
[image-1]: https://img.shields.io/npm/v/ahooks.svg?style=flat
[image-2]: https://img.shields.io/npm/dw/ahooks.svg?style=flat

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