https://github.com/davidjbradshaw/auto-console-group
Automagically group console messages
https://github.com/davidjbradshaw/auto-console-group
automatic console group
Last synced: 5 months ago
JSON representation
Automagically group console messages
- Host: GitHub
- URL: https://github.com/davidjbradshaw/auto-console-group
- Owner: davidjbradshaw
- License: mit
- Created: 2025-03-04T12:10:54.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-02T12:18:51.000Z (8 months ago)
- Last Synced: 2025-10-02T12:55:48.784Z (8 months ago)
- Topics: automatic, console, group
- Language: TypeScript
- Homepage:
- Size: 1.26 MB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.
_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)
---
[
](https://badge.fury.io/js/auto-console-group)
_© 2025 David J. Bradshaw - License MIT_