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

82 lines
1.1 KiB
Markdown
Raw Normal View History

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