JS Global Error Handler SDK

A professional-grade, lightweight JavaScript library for capturing and reporting client-side errors.

https://www.npmjs.com/package/js-global-error-handler

Features

• Multi-Source Capture: Catch errors from window.onerror, Promise rejections, Fetch/XHR failures, and manual console.error calls.
• Normalization: Automatically formats various error types into a consistent JSON payload.
• Fingerprinting: Built-in deduplication to prevent flooding your servers with the same error.
• Aggressive Tracking: Monkey-patches core APIs in development/QA environments for deep visibility.
• Zero Dependencies: Lightweight and vanilla JavaScript.

Getting Started

Installation

npm install js-global-error-handler

Usage

Option 1: NPM (React, Vue, Angular, etc.)

import { init } from 'js-global-error-handler';

// Initialize at the very top of your app
init({
  endpoint: 'https://api.yourdomain.com/errors',
  method: 'POST', 
  env: 'production',
  reportingEnabled: true
});

Option 2: CDN / Script Tag (Legacy, Vanilla JS)

<!-- Load the library -->
<script src="https://cdn.jsdelivr.net/npm/js-global-error-handler/dist/tracker.umd.js"></script>

<script>
  ErrorTracker.init({
    endpoint: 'https://api.yourdomain.com/errors',
    method: 'POST',
    env: 'production'
  });
</script>

Configuration Options

Pass these options to the init() function:

Option	Type	Default	Description
endpoint	string	'/api/error/add'	API URL where errors will be sent.
method	string	'POST'	HTTP method (POST, PUT, GET).
env	string	'development'	Environment mode. production enables sending reports.
reportingEnabled	boolean	false	Master switch to enable/disable network reporting.
maxSameError	number	5	Prevents flooding by limiting duplicate error reports.
aggressiveTracking	boolean	true	Monkey-patches console.error, fetch, and XMLHttpRequest for deeper visibility.

Development commands

• npm run dev: Start development server with demo dashboard.
• npm run build: Build the library and demo files for production.

Directory Structure

• src/js/tracker.js: Main entry point.
• src/js/utils.js: Error normalization and logic.
• src/js/transports.js: Network transmission.
• src/js/config.js: Centralized settings.

License

MIT