@ricsam/quickjs-path

POSIX path utilities (join, resolve, dirname, basename, etc.) for QuickJS runtime.

Note: This is a low-level package. For most use cases, use @ricsam/quickjs-runtime with createRuntime() instead.

Installation

bun add @ricsam/quickjs-path

Setup

import { setupPath } from "@ricsam/quickjs-path";

const handle = setupPath(context, {
  cwd: "/home/user/project", // Current working directory for resolve()
});

Injected Globals

• path.join(...paths) - Join path segments
• path.resolve(...paths) - Resolve to absolute path
• path.dirname(path) - Get directory name
• path.basename(path, ext?) - Get base name
• path.extname(path) - Get extension
• path.normalize(path) - Normalize path
• path.isAbsolute(path) - Check if absolute
• path.relative(from, to) - Get relative path
• path.parse(path) - Parse into components
• path.format(pathObject) - Format from components
• path.sep - Path separator (/)
• path.delimiter - Path delimiter (:)

Usage in QuickJS

// Join paths
path.join("/foo", "bar", "baz"); // "/foo/bar/baz"
path.join("/foo", "../bar");     // "/bar"

// Resolve to absolute path
path.resolve("foo", "bar");       // "/home/user/project/foo/bar"
path.resolve("/foo", "bar");      // "/foo/bar"

// Directory and base names
path.dirname("/foo/bar/baz.txt"); // "/foo/bar"
path.basename("/foo/bar/baz.txt"); // "baz.txt"
path.basename("/foo/bar/baz.txt", ".txt"); // "baz"

// Extension
path.extname("index.html"); // ".html"
path.extname("index.");     // "."
path.extname("index");      // ""

// Normalize
path.normalize("/foo/bar//baz/./qux/../"); // "/foo/bar/baz"

// Check absolute
path.isAbsolute("/foo");  // true
path.isAbsolute("foo");   // false

// Relative path
path.relative("/foo/bar", "/foo/baz"); // "../baz"

// Parse and format
const parsed = path.parse("/foo/bar/baz.txt");
// { root: "/", dir: "/foo/bar", base: "baz.txt", ext: ".txt", name: "baz" }

path.format({ dir: "/foo/bar", base: "baz.txt" }); // "/foo/bar/baz.txt"