Skip to main content

Vue / Browser — Configuration

createSignal(options) accepts the browser SDK options. Required: apiKey, projectId. Optional: endpoint (defaults to https://api.trysignal.ai/). Same options apply in Vue, Vanilla JS, Svelte, Angular, or any framework.

Transport and batching

OptionTypeDefaultDescription
compressionbooleantrueGzip events before sending
flushIntervalnumber2000Flush interval in ms
maxBatchSizenumber50Max events per batch before flush
getSignedUploadUrl(sessionId: string) => Promise<string>Custom signed URL for uploads

Features

OptionTypeDefaultDescription
enableSessionReplaybooleantrueEnable rrweb session replay
enableNetworkCapturebooleantrueCapture fetch/XHR in replay
enableConsoleCapturebooleantrueCapture console logs
enableSessionTrackingbooleantrueTrack page views, session start/end, performance (including $pageleave on unload/visibility change)
enablePerformanceTrackingbooleantrueTrack Web Vitals and performance metrics
enableBrowserDetectionbooleantrueRun browser compatibility checks
debugbooleanfalseEnable debug logging

sessionRecordingMasking

Session recording masking controls how sensitive content appears in replays. The recorder (rrweb) applies these rules when capturing the DOM: blocked elements are removed or replaced with a placeholder; masked text is replaced with asterisks (or a custom string); ignored inputs do not record value changes (only focus/blur). You can target elements by CSS class, CSS selector, or (for custom logic) a function. How the options work
  • blockClass / blockSelector — Elements matching the class or selector are fully hidden in the replay (replaced with a placeholder). Use for entire sections you don’t want visible (e.g. sidebar with PII, payment forms). Default class: signal-no-capture.
  • maskTextClass / maskTextSelector — Text content of matching elements is replaced with asterisks (***) in the replay. Use for sensitive text (names, emails, IDs) that you still want to show layout for. Default class: signal-mask.
  • maskTextFn — Optional (text, element?) => string. Called for each masked text node; return the string to show in the replay (e.g. '[REDACTED]' or partial mask). If you return the original text, it is not masked.
  • ignoreClass — Inputs/textarea with this class do not have their values recorded; only focus and interaction are. Use when you want to hide what the user typed but keep the fact they used the field. Default class: signal-ignore-input.
  • maskAllInputs — When true, all <input> and <textarea> values are masked in the replay (replaced with asterisks). When false (default), only inputs matching maskInputOptions or password type are masked.
  • maskInputOptions — Per–input-type control when maskAllInputs is false. Keys: text, email, tel, textarea, number, search, url, password, etc. Set to true to mask that type. Password is always masked.
  • maskInputFn — Optional (text, element?) => string. Called for each masked input value; return the string to show in the replay (e.g. last 4 digits only).
Example
createSignal({
  apiKey: '...',
  projectId: '...',
  // endpoint is optional (defaults to https://api.trysignal.ai/)
  sessionRecordingMasking: {
    blockClass: 'signal-no-capture',
    blockSelector: '[data-private]',
    maskTextClass: 'signal-mask',
    maskAllInputs: false,
    maskInputOptions: { text: true, email: true, tel: true, textarea: true, password: true },
  },
});
In your markup: class="signal-no-capture" (hide), class="signal-mask" (mask text), class="signal-ignore-input" (ignore input values).
OptionTypeDefaultDescription
blockClassstring | RegExp'signal-no-capture'CSS class: elements fully hidden in replay
blockSelectorstring | nullnullCSS selector for elements to block
ignoreClassstring | RegExp'signal-ignore-input'CSS class: input value changes not recorded
maskTextClassstring | RegExp'signal-mask'CSS class: text replaced with asterisks
maskTextSelectorstring | nullnullCSS selector for text to mask
maskTextFn(text, element?) => string | nullnullCustom function to transform masked text
maskAllInputsbooleanfalseWhen true, mask all input/textarea values
maskInputOptionsobjectPer-type masking (text, email, tel, textarea, select, etc.)
maskInputFn(text, element?) => string | nullnullCustom function to transform masked input values

networkCaptureOptions

Network capture records fetch and XHR requests so they appear in the session replay (URL, method, and optionally headers and body). These options control what is captured and how it is redacted. How the options work
  • recordHeaders — When true, request and response headers are included. Turn on only if needed; redact sensitive headers via sensitiveHeaders.
  • recordBody — When true, request and response bodies are captured (up to payloadSizeLimitBytes). Use with care for PII; use maskRequestFn or exclude sensitive URLs via urlDenyList.
  • sensitiveHeaders — Array of header names (case-insensitive) to redact in captured data (e.g. authorization, cookie, x-api-key). Their values are replaced with a placeholder.
  • urlDenyList — Array of URL strings or RegExp. Requests whose URL matches are excluded from capture. Default excludes Signal ingestion: ['api.trysignal.ai']. Add entries to skip health checks, analytics, or any URL that must not appear in replays.
  • payloadSizeLimitBytes — Max size (bytes) of request/response body to capture. Larger bodies are truncated. Default 1000000 (1 MB).
  • maskRequestFn — Optional (request) => request \| null. Return a modified request to redact fields, or return null to drop this request from capture (e.g. for sensitive endpoints).
Example
networkCaptureOptions: {
  recordHeaders: true,
  recordBody: true,
  sensitiveHeaders: ['authorization', 'cookie', 'x-api-key', 'x-auth-token'],
  urlDenyList: ['/api/health', /^https:\/\/analytics\.example\.com/],
  payloadSizeLimitBytes: 500000,
  maskRequestFn: (req) => (req.url?.includes('/api/payment') ? null : req),
},
OptionTypeDefaultDescription
recordHeadersbooleanfalseInclude request/response headers
recordBodybooleanfalseInclude request/response body
sensitiveHeadersstring[]Header names to redact
urlDenyList(string | RegExp)[]URLs or patterns to exclude from capture
payloadSizeLimitBytesnumber1000000Max payload size to capture (1 MB)
maskRequestFn(request) => request | nullCustom function to redact or drop requests

consoleCaptureOptions

OptionTypeDefaultDescription
levels('log' | 'info' | 'warn' | 'error' | 'debug')[]['log','warn','error']Console levels to capture
captureErrorsbooleantrueCapture uncaught errors
captureUnhandledRejectionsbooleantrueCapture unhandled promise rejections
stringLengthLimitnumber1000Max length of console log strings
maskSensitiveDatabooleantrueMask sensitive patterns in console output

Session and advanced

OptionTypeDefaultDescription
sessionIdstringBootstrap a specific session ID
sessionIdleTimeoutSecondsnumber1800Session considered idle after this many seconds
maxSessionLengthSecondsnumber86400Max session length (24h)
addTracingHeadersboolean | string[]trueAdd session/window headers to fetch/XHR; only needed for Node correlation
rrwebConfigRecord<string, unknown>Raw rrweb recorder options
requiredBrowserFeatures('fetch' | 'promises' | ...)[]['fetch','promises']Features required for compatibility check
debugPersistToLocalStoragebooleanfalsePersist debug events to localStorage
debugLocalStorageKeystring'signal_debug_events'Key for debug persistence
Page leave ($pageleave) is automatic when enableSessionTracking is true. There is no separate capturePageleave API.

See also