Socket
Socket
Sign inDemoInstall

@bit-js/blitz

Package Overview
Dependencies
Maintainers
1
Versions
39
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@bit-js/blitz

The fastest JavaScript URL router


Version published
Weekly downloads
11
increased by83.33%
Maintainers
1
Weekly downloads
 
Created
Source

Blitz

The fastest JavaScript router.

import Blitz from '@bit-js/blitz';

// Create the router
const router = new Blitz();

// Register paths
router.on('GET', '/', () => new Response('Hi'));

// Wildcard parameter
router.on('GET', '/search/*', ctx => new Response(ctx.params.$));

// Path parameters
router.on('PUT', '/update/:id', ctx => new Response(ctx.params.id));

// Register another router with the same type as a subrouter
router.route('/api', anotherRouter);

// Get the fetch function (use with Bun and Deno)
const fetch = router.build();

Patterns

Blitz supports URL params and wildcards. Wildcard like /* does not match /.

Context

The request context contains:

  • path: The request pathname (Always start with a slash).
  • pathStart: The request pathname start index in the request URL.
  • pathEnd: The request pathname end index in the request URL.
  • params: Request URL parameters.
  • req: The raw request object.

Other routers

Other utility routers.

Edge router

The basic Blitz router only works on non-edge runtimes as those block the use of the Function constructor for code generation.

EdgeRouter works everywhere as it matches routes using a recursive approach.

import { EdgeRouter } from '@bit-js/blitz';

// Create the router
const router = new EdgeRouter();

API usage is the same as Blitz. EdgeRouter should be used in edge runtimes as Blitz is around 1.5x faster and use less memory in other scenarios.

It is possible to re-use the matcher of EdgeRouter after adding more routes, unlike Blitz.

// Add some routes (need to be both static and dynamic routes)
router.on('GET', '/', () => new Response('Hi'));
router.on('GET', '/user/:id', (ctx) => new Response(ctx.params.id));

// Match '/' and '/user/:id'
const fetch = router.build();

// Add another route
router.on('GET', '/user/*', (ctx) => new Response(ctx.params.$));

// Fetch now handles '/', '/user/:id'
fetch(req);

URL routers

These are internals router built for path matching only.

import { internal } from '@bit-js/blitz';

// Blitz router with only path matching
const router = new internal.Radix<number>();

// EdgeRouter with only path matching;
const router = new internal.Edge<number>();

// Register routes
router.on('/', 0);
router.on('/:id', 1);
router.on('/*', 2);

// Merging routes
router.route('/api', otherInternalRouter);

// Get the matching function
const f = router.buildMatcher({}, 3);

f(ctx);

The match context only has:

  • ctx.path: The parsed pathname.
  • ctx.params: The output parameters.

FS router

A cross-runtime file system router API.

Example usage with Bun:

import { FileSystemRouter } from '@bit-js/blitz';

// A directory scanner
const glob = new Bun.Glob('**/*');

// Router prototype
const router = new FileSystemRouter({
    // on(path): Return the metadata associated to the path to match later
    // This only run once while scanning to retrieve the metadata
    on: Bun.file,

    // Scan synchronously and return the paths as an iterator
    scan: (dir) => glob.scanSync(dir),

    // style(path): Convert relative file path to route pathname (optional)
    // Default to NextJS route path style
    style: 'basic',
});

// Get the matcher
const match = router.scan(`${import.meta.dir}/internals`);

// Serve with Bun
export default {
    fetch(req: Request) {
        // Result is the metadata returned by on(path)
        // In this case it is the file blob
        return new Response(match(req).result);
    }
}
Route style

Route style is a function that accepts a relative path and returns the correct route pattern.

type Style = (path: string) => string | null;

If the return result is null the path will be ignored.

Default style
  • basic: NextJS route style (wildcard only supports [...] and wildcard parameter name is always $).
  • preserve: No modifications to the path.
Result

The result is a request context with result property is the matched result.

Keywords

FAQs

Package last updated on 13 Jun 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc