README.md

@18f/identity-analytics

Utilities and custom elements for logging events and errors in the application.

Usage

Programmatic Event Tracking

Track an event or error from your code using exported function members.

import { trackEvent, trackError } from '@18f/identity-analytics';

button.addEventListener('click', () => {
  trackEvent('button_clicked', { success: true });
});

try {
  doSomethingRisky();
} catch (error) {
  trackError(error);
}

HTML Element Click Tracking

Use the <lg-click-observer> custom element to record clicks within the element.

import '@18f/identity-analytics/click-observer-element';

The custom element will implement the analytics logging behavior, but all markup must already exist.

<lg-click-observer event-name="button_clicked">
  <button type="button">Click me!</button>
</lg-click-observer>