h3

What is h3?

The h3 npm package is a high-performance HTTP framework for Node.js, designed to be lightweight and fast. It is often used for building APIs and microservices, providing a simple and efficient way to handle HTTP requests and responses.

What are h3's main functionalities?

Basic HTTP Server

This code demonstrates how to create a basic HTTP server using the h3 package. The server listens on port 3000 and responds with 'Hello, world!' to any incoming requests.

const { createApp } = require('h3');
const { createServer } = require('http');

const app = createApp();

app.use('/', (req, res) => {
  res.end('Hello, world!');
});

createServer(app).listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

Middleware Support

This example shows how to use middleware with the h3 package. The middleware logs each incoming request's method and URL before passing control to the next handler.

const { createApp } = require('h3');
const { createServer } = require('http');

const app = createApp();

// Middleware to log requests
app.use((req, res, next) => {
  console.log(`${req.method} ${req.url}`);
  next();
});

app.use('/', (req, res) => {
  res.end('Hello, world!');
});

createServer(app).listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

Routing

This code demonstrates how to set up routing with the h3 package. It defines GET and POST routes for the '/hello' path, responding with different messages based on the HTTP method.

const { createApp, useRouter } = require('h3');
const { createServer } = require('http');

const app = createApp();
const router = useRouter();

router.get('/hello', (req, res) => {
  res.end('Hello, GET!');
});

router.post('/hello', (req, res) => {
  res.end('Hello, POST!');
});

app.use(router);

createServer(app).listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

Other packages similar to h3

express

Express is a widely-used web application framework for Node.js, known for its simplicity and flexibility. It provides robust routing, middleware support, and a wide range of HTTP utility methods. Compared to h3, Express is more feature-rich and has a larger community, but it may be heavier and less performant for certain use cases.

koa

Koa is a next-generation web framework for Node.js, created by the same team behind Express. It uses async functions to simplify middleware and improve error handling. Koa is more modular and lightweight compared to Express, similar to h3, but it requires more boilerplate code to set up.

fastify

Fastify is a web framework for Node.js that focuses on performance and low overhead. It provides a schema-based validation system and a powerful plugin architecture. Fastify is similar to h3 in terms of performance and simplicity, but it offers more built-in features and a more extensive plugin ecosystem.

README

h3-js

A better HTMLElement constructor

Example

var body = h('div', 'example',
  h('h1', null, 'Example'),
  h('label', {htmlFor: 'task'},
    h('input', {id: 'task', type: 'checkbox', checked: true}),
    'Check out h3-js'
  )
);

API

h(tagName, props, ...children)

Creates and returns a new HTMLElement.

Primary interface: tagName sets the tag name, each key-value pair of props is copied onto the result, and each of children is appended to the result.

Conveniences:

• props.style sets result.style.cssText
• If props is falsy then it is ignored
• If props is a string then it instead sets result.className
• Children that are falsy are ignored
• Children that are strings are converted to Text instances
• Children that are Arrays are flattened into children

Setup

Install: npm install h3

Import: const h = require('h3');

Changelog

1.0.0 (2022-11-15)

⚠ BREAKING CHANGES

• drop deprecated util aliases

Features

• add proxyRequest util (#226) (501f0c6)

Bug Fixes

• import type from correct location (#219) (8b89f39)

• router: throw 404 for intermediate matches (43db151)

• drop deprecated util aliases (dc8ee81)