@ricsam/quickjs-console

Console API with logging, timing, counting, and grouping.

import { setupConsole } from "@ricsam/quickjs-console";

const handle = setupConsole(context, {
  handlers: {
    onLog: (level, args) => {
      console.log(`[${level}]`, ...args);
    },
    onTime: (label, duration) => {
      console.log(`${label}: ${duration}ms`);
    },
    onCount: (label, count) => {
      console.log(`${label}: ${count}`);
    },
  },
});

// Access console state
handle.getTimers();    // Map<string, number> - active timers
handle.getCounters();  // Map<string, number> - counter values
handle.getGroupDepth(); // number - current nesting level
handle.reset();        // Clear all state

Injected Globals:

• console.log, console.warn, console.error, console.debug, console.info
• console.trace, console.dir, console.table
• console.time, console.timeEnd, console.timeLog
• console.count, console.countReset
• console.group, console.groupCollapsed, console.groupEnd
• console.assert, console.clear

Usage in QuickJS:

// Basic logging
console.log("Hello", { name: "World" });
console.warn("Warning message");
console.error("Error occurred");

// Timing
console.time("operation");
// ... do work ...
console.timeLog("operation", "checkpoint");
// ... more work ...
console.timeEnd("operation"); // Logs: "operation: 123ms"

// Counting
console.count("clicks");     // clicks: 1
console.count("clicks");     // clicks: 2
console.countReset("clicks");
console.count("clicks");     // clicks: 1

// Grouping
console.group("User Info");
console.log("Name: John");
console.log("Age: 30");
console.groupEnd();

// Assertions
console.assert(1 === 1, "Math works");      // No output
console.assert(1 === 2, "Math is broken");  // Logs assertion failure

Event Handlers:

| Handler | Description | |---------|-------------| | onLog | Called for log, warn, error, debug, info, trace, dir, table | | onTime | Called when console.timeEnd completes a timer | | onTimeLog | Called when console.timeLog logs without ending | | onCount | Called when console.count increments | | onCountReset | Called when console.countReset resets a counter | | onGroup | Called when console.group or groupCollapsed is invoked | | onGroupEnd | Called when console.groupEnd is invoked | | onAssert | Called when console.assert fails | | onClear | Called when console.clear is invoked |