CStack

Debug your code, not the Runtime

• TypeScript supported
• CommonJS (Node.js) supported
• ECMAScript Modules (ESM) supported

Table of Contents

• Why
• Installation
• Example
• License

Why

As a developer you'll often need to inspect call stacks to debug your code, not the Runtime. Tools like Error.stack() provide more information than needed, cluttering your call stack with Runtime internals (i.e. node:internals) which you don't care about; you're only concerned with your code.

Installation

npm i cstack # includes type definitions for TypeScript support

Example

import cstack from "cstack";

function firstCall() {
  console.debug("1");
  secondCall();
}

function secondCall() {
  console.debug("2");
  thirdCall();
}

function thirdCall() {
  console.debug("3");
  console.log(cstack.getStack()); // -> StackFrame[]
  console.log(cstack.getParent("secondCall")); // -> "firstCall"
  console.log(cstack.getTrace(true)); // -> reversed stack trace (chronological)
}

firstCall();

License

MIT License