@coralogix/browser
Version:
Official Coralogix SDK for browsers
579 lines (309 loc) • 11.2 kB
Markdown
# 3.19.1 (2026-07-12)
## 🩹 Fixes
- Type `sdkFetchPriority` with a locally-declared `SdkFetchPriority` alias instead of the DOM `RequestPriority`, so the SDK no longer fails to compile on TypeScript versions whose DOM lib predates `RequestPriority`
# 3.19.0 (2026-07-12)
## 🚀 Features
- Add `createNewSession()` API to manually rotate the session (e.g. on user logout)
# 3.18.0 (2026-07-08)
## 🚀 Features
- Add product analytics support for richer product-level insights
# 3.17.1 (2026-07-07)
## 🩹 Fixes
- Persist snapshot context across page reloads when `keepSessionAfterReload` is enabled, so session-level counters (views, errors, actions) no longer reset on refresh
# 3.17.0 (2026-07-06)
## 🚀 Features
- add configurable OpenTelemetry batch/flush via otelConfig
# 3.16.2 (2026-07-06)
## 🩹 Fixes
- Fix PII masking for password input field changes
- The default `maskInputTypes` is narrowed from `['password', 'email', 'tel']` to `['password']`, to match session-recording default. `email` and `tel` inputs are no longer masked by default in user-interaction events — set `maskInputTypes: ['password', 'email', 'tel']` to restore the previous behavior.
# 3.16.1 (2026-06-29)
## 🩹 Fixes
- Improve user-interaction accuracy: capture SVG icon clicks and resolve role-based/custom controls.
# 3.16.0 (2026-06-24)
## 🚀 Features
- Add support for configuring fetch priority on SDK network requests
# 3.15.1 (2026-06-23)
## 🩹 Fixes
- Improve user-interaction tracking accuracy
# 3.15.0 (2026-06-22)
## 🚀 Features
- Improved user-interaction tracking: smarter element fingerprinting and more accurate screenshot capture on clicks and navigation.
# 3.14.0 (2026-06-14)
## 🚀 Features
- Flush telemetry data on tab close with fetch keepalive support
# 3.13.0 (2026-06-11)
## 🚀 Features
- Improve user interaction with click and scroll coordinates, and viewport context
# 3.12.0 (2026-06-09)
## 🚀 Features
- Improve: capture screenshot on each unique view navigation
# 3.11.1 (2026-06-08)
## 🩹 Fixes
- SVG element support in session recording
- session recording after refreshing the page
# 3.11.0 (2026-06-04)
## 🚀 Features
- Add view number tracking for product analytics support
# 3.10.1 (2026-06-02)
## 🩹 Fixes
- Improve beforeSend to correctly reflect modifications in OpenTelemetry span attributes
# 3.10.0 (2026-05-25)
## 🚀 Features
- Improve user interaction instrumentation with richer element metadata
# 3.9.0 (2026-05-19)
## 🚀 Features
- Enrich spans with RUM context (cx_rum) to improve RUM–Tracing correlation.
# 3.8.3 (2026-05-10)
## 🩹 Fixes
- Improve web vitals attribution data by preventing deep nesting
# 3.8.2 (2026-05-06)
## 🩹 Fixes
- run web vitals listeners outside zone
# 3.8.1 (2026-05-06)
## 🩹 Fixes
Improve error stack trace handling.
# 3.8.0 (2026-04-27)
## 🚀 Features
- Add support for excluding specific instrumentations from session sampling
# 3.7.1 (2026-04-26)
## 🩹 Fixes
- Support error logging for non-JSON-serializable error properties
# 3.7.0 (2026-04-19)
## 🚀 Features
- Improve session recording with immediateFlush option to capture short-duration sessions (<10s)
# 3.6.0 (2026-04-09)
## 🚀 Features
- Add US3 domain
# 3.5.1 (2026-04-06)
## 🩹 Fixes
- Improve stacktrace truncation
# 3.5.0 (2026-03-26)
## 🚀 Features
- Run SDK Web APIs outside zone.js by default for Angular applications
# 3.4.1 (2026-03-25)
## 🩹 Fixes
- Improve MFE stacktrace metadata extraction stability
- Fix potential infinite loop in navigation tracking
# 3.4.0 (2026-02-26)
## 🚀 Features
- add numeric ID grouping to default URL blueprinter
# 3.3.0 (2026-02-24)
## 🚀 Features
- Enrich spans with RUM context (cx_rum) to improve RUM–Tracing correlation.
# 3.2.0 (2026-02-05)
- Create new zoneless CDN for Angular consumers
# 3.1.1 (2026-02-01)
## 🩹 Fixes
- Improve error instrumentation stability and performance
# 3.1.0 (2026-01-25)
## 🚀 Features
- Add optimized mutation handling in session recorder
# 3.0.2 (2026-01-20)
## 🩹 Fixes
- Revert mutation counter limit that could cause incomplete session recordings
# 3.0.1 (2026-01-18)
## 🩹 Fixes
- Improve session recorder performance
3.0.0 (2025-12-25)
## 🔥 Performance
- ⚠️ **browser:** disable TBT metric by default to reduce overhead.
## ⚠️ Breaking Changes
- TBT web-vitals metric is no longer collected by default. Enable it explicitly via config.
**For example**:
**Before**
All Web Vitals instrumentation metrics are enabled by default.
**After**
To enable the **TBT** metric, explicitly configure it as shown below:
```json
{
"instrumentations": {
"web_vitals": {
"metrics": {
"tbt": true
}
}
}
}
```
# 2.14.0 (2025-12-07)
## 🚀 Features
- **errors:** add stack traces to console error logs
# 2.13.0 (2025-12-07)
## 🩹 Fixes
- **traces-exporter:** improve trace metadata encoding
# 2.12.0 (2025-11-30)
## 🚀 Features
- Introduced the tracesExporter callback, enabling custom processing or exporting of collected trace events.
# 2.11.1 (2025-11-24)
## 🩹 Fixes
- Trigger snapshot context when setUserContext is called
# 2.11.0 (2025-11-23)
## 🚀 Features
- **trace:** allow custom propagator
# 2.10.1 (2025-11-17)
## 🩹 Fixes
- **url-fragments:** Fix URL encoding of template placeholders in page_fragments. Template placeholders like `{id}`, `{lbid}` etc. added by URL blueprinters are now preserved in `page_fragments` instead of being percent-encoded to `%7Bid%7D`, `%7Blbid%7D`. This ensures consistency between `page_url_blueprint` and `page_fragments`.
# 2.10.0 (2025-09-14)
## 🚀 Features
- **ignoreProxyUrlParams:** Added ignoreProxyUrlParams, which provides the ability to skip appending the Coralogix endpoint to the proxy URL.
# 2.9.0 (2025-08-18)
## 🚀 Features
- **fingerprint:** Added user fingerprint. The fingerprint is generated and stored on each user’s machine for reuse, and will be used to calculate the unique users count.
# 2.8.9 (2025-07-24)
## 🩹 Fixes
- **sdk:** improve SDK shutdown handling
# 2.8.8 (2025-07-20)
## 🩹 Fixes
- Worker monitoring support
# 2.8.7 (2025-06-30)
## 🩹 Fixes
- Add sessionId to span attr
- Fix adding network span to global span even when the global span is ended.
- Handle global span in idle mode.
# 2.8.6 (2025-06-26)
## 🧰 Improvements
- Bundle size optimization: Reduced the size of the browser SDK bundle.
- Bundle the error-stack-parser and shimmer libraries from cjs to esm to improve compatibility with various bundlers and environments.
# 2.8.5 (2025-06-25)
## 🩹 Fixes
- **web vitals:** add missing PerformanceNavigationTiming fields to LT event
# 2.8.4 (2025-05-29)
## 🩹 Fixes & Improvements
🛠 Custom Spans
- Traceparent propagation: XHR and Fetch requests now correctly include the global span traceId when using custom spans.
- Improved span creation: Enhanced the logic for generating custom child spans for more accurate trace hierarchy.
- Interaction tracing: User interaction instrumentation is now correctly linked to the global span context.
🧹 Logging
- Switched internal warning logs to debug level to reduce noise in production environments.
# 2.8.3 (2025-05-22)
## 🔥 Performance
- Optimize user agent parsing.
# 2.8.2 (2025-05-21)
## 🩹 Fixes
- Omit the INP attribution property to reduce the log payload size.
# 2.8.1 (2025-05-19)
## 🩹 Fixes
- Fix user interaction instrumentation from always being enabled.
# 2.8.0 (2025-05-11)
## 🚀 Features
Build CDN versions (ES5/ES2015)
# 2.7.0 (2025-05-05)
🚀 Features
Add Web Worker error handling.
# 2.6.0 (2025-05-04)
## 🚀 Features
- Add NPM compatibility for old browsers
# 2.5.0 (2025-04-29)
## 🚀 Features
- Add CDN compatibility for old browsers
# 2.4.2 (2025-04-29)
## 🩹 Fixes
- Support Smart TV user agents
# 2.4.1 (2025-04-14)
## 🩹 Fixes
- Reduce falsy recording sessions sent to API.
# 2.4.0 (2025-04-08)
## 🚀 Features
- Allow passing labels to Custom logs (log, warn, debug, etc...) API.
# 2.3.0 (2025-04-01)
## 🚀 Features
- Lazy load session recorder<br>
To improve initial load time and reduce JavaScript bundle size, the session recorder is dynamically imported only when it’s needed (e.g., when session recording is enabled by config and sampling).
# 2.2.0 (2025-03-18)
## 🚀 Features
- Improved Performance Observer compatibility.
# 2.1.0 (2025-02-18)
## 🚀 Features
- Improved initialization for SSR applications.
2.0.0 (2025-01-29)
## 🚀 Features
- ⚠️ optimize SDK with rollup bundling and support ES5.
## ⚠️ Breaking Changes
- Some imports from the library might be changed.
<br><br>
<b>For example:</b> <br>
<i>Before: </i> <br/>
`import { CoralogixLogSeverity } from '@coralogix/browser/src/types-external';` <br/> <br/>
<i> After: </i> <br/>
`import { CoralogixLogSeverity } from '@coralogix/browser';`
# 1.7.0 (2025-01-21)
## 🚀 Features
- Revert rollup bundling due to unexpected issues
# 1.6.0 (2025-01-19)
## 🚀 Features
- bundling project with rollup and support ES5.
# 1.5.0 (2025-01-09)
## 🚀 Features
- Create a changelog mechanism
# 1.4.19 (2025-01-09)
## 🚀 Features
- Custom spans
- add custom data and labels to capture error
# 1.4.12 (2024-12-18)
## 🩹 Fixes
- fix worker missing pako
# 1.4.11 (2024-12-17)
## 🩹 Fixes
- hotfix for tti import
# 1.4.9 (2024-12-17)
## 🚀 Features
- Support mfe (micro frontend)
# 1.4.4 (2024-12-9)
## 🚀 Features
- Remove fetch resources
- Implement allowHeaders functionality for FetchInstrumentation
- Add more info for LT log
- Screenshots
- Start end time measurements
# 1.2.40 (2024-11-12)
## 🩹 Fixes
- Ensure proxyUrl is added to ignoreUrls.
# 1.2.39 (2024-11-10)
## 🩹 Fixes
- Allow traceparent header to be sent when sample rate is 0
# 1.2.36 (2024-11-4)
## 🩹 Fixes
- Otel labels
# 1.2.35 (2024-10-31)
## 🚀 Features
- TTI metric report
## 🩹 Fixes
- SDK mask bug
# 1.2.31 (2024-10-29)
## 🚀 Features
- Use self-hosted worker for session recording
# 1.2.29 (2024-10-20)
## 🚀 Features
- Memory usage
# 1.2.28 (2024-10-14)
## 🚀 Features
- Masking only clickable elements
# 1.2.25 (2024-10-10)
## 🚀 Features
- remove lazy loading propagators
- advanced sampling
# 1.2.23 (2024-10-9)
## 🚀 Features
- add timing
- custom measurement
- Allowed tracing urls
# 1.2.19 (2024-9-26)
## 🚀 Features
- TBT refactor
# 1.2.17 (2024-9-18)
## 🚀 Features
- captureError - report on handled errors
# 1.2.16 (2024-9-18)
## 🚀 Features
- page referer
- add soft navigation
# 1.2.14 (2024-9-11)
## 🚀 Features
- support multi pages application
# 1.2.10 (2024-8-19)
## 🩹 Fixes
- fix page fragment that has anchor # in the url
# 1.1.17 (2024-6-20)
## 🚀 Features
- Snapshot context