NHttp
Just native HTTP/2 micro framework for Deno. so hot 🚀
Note: Deno native HTTP/2 Hyper need Deno version 1.9.0 or higher.
Features
- No third party modules and no std/lib by default.
- Support middleware.
- Support sub router.
Installation
deno.land
import { NHttp } from "https://deno.land/x/nhttp@0.0.6/mod.ts";
nest.land
import { NHttp } from "https://x.nest.land/nhttp@0.0.6/mod.ts";
Usage
import { NHttp, JsonResponse } from "https://deno.land/x/nhttp@0.0.6/mod.ts";
const app = new NHttp();
app.get("/hello", (request, respondWith) => {
respondWith(new Response("Hello"));
});
app.get("/json", (request, respondWith) => {
respondWith(new JsonResponse({ name: "john" }));
});
app.listen(3000, () => {
console.log("> Running on port 3000");
});
Note: request.url is full url. use request.originalUrl instead.
Run
Note: native HTTP/2 is unstable. so just add --unstable flag.
deno run --allow-net --allow-read --unstable yourfile.ts
Listen
app.listen(3000);
// or
const callback = (err, opts) => {
if (err) console.log(err);
console.log("Running on server 3000");
}
app.listen(3000, callback);
// or
app.listen({ port: 3000, hostname: 'localhost' }, callback);
// or https
app.listen({
port: 443,
certFile: "./path/to/localhost.crt",
keyFile: "./path/to/localhost.key",
}, callback);
// or http/2
app.listen({
port: 443,
certFile: "./path/to/localhost.crt",
keyFile: "./path/to/localhost.key",
alpnProtocols: ["h2", "http/1.1"]
}, callback);
Middleware
import { NHttp, HttpRequest, RespondWith, NextFunction } from "https://deno.land/x/nhttp@0.0.6/mod.ts";
const app = new NHttp();
const foo = (request: HttpRequest, respondWith: RespondWith, next: NextFunction) => {
request.foo = "hello";
next();
}
app.use(foo);
app.get("/hello", (request, respondWith) => {
respondWith(new Response(request.foo));
});
app.listen(3000);
Router
import { NHttp, Router } from "https://deno.land/x/nhttp@0.0.6/mod.ts";
const app = new NHttp();
// user router
const userRouter = new Router();
userRouter.get("/user", (request, respondWith) => {
respondWith(new Response("hello user"));
});
// item router
const itemRouter = new Router();
itemRouter.get("/item", (request, respondWith) => {
respondWith(new Response("hello item"));
});
// register the router
app.use([userRouter, itemRouter]);
// or with prefix
// app.use('/api', [userRouter, itemRouter]);
app.listen(3000);
Request
Just Web API Request with add more some object like :
originalUrl: string;
params: object;
path: string;
query: object;
search: string | null;
parsedBody: object;
file: object;
// more
Handle Body and Upload
import { NHttp, jsonBody, urlencodedBody, multipartBody } from "https://deno.land/x/nhttp@0.0.6/mod.ts";
const app = new NHttp();
app.use(jsonBody(), urlencodedBody());
app.post("/hello", async (request, respondWith) => {
console.log(request.parsedBody);
respondWith(new Response("body was parsed"));
});
// handle upload multipart/form-data
app.post("/upload", multipartBody({ fileKey: "image" }), async (request, respondWith) => {
if (!request.file?.image) {
throw new Error("Image is required");
}
let file = request.file.image as File;
console.log(file.name);
console.log(request.parsedBody);
// convert to array buffer
let arrBuf = await file.arrayBuffer();
// save file
await Deno.writeFile("./" + file.name, new Uint8Array(arrBuf));
respondWith(new Response("Success upload file"));
});
app.listen(3000);
For nested object in urlencoded and multipart, you can use qs :
import { NHttp, urlencodedBody, multipartBody } from "https://deno.land/x/nhttp@0.0.6/mod.ts";
import qs from "https://esm.sh/qs?no-check";
// application/x-www-form-urlencoded
app.use(urlencodedBody({ parse: qs.parse }));
// multipart/form-data
app.post("/upload", multipartBody({ fileKey: "image", parse: qs.parse }), ...more);
RespondWith
Just callback Web API Response.
...
// example with status and headers
app.get("/hello", (request, respondWith) => {
respondWith(new Response("Hello", {
status: 200,
headers: new Headers({
'x-powered-by': 'nhttp'
})
}))
})
...
Error Handling
...
// global error handling
app.onError((error, request, respondWith) => {
respondWith(new Response(error.message, {
status: error.status || 500
}))
})
// global not found error handling
app.on404((request, respondWith) => {
respondWith(new Response(`${request.originalUrl} not found`, {
status: 404
}))
})
...