![Search icon](https://hackernoon.imgix.net/search-new.png?w=19&h=19)
Hono is a cutting-edge, lightweight backend framework designed for cloud-native applications. Built on Node.js, Hono is optimized for speed and scalability, perfect for building high-performance APIs and services. Its minimalistic design allows developers
to create efficient, scalable solutions for modern cloud environments quickly.
Hono also offers support for edge computing, middleware, and routing, making it an excellent choice for developers looking to build cloud-native applications with minimal overhead and maximum performance.
We will use Bun - another JavaScript runtime, and Node.js-compatible package manager. If you are not familiar with Bun, please read this article.
bun create hono hono-demo
✔ Using target directory … hono-demo ?
Which template do you want to use? bun ?
Do you want to install project dependencies? yes ?
Which package manager do you want to use? bun
✔ Cloning the template
✔ Installing project dependencies
🎉 Copied project files Get started with: cd hono-demo
Move to hono-demo
cd hono-demo
Install dependencies
bun install
Change the default port
// index.ts
import { Hono } from 'hono';
const app = new Hono();
app.get('/', (c) => {
return c.text('Hello Hono!');
});
export default { port: 4200, fetch: app.fetch, };
Run the app
bun dev
Result
$ bun run --hot src/index.ts Started server http://localhost:4200
Now, the HTTP requests coming to the Bun server will be handled by the Hono framework, providing us with a much more convenient API.
According to the official Hono documentation, the framework supports grouped routing, allowing you to organize routes using an instance of Hono and add them to the main application using the route method.
Let’s create a post.ts inside a routes folder. Don’t forget to export posts as the default export:
// routes/post.ts
import { Hono } from 'hono';
const post = new Hono();
post.get('/', (c) => c.text('List Posts')); // GET /post
post.get('/:id', (c) => {
// GET /post/:id const id = c.req.param('id');
return c.text('Get Post: ' + id);
});
post.post('/', (c) => c.text('Create Book')); // POST /post
export default post;
Open Postman, and navigate to http://localhost:4200/post/2 to test it
However, you might have noticed that c is used instead of req. This c stands for the context object, as detailed in the Hono.js documentation.
In practice, all incoming and outgoing data is managed by this context object. Hono allows you to return responses in various formats, not just JSON but also others, such as body, text, notFound, redirect, and more.
Hono is also well-suited for handling and returning small amounts of HTML.
Although hono/jsx is typically used on the client side, it can also be utilized for server-side content rendering.
In the JSX section, there’s an example of a functional React component. Let’s try rendering it server-side:
Create a post page inside a pages folder:
// pages/post.tsx
import { FC, PropsWithChildren } from 'hono/jsx';
type PostData = { title: string; id: string; };
const Layout: FC = ({ children }: PropsWithChildren) => {
return ( <html> <body>{children}</body> </html> );
};
const PostComponent = ({ title, id }: PostData) => {
return ( <Layout> <h1>Hello {title}</h1> <p>Your id is {id}</p> </Layout> );
};
export default PostComponent;
Now, let’s connect it to our post route:
// routes/post.tsx
post.get('/:id', (c) => {
// GET /book/:id const id = c.req.param('id');
return c.html(<PostComponent id={id} title={' World!'} />);
});
Open http://localhost:4200/post/2 in your browser to test it.
This approach is similar to SSR in Next.js or Remix.js, but it's much lighter. Hono also supports other features like asynchronous components, Suspense, and more.
Middleware is a function that integrates into the routing process and performs various operations.
You can intercept a request before it's processed or modify a response before it's sent.
HonoJS has a lot of built-in middleware, and you can add your own or reuse middleware created by the community.
Let's take a look at the official example from the documentation.
Add this code to index.ts file, before routes initialization
app.use(async (c, next) =>
{ const start = Date.now();
await next();
const end = Date.now();
c.res.headers.set('X-Response-Time', ${end - start});
});
You can create a redirect using the c.redirect() method:
c.redirect('/go-there');
c.redirect('/go-there', 301);
import { cors } from 'hono/cors';
app.use('/api/*', cors());
Create index.test.ts file:
import { expect, test, describe } from 'bun:test';
import { Hono } from 'hono';
import { testClient } from 'hono/testing';
describe('Example', async () => {
const app = new Hono().get('/', (c) => c.json('Hello Hono!'));
const res = await testClient(app).$get();
test('GET /post', async () => {
const res = await app.request('/');
expect(res.status).toBe(200);
expect(await res.json()).toEqual('Hello Hono!');
});
});
Now run
bun test
bun test v1.1.26 (0a37423b)
src\index.test.ts: ✓ Example > GET /post
1 pass 0 fail 2 expect() calls Ran 1 tests across 1 files. [301.00ms]
This article was originally published at JSDevSpace.