ErrorSnap Documentation

ErrorSnap is a powerful browser extension that automatically captures, formats, and shares JavaScript errors with your team through multiple integrations.

Automatic Screenshots

Captures full-page screenshots at the moment errors occur, including cursor position and page state.

Smart Error Detection

Monitors JavaScript errors, warnings, console assertions, and unhandled promise rejections.

Multiple Integrations

Share errors directly to Jira, Discord, Slack, Microsoft Teams with rich formatting and attachments.

Network Context

Captures recent network activity to provide context around when errors occurred.

Installation

Download the Extension

Download the ErrorSnap extension from the Chrome Web Store or load it as a developer extension.

chrome://extensions/ → Developer mode → Load unpacked

Enable the Extension

Click the ErrorSnap icon in your browser toolbar and ensure it's enabled.

Configure Your Preferences

Set up capture options, download preferences, and integrations according to your needs.

Quick Start

Get up and running with ErrorSnap in minutes:

Basic Usage

1. Install and enable ErrorSnap
2. Navigate to any webpage
3. When an error occurs, ErrorSnap automatically captures it
4. View the error toast with screenshot and details
5. Download or share the error report

First Configuration

1. Click the ErrorSnap extension icon
2. Enable "Auto-download snapshots" for automatic saves
3. Choose which error types to capture
4. Set up at least one sharing integration
5. Test your configuration

Basic Settings

Configure the core functionality of ErrorSnap:

Setting	Description	Default
`enabled`	Master switch to enable/disable ErrorSnap functionality	Enabled
`autoClose`	Automatically close error toasts after 15 seconds	Enabled
`hidePopups`	Silent mode - capture errors without showing toasts	Disabled
`debug`	Show detailed console logs for debugging	Disabled

Capture Options

Configure which types of errors and events to capture:

Error Types

JavaScript Errors

Enabled

Captures uncaught JavaScript exceptions and runtime errors

Console Warnings

Enabled

Captures console.warn() messages and browser warnings

Console Info

Disabled

Captures console.info() messages (can be noisy)

Unhandled Promise Rejections

Enabled

Captures unhandled Promise rejections and async errors

Console Assertions

Enabled

Captures failed console.assert() statements

Download Settings

Configure how ErrorSnap handles file downloads and organization:

Auto-Download

Automatically download error reports as soon as they're captured.

File Format:errorsnap-{timestamp}.png

Folder Organization

Organize downloads into folders by date and domain.

Structure:

Downloads/
  ErrorSnap/
    2025-07-11/
      example.com/
        errorsnap-20250711-143052.png

Jira Integration

Create Jira tickets directly from error reports with rich formatting and screenshot attachments.

Setup Requirements

Jira Cloud instance or Jira Server

API token or username/password authentication

Project key and permission to create issues

Discord Integration

Send error notifications to Discord channels with rich embeds and file attachments.

Discord Webhook Setup

1. Go to your Discord server settings

2. Navigate to Integrations → Webhooks

3. Create a new webhook for your channel

4. Copy the webhook URL

5. Configure in ErrorSnap with the webhook URL

Slack Integration

Share error reports to Slack channels with formatted messages and attachments.

Parameter	Description	Example
`webhookUrl`	Slack incoming webhook URL	https://hooks.slack.com/services/...
`channel`	Override default channel	#errors, @username
`username`	Bot display name	ErrorSnap Bot

Microsoft Teams Integration

Share error reports to Microsoft Teams channels with adaptive card formatting.

Teams Webhook Setup

1. Open Microsoft Teams and navigate to your channel
2. Click the "..." menu → Connectors
3. Find "Incoming Webhook" and click Configure
4. Provide a name and upload an icon (optional)
5. Copy the webhook URL
6. Configure in ErrorSnap with the webhook URL

Performance Monitoring

Monitor and capture performance issues like long-running tasks and slow operations.

Long Task Monitoring

Automatically detect and capture tasks that block the main thread for more than 50ms.

Performance Metrics

Track Core Web Vitals including LCP, FID, and CLS with context around errors.

Network Tracking

Capture network request context around error occurrences.

Tracked Information

• Request URLs and methods
• Response status codes
• Request/response timings

• Failed network requests
• CORS errors
• Timeout issues

Developer Options

Advanced configuration options for development and debugging.

Debug ModeDisabled

Enable detailed console logging for troubleshooting

Local Storage ExportAvailable

Export configuration and captured errors for analysis

Configuration API

Programmatically configure ErrorSnap settings via JavaScript.

// Configure ErrorSnap programmatically
window.ErrorSnap = {
  config: {
    enabled: true,
    autoClose: true,
    hidePopups: false,
    integrations: {
      jira: {
        url: 'https://your-domain.atlassian.net',
        username: 'your-email@company.com',
        apiToken: 'your-api-token',
        projectKey: 'ERROR'
      }
    }
  }
};

Troubleshooting

Extension Not Working

• Check if the extension is enabled in chrome://extensions/

• Verify the extension has permissions for the current site

• Try refreshing the page after enabling

• Check browser console for any permission errors

Integration Not Working

• Verify webhook URLs and API credentials

• Test the integration with a manual error trigger

• Check network tab for failed requests

• Ensure CORS is properly configured

FAQ

Is my data secure?

Yes, all processing happens locally in your browser. No data is sent to ErrorSnap servers.

Does it work on all websites?

ErrorSnap works on most websites. Some sites with strict CSP policies may require additional configuration.

Can I customize the error format?

Yes, each integration supports custom formatting and you can configure which data to include.

Where can I find more help?

For comprehensive help, visit our complete documentation or contact our support team at support@errorsnap.io

Changelog

v1.0.0

July 11, 2025

Added

• Jira REST API integration with real file attachments
• Discord webhook integration with rich embeds
• Slack webhook integration with formatted messages
• Microsoft Teams webhook integration
• Automatic screenshot capture with cursor position
• Network request tracking and context
• Performance monitoring for long tasks
• Configurable error type filtering
• Auto-download with folder organization
• Silent mode for production environments

Technical

• Chrome Extension Manifest V3 compatibility
• Service worker background script
• Persistent storage for configuration
• CORS-free webhook sending via background script
• Comprehensive error handling and validation