0
0
mirror of https://github.com/honojs/hono.git synced 2024-12-01 11:51:01 +01:00
hono/deno_dist/README.md

89 lines
3.3 KiB
Markdown
Raw Normal View History

2022-07-02 08:09:45 +02:00
<div align="center">
2022-07-16 10:56:06 +02:00
<a href="https://honojs.dev">
2022-07-18 04:56:07 +02:00
<img src="https://raw.githubusercontent.com/honojs/hono/main/docs/images/hono-title.png" width="500" height="auto" alt="Hono"/>
2022-07-02 08:09:45 +02:00
</a>
</div>
<hr />
2022-07-16 10:56:06 +02:00
<p align="center">
<a href="https://honojs.dev"><b>Documentation :point_right: honojs.dev</b></a><br />
<i>v2.x has been released!</i> <a href="docs/MIGRATION.md">Migration guide</b>
</p>
<hr />
2022-07-02 08:09:45 +02:00
[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/honojs/hono/ci)](https://github.com/honojs/hono/actions)
2022-07-18 04:56:07 +02:00
[![GitHub](https://img.shields.io/github/license/honojs/hono)](https://github.com/honojs/hono/blob/main/LICENSE)
2022-07-02 08:09:45 +02:00
[![npm](https://img.shields.io/npm/v/hono)](https://www.npmjs.com/package/hono)
[![npm](https://img.shields.io/npm/dm/hono)](https://www.npmjs.com/package/hono)
[![npm type definitions](https://img.shields.io/npm/types/hono)](https://www.npmjs.com/package/hono)
[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/honojs/hono)](https://github.com/honojs/hono/pulse)
2022-07-18 04:56:07 +02:00
[![GitHub last commit](https://img.shields.io/github/last-commit/honojs/hono)](https://github.com/honojs/hono/commits/main)
[![Deno badge](https://img.shields.io/endpoint?url=https%3A%2F%2Fdeno-visualizer.danopia.net%2Fshields%2Flatest-version%2Fx%2Fhono%2Fmod.ts)](https://doc.deno.land/https/deno.land/x/hono/mod.ts)
2022-07-02 08:09:45 +02:00
2022-07-08 02:22:10 +02:00
Hono - _**[炎] means flame🔥 in Japanese**_ - is a small, simple, and ultrafast web framework for Cloudflare Workers, Deno, Bun, and others.
2022-07-02 08:09:45 +02:00
```ts
import { Hono } from 'hono'
const app = new Hono()
app.get('/', (c) => c.text('Hono!!'))
2022-07-16 10:56:06 +02:00
export default app
2022-07-02 08:09:45 +02:00
```
## Features
- **Ultrafast** - the router does not use linear loops.
- **Zero-dependencies** - using only Service Worker and Web Standard API.
2022-07-12 16:25:47 +02:00
- **Middleware** - built-in middleware, custom middleware, and third-party middleware.
2022-07-02 08:09:45 +02:00
- **TypeScript** - first-class TypeScript support.
2022-07-08 02:22:10 +02:00
- **Multi-platform** - works on Cloudflare Workers, Fastly Compute@Edge, Deno, or Bun.
2022-07-02 08:09:45 +02:00
## Benchmarks
2022-07-02 08:09:45 +02:00
**Hono is fastest**, compared to other routers for Cloudflare Workers.
```plain
2022-08-19 00:30:48 +02:00
hono - trie-router(default) x 424,449 ops/sec ±4.98% (77 runs sampled)
hono - regexp-router x 516,228 ops/sec ±4.79% (81 runs sampled)
itty-router x 206,641 ops/sec ±3.59% (87 runs sampled)
sunder x 319,500 ops/sec ±1.33% (93 runs sampled)
worktop x 187,280 ops/sec ±3.09% (87 runs sampled)
2022-07-02 08:09:45 +02:00
Fastest is hono - regexp-router
2022-08-19 00:30:48 +02:00
✨ Done in 38.32s.
2022-07-02 08:09:45 +02:00
```
2022-07-16 10:56:06 +02:00
## Documentation
2022-07-08 02:22:10 +02:00
2022-07-16 10:56:06 +02:00
The documentation is available on [honojs.dev](https://honojs.dev).
2022-07-02 08:09:45 +02:00
2022-07-16 10:56:06 +02:00
## Migration
2022-07-02 08:09:45 +02:00
Migration guide is available on [docs/MIGRATION.md](docs/MIGRATION.md).
2022-07-02 08:09:45 +02:00
## Contributing
Contributions Welcome! You can contribute in the following ways.
- Create an Issue - Propose a new feature. Report a bug.
- Pull Request - Fix a bug and typo. Refactor the code.
- Create third-party middleware - Instruct below.
- Share - Share your thoughts on the Blog, Twitter, and others.
- Make your application - Please try to use Hono.
For more details, see [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md).
2022-07-02 08:09:45 +02:00
## Contributors
Thanks to [all contributors](https://github.com/honojs/hono/graphs/contributors)! Especially, [@metrue](https://github.com/metrue) and [@usualoma](https://github.com/usualoma)!
## Author
Yusuke Wada <https://github.com/yusukebe>
## License
Distributed under the MIT License. See [LICENSE](LICENSE) for more information.