handler_directory: Create Static Directory Handler

In nanonext: Lightweight Toolkit for Messaging, Concurrency and the Web

Create Static Directory Handler

Description

Creates an HTTP handler that serves files from a directory tree. NNG handles MIME type detection automatically.

Usage

handler_directory(path, directory)

Arguments

path	URI path prefix (e.g., "/static"). Requests to "/static/foo.js" will serve "directory/foo.js".
directory	Path to the directory to serve.

Details

Directory handlers automatically match all paths under the prefix (prefix matching is implicit). The URI path is mapped to the filesystem:

• Request to "/static/css/style.css" serves "directory/css/style.css"

• Request to "/static/" serves "directory/index.html" if it exists

Note: The trailing slash behavior depends on how clients make requests. A request to "/static" (no trailing slash) will not automatically redirect to "/static/". Consider using handler_redirect() if you need this behavior.

Value

A handler object for use with http_server().

Examples

h <- handler_directory("/static", "www/assets")

nanonext documentation built on March 8, 2026, 9:06 a.m.