ZephTTP2 is an interface built on top of node:http2 with the sole intent of making everything easy to use while creating as barebones of a framework as possible, staying as faithful to the original syntax of node:http2 as possible.
You can install ZephTTP2 by opening a command prompt in your project's directory and typing npm install zephttp2. Import the module by using the following import in your project:
import zephttp2 from 'zephttp2';Create the interface by calling the createServer method. For a secure server define an options object with certificate and key information.
import fs from 'node:fs';
import zephttp2 from 'zephttp2';
// Creates an interface to be used with `node:http2`.
const server = zephttp2.createServer();
// Creates a secure interface to be used with `node:http2`.
const server = zephttp2.createServer({
cert: fs.readFileSync('cert.pem'),
key: fs.readFileSync('key.pem')
});Register a route to the stack by calling the on method.
import zephttp2 from 'zephttp2';
// Creates an interface to be used with `node:http`.
const server = zephttp2.createServer();
// Handles GET requests on '/' from the subdomains '' and 'www'.
server.on('/', {
allowedMethods: ['get'],
allowedSubdomains: ['', 'www']
}, function (stream, headers) {
// Sends the header information to the client.
stream.respond({ ':status': 200, 'content-type': 'text/html' });
// Sends the response to the client.
stream.end('<!DOCTYPE html><html lang="en"><head></head><body><p>Hello, world!</p></body></html>');
});Make the server public by calling the listen method.
import zephttp2 from 'zephttp2';
// Creates an interface to be used with `node:http`.
const server = zephttp2.createServer({ ... });
// Handles GET requests on '/' from the subdomains '' and 'www'.
server.on('/', {
allowedMethods: ['get'],
allowedSubdomains: ['', 'www']
}, function (request, response) {
// Sends the header information to the client.
stream.respond({ ':status': 200, 'content-type': 'text/html' });
// Sends the response to the client.
stream.end('<!DOCTYPE html><html lang="en"><head></head><body><p>Hello, world!</p></body></html>');
});
// Exposes the HTTP/2 server to the internet.
server.listen(443, '0.0.0.0', function () {
const { address, port } = server.address();
console.log('[zephttp2] Secure HTTP/2 server listening on ${address}:${port}.');
});Handle errors by using the server object returns when creating the interface.
import zephttp2 from 'zephttp2';
// Creates an interface to be used with `node:http`.
const server = zephttp2.createServer();
// Handles errors caused by the server.
server.server.on('error', function (error) {
console.error(error);
});
// Handles errors caused by the client.
server.server.on('clientError', function (error) {
console.error(error);
});