2021-12-17 07:53:31 +01:00
|
|
|
# Hono
|
2021-12-14 21:17:56 +01:00
|
|
|
|
2021-12-17 07:53:31 +01:00
|
|
|
Hono [炎] - Tiny web framework for Cloudflare Workers and others.
|
|
|
|
|
|
|
|
```js
|
2021-12-17 08:43:40 +01:00
|
|
|
const app = Hono()
|
2021-12-17 07:53:31 +01:00
|
|
|
|
|
|
|
app.get('/', () => new Response('Hono!!'))
|
|
|
|
|
|
|
|
app.fire()
|
|
|
|
```
|
|
|
|
|
|
|
|
## Feature
|
|
|
|
|
|
|
|
- Fast - the router is implemented with Trie-Tree structure.
|
|
|
|
- Tiny - use only standard API.
|
|
|
|
- Portable - zero dependencies.
|
|
|
|
- Optimized for Cloudflare Workers.
|
2021-12-14 21:17:56 +01:00
|
|
|
|
|
|
|
## Install
|
|
|
|
|
|
|
|
```sh
|
|
|
|
$ yarn add hono
|
|
|
|
```
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
|
|
```sh
|
|
|
|
$ npm install hono
|
|
|
|
```
|
|
|
|
|
2021-12-17 07:53:31 +01:00
|
|
|
## Routing
|
|
|
|
|
|
|
|
### Basic
|
2021-12-14 21:17:56 +01:00
|
|
|
|
|
|
|
```js
|
2021-12-17 07:53:31 +01:00
|
|
|
app.get('/', () => 'GET /')
|
|
|
|
app.post('/', () => 'POST /')
|
|
|
|
app.get('/wild/*/card', () => 'GET /wild/*/card')
|
|
|
|
```
|
2021-12-14 21:17:56 +01:00
|
|
|
|
2021-12-17 07:53:31 +01:00
|
|
|
### Named Parameter
|
2021-12-14 21:17:56 +01:00
|
|
|
|
2021-12-17 07:53:31 +01:00
|
|
|
```js
|
|
|
|
app.get('/user/:name', (req) => {
|
|
|
|
const name = req.params('name')
|
|
|
|
...
|
|
|
|
})
|
|
|
|
```
|
|
|
|
|
|
|
|
### Regexp
|
|
|
|
|
|
|
|
```js
|
|
|
|
app.get('/post/:date{[0-9]+}/:title{[a-z]+}', (req) => {
|
|
|
|
const date = req.params('date')
|
|
|
|
const title = req.params('title')
|
|
|
|
...
|
2021-12-14 21:17:56 +01:00
|
|
|
```
|
|
|
|
|
2021-12-17 07:53:31 +01:00
|
|
|
### Chained Route
|
|
|
|
|
|
|
|
```js
|
|
|
|
app
|
|
|
|
.route('/api/book')
|
|
|
|
.get(() => 'GET /api/book')
|
|
|
|
.post(() => 'POST /api/book')
|
|
|
|
.put(() => 'PUT /api/book')
|
|
|
|
```
|
2021-12-14 20:26:22 +01:00
|
|
|
|
2021-12-14 21:31:37 +01:00
|
|
|
## Related projects
|
|
|
|
|
2021-12-17 07:53:31 +01:00
|
|
|
- goblin <https://github.com/bmf-san/goblin>
|
|
|
|
- itty-router <https://github.com/kwhitley/itty-router>
|
2021-12-14 21:31:37 +01:00
|
|
|
|
2021-12-14 20:26:22 +01:00
|
|
|
## Author
|
|
|
|
|
|
|
|
Yusuke Wada <https://github.com/yusukebe>
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
MIT
|