Configuration

init

import { init, sentry } as Spotlight from '@spotlightjs/spotlight';

init({
  integrations: [sentry()],
});

integrations

type: SpotlightIntegration[]

Defines which integrations should be loaded for Spotlight. Defaults to [sentry()].

init({
  integrations: [sentry()],
});

SpotlightIntegration

// TODO
type SpotlightIntegration = {};

debug

type: boolean default: false

Enables some debug output in console for debugging.

init({
  debug: true,
});

sidecarUrl

type: string default: "http://localhost:8969/stream"

The Sidecar event-source stream endpoint URL.

Set this option if you have the sidecar running on another URL than the default one.

init({
  sidecarUrl: 'http://localhost:8969/stream',
});

anchor

type: AnchorConfig

The anchor position for the toolbar.

init({
  anchor: 'centerRight',
});

experiments

type: ExperimentsConfig

Experimental configuration.

init({
  experiments: {
    'sentry:focus-local-events': false,
  },
});

AnchorConfig

type AnchorConfig = 'bottomRight' | 'bottomLeft' | 'centerRight' | 'centerLeft' | 'topLeft' | 'topRight';

ExperimentsConfig

type ExperimentsConfig = Record<ExperimentName, boolean>;

Experiment names are:

• sentry:focus-local-events - if set to true, errors and traces will hide events from other sessions when possible.

injectImmediately

type: boolean default: false

By default, Spotlight waits until the host page is loaded before injecting the Spotlight Overlay. Depending on how and when the init call is made, the load event might have already happened.

By setting injectImmediately to true, the UI will be injected synchronously with the init call.

Use this option, if you called init() but the Spotlight Overlay UI is not visible.

init({
  injectImmediately: true,
});

openOnInit

type: boolean default: false

If set to true, the Spotlight overlay Window will be opened immediately after calling the init function. By default, only the button is visible.

trigger

Trigger an event within Spotlight.

import { trigger } from '@spotlightjs/spotlight';

trigger('sentry:showError', {
  event: string,
  eventId: string,
});

type TriggerFunction = (eventName: string, eventPayload?: unknown)

fullPage

type: boolean default: false

If set to true, the Spotlight overlay will be rendered directly in the HTML as a relative <div/>. It’s helpful and goes well with injectImmediately. It’s used for rendering a blocking page like an error page or dedicated HTML. Also the ability for closing the overlay is disabled when this is avitce.