Combinations

dumpkit places no limits on your creativity. All functions are independent and pure – you can use them in any order, inside conditionals, loops, or combined with native Node.js code.

The combinations listed below are just examples to illustrate the composable spirit of the library. In practice, you can create countless others.

---

Examples of combinations

Dump with stack trace

dump(value);
trace();

Dump with timing

const { result } = measure('operation', () => fn());
dump(result);

Dump with tree view

dump(structure, { view: 'tree' });

Dump with table view

dump(users, { view: 'table' });

Dump and pause

await dp(value);

Dump, stack and pause

trace();
await dp(value);

Dump and die with stack

trace();
dd(value);

Measure and die

const { result } = measure('operation', () => fn());
dd(result);

Inspect without colors and save

const str = inspect(object, { colors: false });
fs.writeFileSync('debug.json', str);

Save tree to file

const treeStr = inspect(structure, { view: 'tree', colors: false });
fs.writeFileSync('tree.txt', treeStr);

Programmatic analysis

const analysis = analyze(data);
console.log(analysis.type);
console.log(analysis.properties.length);

Detect circular references

const analysis = analyze(obj);
const isCircular = analysis.properties.some(p => p.value.type === 'circular');

Multiple values in dump

Currently, to display multiple values, group them in an object:

dump({ v1, v2, v3 });

Combine with native code

// Conditional dump
if (process.env.DEBUG) dump(data);

// Accumulate measurements
const m1 = measure('A', fnA).measurement;
const m2 = measure('B', fnB).measurement;
dump({ m1, m2 });

// Redirect to file
const stream = createWriteStream('./debug.log');
trace('checkpoint', { stream });
await measure('query', () => db.query(sql), { stream });

---

Combinations table

Name	Description	Code
ddd	Dump with stack trace	dump(value); trace()
ddt	Dump with timing	dump(measure('op', () => fn()).result)
ddtv	Dump with timing and tree view	dump(measure('op', () => fn()).result, { view: 'tree' })
dp	Dump and pause	await dp(value)
dpp	Dump, stack and pause	trace(); await dp(value)
ddds	Dump, stack and die	trace(); dd(value)
ddts	Timing and die	dd(measure('op', () => fn()).result)
dds	Silent dump (no colors)	dump(obj, { colors: false })
ddp	Dump with limited depth	dump(obj, { depth: 2 })
dda	Dump with array limit	dump(arr, { maxArrayLength: 20 })
tdd	Trace with full stack	trace('point', { showStack: true })
id	Inspect and save	fs.writeFileSync('log', inspect(obj, { colors: false }))
cd	Conditional dump	if (debug) dump(data)
cm	Compare measurements	const a = measure('A', fnA).measurement; const b = measure('B', fnB).measurement; dump({ a, b })
tree	Tree view	dump(obj, { view: 'tree' })
table	Table view	dump(arr, { view: 'table' })
analyze	Programmatic analysis	const analysis = analyze(obj)

---

Conclusion

The 7 base functions – dump, dd, dp, inspect, trace, measure, analyze – form a small vocabulary. With them, you can combine infinitely to solve any debugging need.

This documentation only suggests some useful patterns, not an exhaustive list. Feel free to create your own combinations and share them with the community.