Document Angular SDK installation for standalone component Angular projects

[Lms24]

Core or SDK?

Platform/SDK

Which part? Which one?

@sentry/angular-ivy

Description

Since Angular 16 (I belive), entire Angular applications can created without declaring a single NgModule, by only using standalone components.

We currently instruct users to declare our providers (ErrorHandler, TraceService) in app.module.ts which doesn't exist in this case.

Suggested Solution

Add instructions how to declare providers in app.config.ts. There are no big differences except for the used Angular API but we should nevertheless cover this in our docs.

Kind of blocked on getsentry/sentry-javascript#9376 since I first want to figure out the best course of action around using the SDK in SSR Angular 17 apps.

[zip-fa]

I suggest you to create dedicated provideSentryErrorHandler() function, which will do this under-the-hood:

import { createErrorHandler } from ‘@sentry/angular-ivy’;

export function provideSentryErrorHandler(opts: SomeOptsType = {}) {
return {
      provide: ErrorHandler,
      useValue: createErrorHandler(opts)
    }
}

and use it in standalone application just by calling this fn like this:

providers: [
provideSentryErrorHandler({ showDialog: true })
]

[Lms24]

Good idea! Would you be interested in opening a PR for this? No worries if not, I'll get to it next week.

[zip-fa]

PR for provider fn or for docs?:)

[Lms24]

@zip-fa I was thinking about the provider helper functions but any help is appreciated :)

I wrote up an issue to track the provider functions in the SDK repo: getsentry/sentry-javascript#9407.

[getsantry]

Routing to @getsentry/product-owners-sdks-web-frontend for triage ⏲️

[vadimcoder]

We need this

[OAuthority]

Is there any update for this, please?

[Lms24]

Hey, sorry, no updates. The SDK works in NGModule-less angular apps. It's not ideal but for now, to set up the SDK you can refer to an example app we use to E2E test the Angular SDK:

• src/main.ts
• src/app.config.ts

I bumped the prio for writing the guide but can't give ETAs, sorry (too much stuff going on 😢)

[garytube]

@Lms24 thx for the example. Hope to see it soon in the docs