@dynatrace/rum-javascript-sdk 1.329.6 → 1.331.7

package/dist/types/rum-events/shared-namespaces-and-fields/request-fields.js

@@ -1,10 +1,3 @@
 // https://dt-rnd.atlassian.net/wiki/spaces/DEX/pages/165349687/Request+fields+URL+and+network+namespace
-/**
- * @category Shared Namespaces & Fields
- */
-export var RequestFieldsKeys;
-(function (RequestFieldsKeys) {
-    RequestFieldsKeys["NETWORK$PROTOCOL$NAME"] = "network.protocol.name";
-    RequestFieldsKeys["URL$FULL"] = "url.full";
-})(RequestFieldsKeys || (RequestFieldsKeys = {}));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVxdWVzdC1maWVsZHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zb3VyY2UvdHlwZXMvcnVtLWV2ZW50cy9zaGFyZWQtbmFtZXNwYWNlcy1hbmQtZmllbGRzL3JlcXVlc3QtZmllbGRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHdHQUF3RztBQUV4Rzs7R0FFRztBQUNILE1BQU0sQ0FBTixJQUFrQixpQkFHakI7QUFIRCxXQUFrQixpQkFBaUI7SUFDL0Isb0VBQStDLENBQUE7SUFDL0MsMENBQXFCLENBQUE7QUFDekIsQ0FBQyxFQUhpQixpQkFBaUIsS0FBakIsaUJBQWlCLFFBR2xDIiwic291cmNlc0NvbnRlbnQiOlsiLy8gaHR0cHM6Ly9kdC1ybmQuYXRsYXNzaWFuLm5ldC93aWtpL3NwYWNlcy9ERVgvcGFnZXMvMTY1MzQ5Njg3L1JlcXVlc3QrZmllbGRzK1VSTCthbmQrbmV0d29yaytuYW1lc3BhY2VcblxuLyoqXG4gKiBAY2F0ZWdvcnkgU2hhcmVkIE5hbWVzcGFjZXMgJiBGaWVsZHNcbiAqL1xuZXhwb3J0IGNvbnN0IGVudW0gUmVxdWVzdEZpZWxkc0tleXMge1xuICAgIE5FVFdPUkskUFJPVE9DT0wkTkFNRSA9IFwibmV0d29yay5wcm90b2NvbC5uYW1lXCIsXG4gICAgVVJMJEZVTEwgPSBcInVybC5mdWxsXCJcbn1cblxuLyoqXG4gKiBAY2F0ZWdvcnkgUmVxdWVzdHNcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZXF1ZXN0RmllbGRzIHtcbiAgICBbUmVxdWVzdEZpZWxkc0tleXMuVVJMJEZVTExdOiBzdHJpbmc7XG4gICAgW1JlcXVlc3RGaWVsZHNLZXlzLk5FVFdPUkskUFJPVE9DT0wkTkFNRV06IHN0cmluZztcbn1cbiJdfQ==
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVxdWVzdC1maWVsZHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zb3VyY2UvdHlwZXMvcnVtLWV2ZW50cy9zaGFyZWQtbmFtZXNwYWNlcy1hbmQtZmllbGRzL3JlcXVlc3QtZmllbGRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHdHQUF3RyIsInNvdXJjZXNDb250ZW50IjpbIi8vIGh0dHBzOi8vZHQtcm5kLmF0bGFzc2lhbi5uZXQvd2lraS9zcGFjZXMvREVYL3BhZ2VzLzE2NTM0OTY4Ny9SZXF1ZXN0K2ZpZWxkcytVUkwrYW5kK25ldHdvcmsrbmFtZXNwYWNlXG5cbmltcG9ydCB0eXBlIHsgUnVtRXZlbnRLZXlzIH0gZnJvbSBcIi4uL3J1bS1ldmVudC1rZXlzLmpzXCI7XG5cbi8qKlxuICogUmVxdWVzdCBVUkwgYW5kIG5ldHdvcmsgcHJvdG9jb2wgZmllbGRzLlxuICpcbiAqIEBpZ25vcmVcbiAqL1xuZXhwb3J0IHR5cGUgUmVxdWVzdEZpZWxkc0tleXMgPVxuICAgIHwgUnVtRXZlbnRLZXlzLk5FVFdPUkskUFJPVE9DT0wkTkFNRVxuICAgIHwgUnVtRXZlbnRLZXlzLlVSTCRGVUxMO1xuXG4vKipcbiAqIEBjYXRlZ29yeSBSZXF1ZXN0c1xuICovXG5leHBvcnQgaW50ZXJmYWNlIFJlcXVlc3RGaWVsZHMge1xuICAgIFtSdW1FdmVudEtleXMuVVJMJEZVTExdOiBzdHJpbmc7XG4gICAgW1J1bUV2ZW50S2V5cy5ORVRXT1JLJFBST1RPQ09MJE5BTUVdOiBzdHJpbmc7XG59XG4iXX0=

package/dist/types/rum-events/shared-namespaces-and-fields/view-source-fields.d.ts

@@ -1,14 +1,14 @@
+import type { RumEventKeys } from "../rum-event-keys.js";
 /**
- * @category Shared Namespaces & Fields
+ * View source fields.
+ *
+ * @ignore
  */
-export declare const enum ViewSourceFieldsKeys {
-    VIEW$SOURCE$DETECTED_NAME = "view.source.detected_name",
-    VIEW$SOURCE$URL$FULL = "view.source.url.full"
-}
+export type ViewSourceFieldsKeys = RumEventKeys.VIEW$SOURCE$DETECTED_NAME | RumEventKeys.VIEW$SOURCE$URL$FULL;
 /**
  * @category Lifecycle & Navigation
  */
 export interface ViewSourceFields {
-    [ViewSourceFieldsKeys.VIEW$SOURCE$URL$FULL]?: string;
-    [ViewSourceFieldsKeys.VIEW$SOURCE$DETECTED_NAME]?: string;
+    [RumEventKeys.VIEW$SOURCE$URL$FULL]?: string;
+    [RumEventKeys.VIEW$SOURCE$DETECTED_NAME]?: string;
 }

package/dist/types/rum-events/shared-namespaces-and-fields/view-source-fields.js

@@ -1,9 +1,2 @@
-/**
- * @category Shared Namespaces & Fields
- */
-export var ViewSourceFieldsKeys;
-(function (ViewSourceFieldsKeys) {
-    ViewSourceFieldsKeys["VIEW$SOURCE$DETECTED_NAME"] = "view.source.detected_name";
-    ViewSourceFieldsKeys["VIEW$SOURCE$URL$FULL"] = "view.source.url.full";
-})(ViewSourceFieldsKeys || (ViewSourceFieldsKeys = {}));
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmlldy1zb3VyY2UtZmllbGRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc291cmNlL3R5cGVzL3J1bS1ldmVudHMvc2hhcmVkLW5hbWVzcGFjZXMtYW5kLWZpZWxkcy92aWV3LXNvdXJjZS1maWVsZHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFDSCxNQUFNLENBQU4sSUFBa0Isb0JBR2pCO0FBSEQsV0FBa0Isb0JBQW9CO0lBQ2xDLCtFQUF1RCxDQUFBO0lBQ3ZELHFFQUE2QyxDQUFBO0FBQ2pELENBQUMsRUFIaUIsb0JBQW9CLEtBQXBCLG9CQUFvQixRQUdyQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGNhdGVnb3J5IFNoYXJlZCBOYW1lc3BhY2VzICYgRmllbGRzXG4gKi9cbmV4cG9ydCBjb25zdCBlbnVtIFZpZXdTb3VyY2VGaWVsZHNLZXlzIHtcbiAgICBWSUVXJFNPVVJDRSRERVRFQ1RFRF9OQU1FID0gXCJ2aWV3LnNvdXJjZS5kZXRlY3RlZF9uYW1lXCIsXG4gICAgVklFVyRTT1VSQ0UkVVJMJEZVTEwgPSBcInZpZXcuc291cmNlLnVybC5mdWxsXCJcbn1cblxuLyoqXG4gKiBAY2F0ZWdvcnkgTGlmZWN5Y2xlICYgTmF2aWdhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIFZpZXdTb3VyY2VGaWVsZHMge1xuICAgIFtWaWV3U291cmNlRmllbGRzS2V5cy5WSUVXJFNPVVJDRSRVUkwkRlVMTF0/OiBzdHJpbmc7XG4gICAgW1ZpZXdTb3VyY2VGaWVsZHNLZXlzLlZJRVckU09VUkNFJERFVEVDVEVEX05BTUVdPzogc3RyaW5nO1xufVxuIl19
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmlldy1zb3VyY2UtZmllbGRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc291cmNlL3R5cGVzL3J1bS1ldmVudHMvc2hhcmVkLW5hbWVzcGFjZXMtYW5kLWZpZWxkcy92aWV3LXNvdXJjZS1maWVsZHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgUnVtRXZlbnRLZXlzIH0gZnJvbSBcIi4uL3J1bS1ldmVudC1rZXlzLmpzXCI7XG5cbi8qKlxuICogVmlldyBzb3VyY2UgZmllbGRzLlxuICpcbiAqIEBpZ25vcmVcbiAqL1xuZXhwb3J0IHR5cGUgVmlld1NvdXJjZUZpZWxkc0tleXMgPVxuICAgIHwgUnVtRXZlbnRLZXlzLlZJRVckU09VUkNFJERFVEVDVEVEX05BTUVcbiAgICB8IFJ1bUV2ZW50S2V5cy5WSUVXJFNPVVJDRSRVUkwkRlVMTDtcblxuLyoqXG4gKiBAY2F0ZWdvcnkgTGlmZWN5Y2xlICYgTmF2aWdhdGlvblxuICovXG5leHBvcnQgaW50ZXJmYWNlIFZpZXdTb3VyY2VGaWVsZHMge1xuICAgIFtSdW1FdmVudEtleXMuVklFVyRTT1VSQ0UkVVJMJEZVTExdPzogc3RyaW5nO1xuICAgIFtSdW1FdmVudEtleXMuVklFVyRTT1VSQ0UkREVURUNURURfTkFNRV0/OiBzdHJpbmc7XG59XG4iXX0=

package/dist/types/user-actions/user-action-end-event.d.ts

@@ -1,11 +1,11 @@
 import type { BaseRUMUserActionEvent } from "../rum-events/rum-user-action-event.js";
-import type { GeneralRumEventFieldsKeys } from "../rum-events/shared-namespaces-and-fields/general-rum-event-fields.js";
+import type { RumEventKeys } from "../rum-events/rum-event-keys.js";
 /**
  * @category User Actions
  * @inline
  * @experimental
  */
-export type UserActionTrackerMetadata = Omit<BaseRUMUserActionEvent, GeneralRumEventFieldsKeys.DURATION | GeneralRumEventFieldsKeys.START_TIME>;
+export type UserActionTrackerMetadata = Omit<BaseRUMUserActionEvent, RumEventKeys.DURATION | RumEventKeys.START_TIME>;
 /**
  * Data provided to the callback of [dynatrace.userActions.subscribe]{@link UserActions.subscribe}.
  *

package/dist/types/user-actions/user-action-end-event.js

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlci1hY3Rpb24tZW5kLWV2ZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc291cmNlL3R5cGVzL3VzZXItYWN0aW9ucy91c2VyLWFjdGlvbi1lbmQtZXZlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgQmFzZVJVTVVzZXJBY3Rpb25FdmVudCB9IGZyb20gXCIuLi9ydW0tZXZlbnRzL3J1bS11c2VyLWFjdGlvbi1ldmVudC5qc1wiO1xuaW1wb3J0IHR5cGUgeyBHZW5lcmFsUnVtRXZlbnRGaWVsZHNLZXlzIH0gZnJvbSBcIi4uL3J1bS1ldmVudHMvc2hhcmVkLW5hbWVzcGFjZXMtYW5kLWZpZWxkcy9nZW5lcmFsLXJ1bS1ldmVudC1maWVsZHMuanNcIjtcblxuLyoqXG4gKiBAY2F0ZWdvcnkgVXNlciBBY3Rpb25zXG4gKiBAaW5saW5lXG4gKiBAZXhwZXJpbWVudGFsXG4gKi9cbmV4cG9ydCB0eXBlIFVzZXJBY3Rpb25UcmFja2VyTWV0YWRhdGEgPSBPbWl0PEJhc2VSVU1Vc2VyQWN0aW9uRXZlbnQsIEdlbmVyYWxSdW1FdmVudEZpZWxkc0tleXMuRFVSQVRJT04gfCBHZW5lcmFsUnVtRXZlbnRGaWVsZHNLZXlzLlNUQVJUX1RJTUU+O1xuXG4vKipcbiAqIERhdGEgcHJvdmlkZWQgdG8gdGhlIGNhbGxiYWNrIG9mIFtkeW5hdHJhY2UudXNlckFjdGlvbnMuc3Vic2NyaWJlXXtAbGluayBVc2VyQWN0aW9ucy5zdWJzY3JpYmV9LlxuICpcbiAqIEBjYXRlZ29yeSBVc2VyIEFjdGlvbnNcbiAqIEBleHBlcmltZW50YWxcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBVc2VyQWN0aW9uRW5kRXZlbnQge1xuICAgIC8qKlxuICAgICAqIElmIGFuIGFjdGl2aXR5IHdhcyByZWNvcmRlZCBgdHJ1ZWAsIG90aGVyd2lzZSBgZmFsc2VgLlxuICAgICAqL1xuICAgIGhhZEFjdGl2aXR5OiBib29sZWFuO1xuICAgIC8qKlxuICAgICAqIFRoZSB0aW1lIHRoZSB1c2VyIGFjdGlvbiBlbmRlZC5cbiAgICAgKi9cbiAgICBlbmQ6IG51bWJlciB8IHVuZGVmaW5lZDtcbiAgICAvKipcbiAgICAgKiBNZXRhZGF0YSBhYm91dCB0aGUgdXNlciBhY3Rpb24uXG4gICAgICovXG4gICAgbWV0YWRhdGE6IFVzZXJBY3Rpb25UcmFja2VyTWV0YWRhdGE7XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlci1hY3Rpb24tZW5kLWV2ZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc291cmNlL3R5cGVzL3VzZXItYWN0aW9ucy91c2VyLWFjdGlvbi1lbmQtZXZlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgQmFzZVJVTVVzZXJBY3Rpb25FdmVudCB9IGZyb20gXCIuLi9ydW0tZXZlbnRzL3J1bS11c2VyLWFjdGlvbi1ldmVudC5qc1wiO1xuaW1wb3J0IHR5cGUgeyBSdW1FdmVudEtleXMgfSBmcm9tIFwiLi4vcnVtLWV2ZW50cy9ydW0tZXZlbnQta2V5cy5qc1wiO1xuXG4vKipcbiAqIEBjYXRlZ29yeSBVc2VyIEFjdGlvbnNcbiAqIEBpbmxpbmVcbiAqIEBleHBlcmltZW50YWxcbiAqL1xuZXhwb3J0IHR5cGUgVXNlckFjdGlvblRyYWNrZXJNZXRhZGF0YSA9IE9taXQ8QmFzZVJVTVVzZXJBY3Rpb25FdmVudCwgUnVtRXZlbnRLZXlzLkRVUkFUSU9OIHwgUnVtRXZlbnRLZXlzLlNUQVJUX1RJTUU+O1xuXG4vKipcbiAqIERhdGEgcHJvdmlkZWQgdG8gdGhlIGNhbGxiYWNrIG9mIFtkeW5hdHJhY2UudXNlckFjdGlvbnMuc3Vic2NyaWJlXXtAbGluayBVc2VyQWN0aW9ucy5zdWJzY3JpYmV9LlxuICpcbiAqIEBjYXRlZ29yeSBVc2VyIEFjdGlvbnNcbiAqIEBleHBlcmltZW50YWxcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBVc2VyQWN0aW9uRW5kRXZlbnQge1xuICAgIC8qKlxuICAgICAqIElmIGFuIGFjdGl2aXR5IHdhcyByZWNvcmRlZCBgdHJ1ZWAsIG90aGVyd2lzZSBgZmFsc2VgLlxuICAgICAqL1xuICAgIGhhZEFjdGl2aXR5OiBib29sZWFuO1xuICAgIC8qKlxuICAgICAqIFRoZSB0aW1lIHRoZSB1c2VyIGFjdGlvbiBlbmRlZC5cbiAgICAgKi9cbiAgICBlbmQ6IG51bWJlciB8IHVuZGVmaW5lZDtcbiAgICAvKipcbiAgICAgKiBNZXRhZGF0YSBhYm91dCB0aGUgdXNlciBhY3Rpb24uXG4gICAgICovXG4gICAgbWV0YWRhdGE6IFVzZXJBY3Rpb25UcmFja2VyTWV0YWRhdGE7XG59XG4iXX0=

package/docs/testing.md

@@ -52,12 +52,104 @@ test("expect specific event", async ({ page, dynatraceTesting }) => {
 });
 ```
 
+## Important: Fixture Destructuring Order
+
+⚠️ **The order of fixture destructuring matters!**
+
+The `dynatraceTesting` fixture must be destructured **before** any custom fixtures that navigate the page. This ensures the RUM JavaScript is injected before navigation occurs.
+
+### ✅ Correct Order
+```typescript
+test("my test", async ({ dynatraceTesting, myCustomFixture, page }) => {
+    // dynatraceTesting is initialized first
+    // RUM script is injected via page.addInitScript
+    // Then myCustomFixture can safely navigate
+    await page.goto("https://example.com");
+});
+```
+
+### ❌ Incorrect Order
+```typescript
+test("my test", async ({ myCustomFixture, dynatraceTesting, page }) => {
+    // If myCustomFixture navigates the page, it happens BEFORE
+    // dynatraceTesting is initialized, so RUM script is not injected
+    // This will cause the test to fail with "no events received"
+});
+```
+
+### Why This Happens
+
+Playwright initializes fixtures in the order they appear in the destructuring pattern. The `dynatraceTesting` fixture uses `page.addInitScript()` to inject the RUM JavaScript, which only affects subsequent page navigations.
+
+### Custom Fixtures That Navigate
+
+If you have custom fixtures that call `page.goto()`, always destructure `dynatraceTesting` first:
+
+```typescript
+// Define custom fixture
+const test = base.extend<{ myApp: MyApp }>({
+    myApp: async ({ page }, use) => {
+        await page.goto("https://myapp.com");  // Navigation happens here
+        await use(new MyApp(page));
+    }
+});
+
+// Use fixtures in correct order
+test("test", async ({ dynatraceTesting, myApp }) => {
+    // ✅ Correct: dynatraceTesting initialized before myApp
+});
+```
+
 ## Troubleshooting
 
 The test fixture works by intercepting network requests to the RUM ingestion endpoint and capturing
 the events sent by the RUM JavaScript. 
 Note that this has an impact on your capturing environment, since these beacons report real data.
 
+### Missing Configuration Error
+
+If you see an error like:
+```
+[Dynatrace Testing] Missing required configuration fields: endpointUrl, appId, token
+```
+
+This means the required configuration was not provided. Make sure to configure the fixture using `test.use()`:
+
+```typescript
+test.use({
+    dynatraceConfig: {
+        endpointUrl: process.env.DT_ENDPOINT_URL!,
+        appId: process.env.DT_APP_ID!,
+        token: process.env.DT_TOKEN!
+    }
+});
+```
+
+### No Events Received
+
+If your tests fail with "Dynatrace didn't send any events":
+
+1. **Check fixture ordering** - Ensure `dynatraceTesting` is destructured before any fixtures that navigate the page
+2. **Check the page URL** - If you see a warning about the page already being navigated, fix the fixture order
+
+### Event Dumping
+
+When `dumpEventsOnFail` is enabled, the framework will output detailed information about received events when assertions fail:
+
+```
+[Dynatrace Testing] Event Dump (expectToHaveSentEvent - no match)
+Total events received: 3
+Total beacons received: 2
+
+Received events:
+
+Event 1: { "event_properties.custom_val": "load", ... }
+Event 2: { "event_properties.custom_val": "user-action", ... }
+Event 3: { "event_properties.custom_val": "custom", ... }
+```
+
+This helps identify why expected events weren't matched.
+
 ## Testing API
 The `DynatraceTesting` interface provides utility methods for validating observability-related events and beacon
 requests during tests.

package/docs/types.md

@@ -41,4 +41,4 @@ if (window.dynatrace) {
 }
 ```
 
-Refer to the [user actions documentation](USERACTIONS.md) for details about `dynatrace.userActions`.
+Refer to the [user actions documentation](./USERACTIONS.md) for details about `dynatrace.userActions`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynatrace/rum-javascript-sdk",
-  "version": "1.329.6",
+  "version": "1.331.7",
   "description": "JavaScript API for Real User Monitoring (RUM)",
   "sideEffects": false,
   "type": "module",
@@ -12,8 +12,8 @@
     "dist/types/**/*.d.ts",
     "dist/testing/**/*.js",
     "dist/testing/**/*.d.ts",
-    "README.md",
-    "docs/*.md"
+    "docs/*.md",
+    "README.md"
   ],
   "exports": {
     "./api": {
@@ -93,7 +93,7 @@
   "author": "Dynatrace",
   "license": "ISC",
   "devDependencies": {
-    "@types/node": "22.10.1",
+    "@types/node": "25.0.3",
     "@vitest/coverage-v8": "3.2.3",
     "@vitest/ui": "3.2.3",
     "eslint": "9.38.0",