fix(tracker): add enableJSErrorTracking as configuration option

cherry-picked from 1586d78

Author: EmmanuelRoux

projects/tracker/src/lib/configuration.ts

@@ -21,6 +21,7 @@ export const INTERNAL_MATOMO_CONFIGURATION = new InjectionToken<InternalMatomoCo
         enableLinkTracking: true,
         trackAppInitialLoad: false,
         requireConsent: MatomoConsentMode.NONE,
+        enableJSErrorTracking: false,
         ...requireNonNull(inject(MATOMO_CONFIGURATION, InjectFlags.Optional), CONFIG_NOT_FOUND),
       } as InternalMatomoConfiguration),
   }
@@ -102,6 +103,9 @@ export interface BaseMatomoConfiguration {
    * See Matomo guide: {@link https://developer.matomo.org/guides/tracking-consent}
    */
   requireConsent?: MatomoConsentMode;
+
+  /** Set to `true` to enable Javascript errors tracking as <i>events</i> (with category <i>JavaScript Errors</i>) */
+  enableJSErrorTracking?: boolean;
 }
 
 export interface BaseAutoMatomoConfiguration {

projects/tracker/src/lib/matomo-initializer.service.spec.ts

@@ -153,6 +153,27 @@ describe('MatomoInitializerService', () => {
     expect(tracker.requireCookieConsent).toHaveBeenCalledBefore(tracker.trackPageView);
   });
 
+  it('should enable JS errors tracking if enabled', () => {
+    // Given
+    const service = instantiate({
+      mode: MatomoInitializationMode.MANUAL,
+      trackAppInitialLoad: true,
+      enableJSErrorTracking: true,
+    });
+    const tracker = TestBed.inject(MatomoTracker);
+
+    spyOn(tracker, 'trackPageView');
+    spyOn(tracker, 'enableJSErrorTracking');
+
+    // When
+    service.init();
+
+    // Then
+    expect(tracker.trackPageView).toHaveBeenCalledTimes(1);
+    expect(tracker.enableJSErrorTracking).toHaveBeenCalledTimes(1);
+    expect(tracker.enableJSErrorTracking).toHaveBeenCalledBefore(tracker.trackPageView);
+  });
+
   function setUpScriptInjection(cb: (injectedScript: HTMLScriptElement) => void): void {
     const mockContainer = jasmine.createSpyObj<HTMLElement>('FakeContainer', ['insertBefore']);
     const mockExistingScript = jasmine.createSpyObj<HTMLScriptElement>('FakeExistingScript', [], {

projects/tracker/src/lib/matomo-initializer.service.ts

@@ -109,6 +109,10 @@ export class MatomoInitializerService {
       tracker.requireConsent();
     }
 
+    if (this.config.enableJSErrorTracking) {
+      tracker.enableJSErrorTracking();
+    }
+
     if (this.config.trackAppInitialLoad) {
       tracker.trackPageView();
     }