Micro router for workers

pier · March 13, 2020, 6:34pm

Hey there

I created this super simple micro router for my API on workers.

Still not production ready (it will be) but it’s a good starting point or example for making your own router if my style of code doesn’t suit your taste. It has route parameters which the official router template doesn’t have. I’ll be implementing optional parameters too in a couple of days.

It doesn’t use regex on purpose to make it even faster since those 50ms are super precious.

Routes are not initialized on each request since I assume this is more efficient as CF keep workers warm for a period of time.

Anyway, hope this might be useful to someone. This is such a small thing that it doesn’t make sense to put it on NPM.

gist.github.com

https://gist.github.com/PierBover/4da745b601d30a6bb850c297b0c0c579

index.js

const router = require('./router');

router.setRoutes([
	{
		path: '/ping',
		method: 'GET',
		handler: ping
	},
	{
		path: '/hello/:name',

This file has been truncated. show original

router.js

const router = {
	routes: []
};

router.onRequest = async (event) => {
	try {
		const match = matchRoute(event.request, router.routes);

		if (match) {
			return await match.route.handler(event.request, match.params);

This file has been truncated. show original

thomas4 · March 14, 2020, 12:27pm

Thanks for sharing!

For those looking for production-ready router for workers, there’s also:

Topic		Replies	Views
Open Source: Fast URL router for workers (JS & TypeScript) Workers workers , recipe-exchange	2	4285	September 12, 2018
Open-Sourced Workers Router (TypeScript) - cloudflare-router Workers	5	3381	February 25, 2021
Cloudworker-router: A express style router for workers Workers	0	3297	August 13, 2019
Redirect Management with Workers Workers recipe-exchange	8	5250	March 28, 2025
Exclude paths from Worker routes Workers	3	4375	November 6, 2020

Micro router for workers

Related topics