# auto-console-group

> Automagically group console messages

Latest version **1.3.0** (published 2025-10-02) · MIT license · 0 weekly downloads

## Install

```sh
npm install auto-console-group
pnpm add auto-console-group
yarn add auto-console-group
bun add auto-console-group
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.3.0 |
| Published | 2025-10-02 |
| First published | 2025-03-23 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 15.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 5 |
| Author | David J. Bradshaw |
| Maintainers | davidjbradshaw |
| Keywords | console, group |

## Links

- npm: https://www.npmjs.com/package/auto-console-group
- Repository: https://github.com/davidjbradshaw/auto-console-group
- Homepage: https://github.com/davidjbradshaw/auto-console-group#readme
- Issues: https://github.com/davidjbradshaw/auto-console-group/issues
- npm.io page: https://npm.io/package/auto-console-group

## Recent versions

- 1.3.0 (latest) — 2025-10-02
- 1.2.0-beta.2 (beta) — 2025-03-30
- 1.2.13 — 2025-10-02
- 1.2.12 — 2025-10-02
- 1.2.11 — 2025-08-29
- 1.2.10 — 2025-07-16
- 1.2.9 — 2025-04-15
- 1.2.8 — 2025-04-10
- 1.2.7 — 2025-04-10
- 1.2.6 — 2025-04-10
- 1.2.5 — 2025-04-05
- 1.2.4 — 2025-04-04
- 1.2.3 — 2025-04-04
- 1.2.2 — 2025-04-02
- 1.2.1 — 2025-04-02
- … 11 more at https://npm.io/package/auto-console-group/versions

## README

<img src="./img/logo-green.svg" alt="Auto-Console-Group" label="" style="margin-bottom: -2px; width: 75%">

# Introduction

Tame the JS console by **automagically grouping console messages**.

 * **Simple**: Drop in replacement for the full console API.
 * **Automatic**: Groups messages by each [Event Loop](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Event_loop) iteration.
 * **Easier Debugging**: Makes it much clearer to see what is going on in your app.
 * **Adds Time Stamps**: Each grouping can be timestamped, to help better see what is happening.
 * **Reliable**: Uses a [Microtask](https://developer.mozilla.org/en-US/docs/Web/API/HTML_DOM_API/Microtask_guide/In_depth) to ensure the message group is always closed on time.

A more readable console output in a couple of minutes.

<img src="./img/example.png" alt="example output" label="">

_Above created by [example.ts](./example.ts)_.

## Install

Install _auto-console-group_ via npm.

```sh
npm install auto-console-group
```

Or download [auto-console-group.js](/davidjbradshaw/auto-console-group/blob/main/auto-console-group.js)

## Setup

The `createAutoConsoleGroup()` creates a console object with all the same methods as the regular `console` object,
plus a few additional [methods](#methods) to control how a group is displayed.

```js
import createAutoConsoleGroup from 'auto-console-group'

const consoleGroup = createAutoConsoleGroup({ label: 'autoConsoleGroup' })

// All console methods are reflected on consoleGroup
consoleGroup.log('Log message')
consoleGroup.table(['foo', 'bar'])
consoleGroup.count('Counter')

// Set the Event in the group heading
consoleGroup.event('myEvent')
```

## User Guide

* [Group Heading](https://github.com/davidjbradshaw/auto-console-group/blob/main/docs/group_heading.md)
* [Options](https://github.com/davidjbradshaw/auto-console-group/blob/main/docs/options.md)
* [Methods](https://github.com/davidjbradshaw/auto-console-group/blob/main/docs/methods.md)
* [Format Helpers](https://github.com/davidjbradshaw/auto-console-group/blob/main/docs/helpers.md)
* [Error Boundaries](https://github.com/davidjbradshaw/auto-console-group/blob/main/docs/error_boundaries.md)

---
[<img align="right" src="https://badge.fury.io/js/auto-console-group.svg" alt="NPM" />](https://badge.fury.io/js/auto-console-group)
_&copy; 2025 David J. Bradshaw - License MIT_

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