@pascaliske/ngx-sentry NPM

`@pascaliske/ngx-sentry`

This library provides an ErrorHandler and a HttpInterceptor for connecting an Angular application with Sentry service.

Requirements

To use this library you need to install the @sentry/browser library into your project

$ yarn add @sentry/browser

Installation

To install the library itself use the following command:

$ yarn add @pascaliske/ngx-sentry

Usage

Import the provideSentry() function in your application configuration file. The function expects an object with at least the following two keys: enabled, sentry. More options can be found in the SentryOptions section below.

import type { ApplicationConfig } from '@angular/core'
import { provideSentry } from '@pascaliske/ngx-sentry'

export const appConfig: ApplicationConfig = {
    providers: [
        provideExperimentalZonelessChangeDetection(),
        provideSentry({
            enabled: true,
            sentry: {
                dsn: 'https://your-sentry-dsn@sentry.io',
            },
        }),
    ],
}

`SentryService`

You can use the SentryService injectable to manually capture errors or events as follows:

@Component({
    // [...]
})
export class AppComponent {
    public constructor(private sentryService: SentryService) {}

    public ngOnInit(): void {
        // capture single error
        this.sentryService.captureException(new Error(''))

        // capture single error with additional context information
        this.sentryService.withScope(scope => {
            scope.setExtra('currentPage', window.location.href)
            this.sentryService.captureException(new Error(''))
        })
    }
}

Note: The SentryService inherits all methods directly from the Sentry library. For more information about their APIs you can visit their documentation.