Error Reporting Client for Client-side JavaScript

JavaScript client for Google Cloud Error Reporting.

It can be used in web browsers.

Inspired by stackdriver-errors-js, added the ability to insert the source location to the request body automatically, and changed the behavior if the source maps are available.

Prerequisites

See the Prerequisites in the stackdriver-errors-js package.

Installation

npm i error-reporting-client
# if you use pnpm
pnpm i error-reporting-client

Usage

import ErrorReporting from "error-reporting-client";

// Initialize the error reporting client with your API key and project ID
const reportClient = new ErrorReporting({
    apiKey: "YOUR_API_KEY",
    projectId: "YOUR_PROJECT_ID",
    // below are optional
    // 
    // service: "my-service",
    // version: "1.0.0",
    // reportUncaughtExceptions: true,
    // reportUnhandledPromiseRejections: true,
    // sourceReferences: [
    //     {
    //         repository: "",
    //         revisionId: "",
    //     },
    // ],
});

// Register the global error and unhandled promise rejection handlers
reportClient.registerHandler();

// Set the user identifier
reportClient.setUser("john-smith");

// Send an error report manually
try {
    // code that might throw an error
} catch(e) {
    reportClient.sendError(e);
}

// You can also provide a source location
reportClient.sendError(new Error("An error occurred"), {
    filePath: "src/App.tsx",
    lineNumber: 53,
    functionName: "App",
});

as a utility

// errorHandler.ts
import ErrorReporting from "error-reporting-client";

let errorHandler: ErrorReporting | undefined
if (typeof window !== "undefined" && typeof errorHandler === "undefined") {
    errorHandler = new ErrorReporting({
        apiKey: "YOUR_API_KEY",
        projectId: "YOUR_PROJECT_ID",
    })
    errorHandler.registerHandler()
}
export default errorHandler

import errorHandler from "./errorHandler"

errorHandler?.sendError(err);

API

ErrorReporting

constructor(options: { projectId: string; apiKey: string; service?: string; version?: string; reportUncaughtExceptions?: boolean; reportUnhandledPromiseRejections?: boolean; sourceReferences?: SourceReference[]; })

Creates a new instance of the ErrorReporting client.

• projectId: Your Google Cloud project ID.
• apiKey: Your Google Cloud API key.
• service: (Optional) The service name. Defaults to "web".
• version: (Optional) The version of the service.
• reportUncaughtExceptions: (Optional) Whether to report uncaught exceptions. Defaults to true.
• reportUnhandledPromiseRejections: (Optional) Whether to report unhandled promise rejections. Defaults to true.
• sourceReferences: (Optional) A list of source references.

setUser(user: string | undefined): void

Sets the user identifier for error reports.

• user: The user identifier.

disable(): void

Disables error reporting.

enable(): void

Enables error reporting.

registerHandler(): void

Registers global error and unhandled promise rejection handlers.

sendError(err: Error | string, reportLocation?: SourceLocation): Promise<void>

Sends an error report.

• err: The error to report.
• reportLocation: (Optional) The location in the source code where the error was reported. If not provided, the location is determined automatically.

SourceLocation

Indicates a location in the source code of the service for which errors are reported.

• filePath: The source code filename, which can include a truncated relative path, or a full path from a production machine.
• lineNumber: (Optional) 1-based. 0 indicates that the line number is unknown.
• functionName: Human-readable name of a function or method. The value can include optional context like the class or package name.

SourceReference

A reference to a particular snapshot of the source tree used to build and deploy an application.

• repository: (Optional) A URI string identifying the repository.
• revisionId: The canonical and persistent identifier of the deployed revision.