@coralogix/browser 3.23.5 → 3.24.0

package/CHANGELOG.md

@@ -1,3 +1,42 @@
+## 3.24.0 (2026-09-23)
+
+### 🚀 Features
+
+- Take an extra screenshot for Coralogix Product Analytics when a user action leads to a meaningful application state — a dialog, drawer or menu opening, a view being replaced — on top of the screenshots already taken on the first click and one random later click of each view. On by default whenever session recording is running; set `sessionRecordingConfig.captureScreenshotOnDomChange: false` to turn it off. Expect a small rise in upload volume: one to four extra screenshots per page view, measured on real applications
+- List the actions available on the captured view in each Product Analytics screenshot event (`screenshot_context.actions`, up to 100 names): the page's `data-cx-action-name` values first, then the same names a click on the page's controls would report as `resolved_name`
+
+### 🩹 Fixes
+
+- In `onlyWithErrorConfig` mode, hold automatic Product Analytics screenshots until the session has an error. Previously the screenshot payload was uploaded straight away while the event describing it was withheld, so sessions that never errored paid for screenshots that could not be queried
+
+## 3.23.8 (2026-09-17)
+
+### 🩹 Fixes
+
+- Report a clicked button's own text as its interaction name (`resolved_name`) when the button sits inside a container that has an `aria-label`, such as a `role="dialog"` panel. The container's label was reported instead
+- Name a click on an SVG chart shape by the shape's own `<text>` label instead of by the text of the whole page section around the chart
+- Stop naming an icon-only control after the labels of the other buttons in its toolbar; such controls now take their `title` or `alt` attribute, and report no name when they have neither
+- Name a `<select>` by its first option instead of by all its options joined together, and name `<input type="submit">`, `"button"` and `"reset"` by their `value`
+- Exclude text under a masked element (`maskClass`) from `resolved_name` instead of leaking it when the clicked control contains masked content
+- Cap `resolved_name` and `element_inner_text` at 100 characters, ending with ` [...]` when cut, so a container's content can no longer produce a very long interaction name
+- Run only the first SDK copy loaded on a page: a second copy (another bundle importing the SDK, or a CDN script next to an npm install) no longer replaces `window.CoralogixRum`, and its `init` is ignored with a debug message
+
+## 3.23.7 (2026-09-14)
+
+### 🩹 Fixes
+
+- Mask a page URL segment as `{id}` only when the whole segment is digits, so route names such as `/apm-v2` and `/oauth2` keep their real value
+- Run your own `pageUrlBlueprinters` after the built-in ID masking, so the SDK defaults no longer overwrite them
+- Keep the fragment when masking a numeric segment: `/user/123#details` now reports as `/user/{id}#details`
+
+## 3.23.6 (2026-09-09)
+
+### 🩹 Fixes
+
+- Prevent the browser tab from freezing on Safari and on every browser on iOS/iPadOS when an error is reported while the page is navigating away — a redirect on first visit, a link, or a form submit. The tab could hang at 100% CPU and grow in memory until the browser killed it, and the page being navigated to never loaded. Applications that load zone.js, such as Angular, were affected
+- Prevent a `pageUrlBlueprinters` callback that throws from freezing the tab in any browser. Such a callback is now contained and reported once instead of looping; it still surfaces to your own error handling as before
+- Stop the SDK's own error reporting from surfacing in your application as unhandled promise rejections
+
 ## 3.23.5 (2026-09-02)
 
 ### 🩹 Fixes

package/README.md

@@ -352,6 +352,18 @@ CoralogixRum.init({
     recordConsoleEvents: true, // Will record all console events from dev tools. Levels: log, debug, warn, error, info, table etc..
     sessionRecordingSampleRate: 100, // Percentage of overall sessions recording being tracked, defaults to 100% and applied after the overall sessionSampleRate.
     immediateFlush: false, // Flush recording events immediately on start to capture short-duration sessions (<10s). Defaults to false.
+    /**
+     * Take an extra screenshot when the page changes in a way that looks like a meaningful
+     * application state, such as a dialog opening or a view being replaced. These are in addition
+     * to the screenshots taken on the first click and one random later click of each view.
+     *
+     * On by default whenever session recording is running. Detection reads the session recorder's
+     * event stream, so with autoStartSessionRecording: false it stays dormant until you call
+     * CoralogixRum.startSessionRecording(). Set it to false to turn it off.
+     *
+     * Available from version 3.24.0.
+     **/
+    captureScreenshotOnDomChange: true, // Defaults to true.
   },
 });
 ```
@@ -702,6 +714,13 @@ CoralogixRum.init({
 });
 ```
 
+The SDK applies its own built-in blueprinting first, then your functions, in the order you list
+them, so your blueprinter has the final word on the URL it returns.
+
+The built-in page blueprinting replaces UUIDs and all-digit path segments with `{id}`, so
+`/orders/1234` becomes `/orders/{id}`. A segment that only happens to contain a digit keeps its
+real value, which leaves route names such as `/apm-v2`, `/oauth2` and `/v1` untouched.
+
 ### Traces
 
 Add trace context propagation in headers across service boundaries
@@ -960,7 +979,7 @@ CoralogixRum.init({
 > The `priority` hint only works in Chromium browsers (Chrome/Edge 101+) and is a no-op elsewhere. We type this option with our own `SdkFetchPriority` alias instead of the DOM `RequestPriority` type, so it still compiles on older TypeScript versions (the SDK supports `>= 4.4.2`).
 
 <!-- /split -->
-<!-- split title="Custom instrumentation" path="features/custom-instrumentation.md" -->
+<!-- split title="Timing and measurements" path="features/timing-and-measurements.md" -->
 ### Custom Measurement
 
 Custom measurement allows you to send numeric data to Coralogix for precise monitoring and analysis.
@@ -1017,6 +1036,8 @@ A few behaviours worth knowing:
 - Ending a measurement releases its key, so the same key can be measured again afterwards.
 - Open measurements are dropped the next time you start or end one while the session is idle. The check runs on those calls rather than on a timer, and activity clears the idle flag, so a measurement spanning a short idle gap may still report.
 
+<!-- /split -->
+<!-- split title="Microfrontend support" path="configuration/microfrontend.md" -->
 ### Microfrontend support
 
 This feature allows you to track multiple applications on the same page.<br>
@@ -1035,6 +1056,8 @@ CoralogixRum.init({
 });
 ```
 
+<!-- /split -->
+<!-- split title="Custom spans" path="features/custom-spans.md" -->
 ### Custom Spans
 
 Create your own custom spans to track specific operations in your application.<br>
@@ -1095,6 +1118,8 @@ A few more things worth knowing:
 - Open global spans are ended for you when the session resets, which happens after an
   hour of session time or 15 minutes of inactivity.
 
+<!-- /split -->
+<!-- split title="Traces exporter" path="configuration/traces-exporter.md" -->
 ### Traces Exporter
 
 The `tracesExporter` callback gives you full control over how collected trace events are handled.  
@@ -1135,6 +1160,8 @@ CoralogixRum.init({
 });
 ```
 
+<!-- /split -->
+<!-- split title="OpenTelemetry batching" path="configuration/opentelemetry-batching.md" -->
 ### OpenTelemetry Batch Configuration
 
 The SDK batches logs and traces through an OpenTelemetry `BatchSpanProcessor` before sending them to Coralogix. Use `otelConfig` to tune that batching — for example, to flush less frequently and reduce the number of network requests your app makes.
@@ -1152,6 +1179,8 @@ CoralogixRum.init({
 });
 ```
 
+<!-- /split -->
+<!-- split title="Soft navigations" path="configuration/soft-navigations.md" -->
 ### Soft Navigations — Experimental
 
 Soft navigations are navigations that do not trigger a full page reload, such as SPA navigations. Defaults to false.
@@ -1169,6 +1198,8 @@ CoralogixRum.init({
 });
 ```
 
+<!-- /split -->
+<!-- split title="Memory usage" path="features/memory-usage.md" -->
 ### Memory Usage - Experimental
 
 Memory usage is a feature that allows you to track the memory usage of your application. It uses the [measureUserAgentSpecificMemory](https://developer.mozilla.org/en-US/docs/Web/API/Performance/measureUserAgentSpecificMemory) API.<br>

package/index.esm.js

@@ -1,4 +1,4 @@
-export { s as CoralogixEventType, q as CoralogixLogSeverity, p as CoralogixRum, O as OtelNetworkAttrs, P as PerformanceTypes, r as SessionRecordingEventType, U as UrlBasedLabelProvider, t as UrlType } from './index.esm2.js';
+export { x as CoralogixEventType, v as CoralogixLogSeverity, u as CoralogixRum, O as OtelNetworkAttrs, y as PerformanceTypes, w as SessionRecordingEventType, U as UrlBasedLabelProvider, z as UrlType } from './index.esm2.js';
 import 'tslib';
 import '@opentelemetry/sdk-trace-base';
 import '@opentelemetry/sdk-trace-web';