Breadcrumbs

Track user actions leading up to an error. Breadcrumbs are automatically included in error reports.

Automatic Collection

Call initBreadcrumbs() to automatically track clicks, navigation, fetch requests, and console messages:

import { initBreadcrumbs } from 'errormail';

// Initialize automatic breadcrumb collection
initBreadcrumbs();

Manual Breadcrumbs

Add custom breadcrumbs to track important user actions:

import { addBreadcrumb, BreadcrumbCategory } from 'errormail';

// Track user actions
addBreadcrumb('User logged in', BreadcrumbCategory.USER, { userId: 123 });
addBreadcrumb('Viewed dashboard', BreadcrumbCategory.NAVIGATION, { page: '/dashboard' });
addBreadcrumb('API call', BreadcrumbCategory.HTTP, { endpoint: '/api/users' });

Breadcrumb Categories

BreadcrumbCategory.UIUser interface interactions (clicks, etc.)
BreadcrumbCategory.NAVIGATIONPage navigation
BreadcrumbCategory.HTTPHTTP requests
BreadcrumbCategory.CONSOLEConsole messages
BreadcrumbCategory.USERUser actions
BreadcrumbCategory.MANUALManual breadcrumbs (default)

Managing Breadcrumbs

import { getBreadcrumbs, clearBreadcrumbs } from 'errormail';

// Get all breadcrumbs
const crumbs = getBreadcrumbs();
console.log(crumbs);

// Clear breadcrumbs (e.g., on logout)
clearBreadcrumbs();