NHttp
An Simple Http Route framework for Deno and Friends.
Features
- Crazy Fast.
- Easy to use.
- Cross runtime support (Deno, Bun, Node, etc).
- Low overhead & True handlers (no caching anything).
- Small & Zero deps.
- Middleware support.
- Sub router support.
- Return directly on handlers.
- Auto parses the body (
json / urlencoded / multipart / raw
).
Installation
deno.land
import { nhttp } from "https://deno.land/x/nhttp@1.1.18/mod.ts";
deno-npm
import { nhttp } from "npm:nhttp-land@1.1.18";
nest.land
import { nhttp } from "https://x.nest.land/nhttp@1.1.18/mod.ts";
npm/yarn
npm i nhttp-land
// or
yarn add nhttp-land
import { nhttp } from "nhttp-land";
Usage
import { nhttp } from "https://deno.land/x/nhttp@1.1.18/mod.ts";
const app = nhttp();
app.get("/", () => {
return "Hello, World";
});
app.get("/cat", () => {
return { name: "cat" };
});
app.listen(8000, () => {
console.log("> Running on port 8000");
});
Run
deno run -A myapp.ts
Deno Flash
requires
--unstable
flag.
const app = nhttp({ flash: true });
Middleware
const app = nhttp();
app.use((rev, next) => {
rev.foo = "bar";
return next();
});
app.get("/", ({ foo }) => foo);
Body Parser
Support json / urlencoded / multipart / raw
.
note: nhttp automatically parses the body.
const app = nhttp();
// if you want disable bodyParser
// const app = nhttp({ bodyParser: false });
app.post("/save", (rev) => {
console.log(rev.body);
return "success save";
});
// inline bodyParser
// app.post("/save", bodyParser(), (rev) => {...});
Other Runtime (Bun / Node)
for nodejs, requires v18.14.0 or higher. cause it uses
Web Stream API
likeReadableStream
.
import { nhttp } from "nhttp-land";
const app = nhttp();
app.get("/", () => "hello, world");
app.get("/res", () => new Response("hello"));
app.listen(8000, () => {
console.log("> Running on port 8000");
});
// if cfw or other runtime, just invoke app.handle
// export default { fetch: app.handle };
tsconfig
{
"compilerOptions": {
// if bun
// "types": ["bun-types"],
"lib": [
"DOM",
"DOM.Iterable",
"ESNext"
]
}
}