# error-visualizer

> An interactive and visually appealing error visualization tool for Node.js. Transforms cryptic stack traces into colorful, ASCII art-enhanced displays with helpful tips and an interactive exploration mode.

Latest version **1.2.1** (published 2024-09-28) · MIT license · 0 weekly downloads

## Install

```sh
npm install error-visualizer
pnpm add error-visualizer
yarn add error-visualizer
bun add error-visualizer
```

## Health

**Score 25/100 (F)** — status: maintenance-mode.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.1 |
| Published | 2024-09-28 |
| First published | 2024-09-28 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 7.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Your Name |
| Maintainers | vanished01 |
| Keywords | error, visualization, debug, terminal, console, ascii-art, interactive, stack-trace, error-handling, developer-tools, node, cli, colorful, troubleshooting, error-messages |

## Links

- npm: https://www.npmjs.com/package/error-visualizer
- npm.io page: https://npm.io/package/error-visualizer

## Dependencies (2)

- [boxen](https://npm.io/package/boxen.md) ^5.1.2
- [chalk](https://npm.io/package/chalk.md) ^4.1.2

## Alternatives

- [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads
- [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads
- [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads
- [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads
- [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads

## Recent versions

- 1.2.1 (latest) — 2024-09-28
- 1.2.0 — 2024-09-28

## README

# error-visualizer

An interactive and visually appealing error visualization tool for Node.js. Transform cryptic stack traces into colorful, ASCII art-enhanced displays with helpful tips and an interactive exploration mode.

## Features

- 🎨 Colorful error messages with ASCII art
- 🔍 Interactive mode for exploring error details
- 📊 Error statistics tracking
- 🌈 Customizable color themes
- 🌐 Global error handling for uncaught exceptions
- 💡 Helpful tips for common error types

## Installation

```bash
npm install error-visualizer
```

## Usage

### Basic Usage

```javascript
const { visualizeError } = require('error-visualizer');

try {
  // Your code that might throw an error
  throw new Error('This is a test error');
} catch (error) {
  visualizeError(error);
}
```

### Global Error Handling

```javascript
const { setupGlobalErrorHandling } = require('error-visualizer');

// Set up global error handling
setupGlobalErrorHandling({ interactive: true });

// Your code here
// Any uncaught errors will be visualized
```

## Interactive Mode

When using the interactive mode, you can:

1. View the full stack trace
2. See error statistics
3. Change the color theme
4. Exit the interactive mode

## Customization

You can customize the appearance and behavior of the error visualizer:

```javascript
const { visualizeError } = require('error-visualizer');

// Customize options
const options = {
  interactive: true, // Enable interactive mode
  theme: 'matrix', // Set initial color theme
};

visualizeError(error, options);
```

## Acknowledgements

- [chalk](https://github.com/chalk/chalk) for terminal string styling
- [boxen](https://github.com/sindresorhus/boxen) for creating boxes in the terminal

---

Happy debugging! 🐛🔍

---
_Source: https://npm.io/package/error-visualizer · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._