@datadog/mobile-react-navigation 1.6.0 → 1.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -33,7 +33,7 @@ class DdRumReactNavigationTracking {
33
33
  } else if (DdRumReactNavigationTracking.registeredContainer == null) {
34
34
  DdRumReactNavigationTracking.viewNamePredicate = viewNamePredicate;
35
35
  const listener = DdRumReactNavigationTracking.resolveNavigationStateChangeListener();
36
- DdRumReactNavigationTracking.handleRouteNavigation(navigationRef.getCurrentRoute());
36
+ DdRumReactNavigationTracking.handleRouteNavigation(navigationRef.getCurrentRoute(), _reactNative.AppState.currentState);
37
37
  navigationRef.addListener('state', listener);
38
38
  DdRumReactNavigationTracking.registeredContainer = navigationRef;
39
39
  DdRumReactNavigationTracking.backHandler = _reactNative.BackHandler.addEventListener('hardwareBackPress', DdRumReactNavigationTracking.onBackPress);
@@ -74,7 +74,7 @@ class DdRumReactNavigationTracking {
74
74
  }
75
75
  }
76
76
 
77
- static handleRouteNavigation(route, appStateStatus = undefined) {
77
+ static handleRouteNavigation(route, appStateStatus) {
78
78
  if (route === undefined || route === null) {
79
79
  _mobileReactNative.InternalLog.log(DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE, _mobileReactNative.SdkVerbosity.WARN); // RUMM-1400 in some cases the route seem to be undefined
80
80
 
@@ -83,13 +83,24 @@ class DdRumReactNavigationTracking {
83
83
  }
84
84
 
85
85
  const key = route.key;
86
- const predicate = DdRumReactNavigationTracking.viewNamePredicate;
87
- const screenName = predicate(route, route.name);
86
+ const screenName = DdRumReactNavigationTracking.viewNamePredicate(route, route.name);
87
+
88
+ if (key != null && screenName != null) {
89
+ // On iOS, the app can start in either "active", "background" or "unknown" state
90
+ if (appStateStatus !== 'background') {
91
+ _mobileReactNative.DdRum.startView(key, screenName);
92
+ }
93
+ }
94
+ }
95
+
96
+ static handleAppStateChanged(route, appStateStatus) {
97
+ const key = route.key;
98
+ const screenName = DdRumReactNavigationTracking.viewNamePredicate(route, route.name);
88
99
 
89
100
  if (key != null && screenName != null) {
90
101
  if (appStateStatus === 'background') {
91
102
  _mobileReactNative.DdRum.stopView(key);
92
- } else if (appStateStatus === 'active' || appStateStatus === undefined) {
103
+ } else if (appStateStatus === 'active') {
93
104
  // case when app goes into foreground,
94
105
  // in that case navigation listener won't be called
95
106
  _mobileReactNative.DdRum.startView(key, screenName);
@@ -110,7 +121,7 @@ class DdRumReactNavigationTracking {
110
121
  return;
111
122
  }
112
123
 
113
- DdRumReactNavigationTracking.handleRouteNavigation(route);
124
+ DdRumReactNavigationTracking.handleRouteNavigation(route, _reactNative.AppState.currentState);
114
125
  };
115
126
  }
116
127
 
@@ -170,6 +181,6 @@ _defineProperty(DdRumReactNavigationTracking, "appStateListener", appStateStatus
170
181
  return;
171
182
  }
172
183
 
173
- DdRumReactNavigationTracking.handleRouteNavigation(currentRoute, appStateStatus);
184
+ DdRumReactNavigationTracking.handleAppStateChanged(currentRoute, appStateStatus);
174
185
  });
175
186
  //# sourceMappingURL=DdRumReactNavigationTracking.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["DdRumReactNavigationTracking.tsx"],"names":["DdRumReactNavigationTracking","startTrackingViews","navigationRef","viewNamePredicate","_route","trackedName","InternalLog","log","NULL_NAVIGATION_REF_ERROR_MESSAGE","SdkVerbosity","ERROR","registeredContainer","NAVIGATION_REF_IN_USE_ERROR_MESSAGE","listener","resolveNavigationStateChangeListener","handleRouteNavigation","getCurrentRoute","addListener","backHandler","BackHandler","addEventListener","onBackPress","appStateSubscription","AppState","appStateListener","stopTrackingViews","removeListener","navigationStateChangeListener","remove","removeEventListener","route","appStateStatus","undefined","ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE","WARN","key","predicate","screenName","name","DdRum","stopView","startView","canGoBack","isAppExitingOnBackPress","currentRoute"],"mappings":"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","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\nimport { DdRum, SdkVerbosity, InternalLog } from '@datadog/mobile-react-native';\nimport type { AppStateStatus, NativeEventSubscription } from 'react-native';\nimport { AppState, BackHandler } from 'react-native';\n\nimport type {\n NavigationContainerRef,\n Route,\n NavigationListener\n} from './react-navigation';\n\n// AppStateStatus can have values:\n// 'active' - The app is running in the foreground\n// 'background' - The app is running in the background. The user is either in another app or on the home screen\n// 'inactive' [iOS] - This is a transition state that currently never happens for typical React Native apps.\n// 'unknown' [iOS] - Initial value until the current app state is determined\n// 'extension' [iOS] - The app is running as an app extension\ndeclare type AppStateListener = (appStateStatus: AppStateStatus) => void | null;\n\nexport type ViewNamePredicate = (\n route: Route<string, any | undefined>,\n trackedName: string\n) => string | null;\n\n/**\n * Provides RUM integration for the [ReactNavigation](https://reactnavigation.org/) API.\n */\nexport class DdRumReactNavigationTracking {\n private static registeredContainer: NavigationContainerRef | null;\n\n private static navigationStateChangeListener: NavigationListener;\n\n private static viewNamePredicate: ViewNamePredicate;\n\n private static backHandler: NativeEventSubscription | null;\n\n private static appStateSubscription?: NativeEventSubscription;\n\n static ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE =\n 'A navigation change was detected but the RUM ViewEvent was dropped as the route was undefined.';\n static NULL_NAVIGATION_REF_ERROR_MESSAGE =\n 'Cannot track views with a null navigationRef.';\n static NAVIGATION_REF_IN_USE_ERROR_MESSAGE =\n 'Cannot track new navigation container while another one is still tracked. Please call `DdRumReactNavigationTracking.stopTrackingViews` on the previous container reference.';\n\n static isAppExitingOnBackPress = (): boolean => {\n if (DdRumReactNavigationTracking.registeredContainer === null) {\n return false;\n }\n if (DdRumReactNavigationTracking.registeredContainer.canGoBack()) {\n return false;\n }\n return true;\n };\n\n static onBackPress = () => {\n if (DdRumReactNavigationTracking.isAppExitingOnBackPress()) {\n DdRumReactNavigationTracking.stopTrackingViews(\n DdRumReactNavigationTracking.registeredContainer\n );\n }\n // We always return false so we make sure the react-navigation callback is called.\n // See https://reactnative.dev/docs/backhandler\n return false;\n };\n\n /**\n * Starts tracking the NavigationContainer and sends a RUM View event every time the navigation route changed.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static startTrackingViews(\n navigationRef: NavigationContainerRef | null,\n viewNamePredicate: ViewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n }\n ): void {\n if (navigationRef == null) {\n InternalLog.log(\n DdRumReactNavigationTracking.NULL_NAVIGATION_REF_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n if (\n DdRumReactNavigationTracking.registeredContainer != null &&\n this.registeredContainer !== navigationRef\n ) {\n InternalLog.log(\n DdRumReactNavigationTracking.NAVIGATION_REF_IN_USE_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n } else if (DdRumReactNavigationTracking.registeredContainer == null) {\n DdRumReactNavigationTracking.viewNamePredicate = viewNamePredicate;\n const listener = DdRumReactNavigationTracking.resolveNavigationStateChangeListener();\n DdRumReactNavigationTracking.handleRouteNavigation(\n navigationRef.getCurrentRoute()\n );\n navigationRef.addListener('state', listener);\n DdRumReactNavigationTracking.registeredContainer = navigationRef;\n DdRumReactNavigationTracking.backHandler = BackHandler.addEventListener(\n 'hardwareBackPress',\n DdRumReactNavigationTracking.onBackPress\n );\n this.appStateSubscription = AppState.addEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n /**\n * Stops tracking the NavigationContainer.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static stopTrackingViews(\n navigationRef: NavigationContainerRef | null\n ): void {\n if (navigationRef != null) {\n navigationRef.removeListener(\n 'state',\n DdRumReactNavigationTracking.navigationStateChangeListener\n );\n DdRumReactNavigationTracking.backHandler?.remove();\n DdRumReactNavigationTracking.backHandler = null;\n DdRumReactNavigationTracking.registeredContainer = null;\n DdRumReactNavigationTracking.viewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n };\n }\n\n // For versions of React Native below 0.65, addEventListener does not return a subscription.\n // We have to call AppState.removeEventListener instead.\n if (this.appStateSubscription) {\n this.appStateSubscription.remove();\n\n // The next if check is important as users can call `stopTrackingViews` before `startTrackingViews`\n // see https://github.com/DataDog/dd-sdk-reactnative/issues/422\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n } else if (AppState.removeEventListener) {\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n AppState.removeEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n private static handleRouteNavigation(\n route: Route<string, any | undefined> | undefined,\n appStateStatus: AppStateStatus | undefined = undefined\n ) {\n if (route === undefined || route === null) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n // RUMM-1400 in some cases the route seem to be undefined\n return;\n }\n const key = route.key;\n\n const predicate = DdRumReactNavigationTracking.viewNamePredicate;\n const screenName = predicate(route, route.name);\n\n if (key != null && screenName != null) {\n if (appStateStatus === 'background') {\n DdRum.stopView(key);\n } else if (\n appStateStatus === 'active' ||\n appStateStatus === undefined\n ) {\n // case when app goes into foreground,\n // in that case navigation listener won't be called\n DdRum.startView(key, screenName);\n }\n }\n }\n\n private static resolveNavigationStateChangeListener(): NavigationListener {\n if (\n DdRumReactNavigationTracking.navigationStateChangeListener == null\n ) {\n DdRumReactNavigationTracking.navigationStateChangeListener = () => {\n const route = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n\n if (route === undefined) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleRouteNavigation(route);\n };\n }\n return DdRumReactNavigationTracking.navigationStateChangeListener;\n }\n\n private static appStateListener: AppStateListener = (\n appStateStatus: AppStateStatus\n ) => {\n const currentRoute = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n if (currentRoute === undefined || currentRoute === null) {\n InternalLog.log(\n `We could not determine the route when changing the application state to: ${appStateStatus}. No RUM View event will be sent in this case.`,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleRouteNavigation(\n currentRoute,\n appStateStatus\n );\n };\n}\n"]}
1
+ {"version":3,"sources":["DdRumReactNavigationTracking.tsx"],"names":["DdRumReactNavigationTracking","startTrackingViews","navigationRef","viewNamePredicate","_route","trackedName","InternalLog","log","NULL_NAVIGATION_REF_ERROR_MESSAGE","SdkVerbosity","ERROR","registeredContainer","NAVIGATION_REF_IN_USE_ERROR_MESSAGE","listener","resolveNavigationStateChangeListener","handleRouteNavigation","getCurrentRoute","AppState","currentState","addListener","backHandler","BackHandler","addEventListener","onBackPress","appStateSubscription","appStateListener","stopTrackingViews","removeListener","navigationStateChangeListener","remove","removeEventListener","route","appStateStatus","undefined","ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE","WARN","key","screenName","name","DdRum","startView","handleAppStateChanged","stopView","canGoBack","isAppExitingOnBackPress","currentRoute"],"mappings":"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","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\nimport { DdRum, SdkVerbosity, InternalLog } from '@datadog/mobile-react-native';\nimport type { AppStateStatus, NativeEventSubscription } from 'react-native';\nimport { AppState, BackHandler } from 'react-native';\n\nimport type {\n NavigationContainerRef,\n Route,\n NavigationListener\n} from './react-navigation';\n\n// AppStateStatus can have values:\n// 'active' - The app is running in the foreground\n// 'background' - The app is running in the background. The user is either in another app or on the home screen\n// 'inactive' [iOS] - This is a transition state that currently never happens for typical React Native apps.\n// 'unknown' [iOS] - Initial value until the current app state is determined\n// 'extension' [iOS] - The app is running as an app extension\ndeclare type AppStateListener = (appStateStatus: AppStateStatus) => void | null;\n\nexport type ViewNamePredicate = (\n route: Route<string, any | undefined>,\n trackedName: string\n) => string | null;\n\n/**\n * Provides RUM integration for the [ReactNavigation](https://reactnavigation.org/) API.\n */\nexport class DdRumReactNavigationTracking {\n private static registeredContainer: NavigationContainerRef | null;\n\n private static navigationStateChangeListener: NavigationListener;\n\n private static viewNamePredicate: ViewNamePredicate;\n\n private static backHandler: NativeEventSubscription | null;\n\n private static appStateSubscription?: NativeEventSubscription;\n\n static ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE =\n 'A navigation change was detected but the RUM ViewEvent was dropped as the route was undefined.';\n static NULL_NAVIGATION_REF_ERROR_MESSAGE =\n 'Cannot track views with a null navigationRef.';\n static NAVIGATION_REF_IN_USE_ERROR_MESSAGE =\n 'Cannot track new navigation container while another one is still tracked. Please call `DdRumReactNavigationTracking.stopTrackingViews` on the previous container reference.';\n\n static isAppExitingOnBackPress = (): boolean => {\n if (DdRumReactNavigationTracking.registeredContainer === null) {\n return false;\n }\n if (DdRumReactNavigationTracking.registeredContainer.canGoBack()) {\n return false;\n }\n return true;\n };\n\n static onBackPress = () => {\n if (DdRumReactNavigationTracking.isAppExitingOnBackPress()) {\n DdRumReactNavigationTracking.stopTrackingViews(\n DdRumReactNavigationTracking.registeredContainer\n );\n }\n // We always return false so we make sure the react-navigation callback is called.\n // See https://reactnative.dev/docs/backhandler\n return false;\n };\n\n /**\n * Starts tracking the NavigationContainer and sends a RUM View event every time the navigation route changed.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static startTrackingViews(\n navigationRef: NavigationContainerRef | null,\n viewNamePredicate: ViewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n }\n ): void {\n if (navigationRef == null) {\n InternalLog.log(\n DdRumReactNavigationTracking.NULL_NAVIGATION_REF_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n if (\n DdRumReactNavigationTracking.registeredContainer != null &&\n this.registeredContainer !== navigationRef\n ) {\n InternalLog.log(\n DdRumReactNavigationTracking.NAVIGATION_REF_IN_USE_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n } else if (DdRumReactNavigationTracking.registeredContainer == null) {\n DdRumReactNavigationTracking.viewNamePredicate = viewNamePredicate;\n const listener = DdRumReactNavigationTracking.resolveNavigationStateChangeListener();\n DdRumReactNavigationTracking.handleRouteNavigation(\n navigationRef.getCurrentRoute(),\n AppState.currentState\n );\n navigationRef.addListener('state', listener);\n DdRumReactNavigationTracking.registeredContainer = navigationRef;\n DdRumReactNavigationTracking.backHandler = BackHandler.addEventListener(\n 'hardwareBackPress',\n DdRumReactNavigationTracking.onBackPress\n );\n this.appStateSubscription = AppState.addEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n /**\n * Stops tracking the NavigationContainer.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static stopTrackingViews(\n navigationRef: NavigationContainerRef | null\n ): void {\n if (navigationRef != null) {\n navigationRef.removeListener(\n 'state',\n DdRumReactNavigationTracking.navigationStateChangeListener\n );\n DdRumReactNavigationTracking.backHandler?.remove();\n DdRumReactNavigationTracking.backHandler = null;\n DdRumReactNavigationTracking.registeredContainer = null;\n DdRumReactNavigationTracking.viewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n };\n }\n\n // For versions of React Native below 0.65, addEventListener does not return a subscription.\n // We have to call AppState.removeEventListener instead.\n if (this.appStateSubscription) {\n this.appStateSubscription.remove();\n\n // The next if check is important as users can call `stopTrackingViews` before `startTrackingViews`\n // see https://github.com/DataDog/dd-sdk-reactnative/issues/422\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n } else if (AppState.removeEventListener) {\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n AppState.removeEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n private static handleRouteNavigation(\n route: Route<string, any | undefined> | undefined,\n appStateStatus: AppStateStatus\n ) {\n if (route === undefined || route === null) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n // RUMM-1400 in some cases the route seem to be undefined\n return;\n }\n const key = route.key;\n const screenName = DdRumReactNavigationTracking.viewNamePredicate(\n route,\n route.name\n );\n\n if (key != null && screenName != null) {\n // On iOS, the app can start in either \"active\", \"background\" or \"unknown\" state\n if (appStateStatus !== 'background') {\n DdRum.startView(key, screenName);\n }\n }\n }\n\n private static handleAppStateChanged(\n route: Route<string, any | undefined>,\n appStateStatus: AppStateStatus\n ) {\n const key = route.key;\n const screenName = DdRumReactNavigationTracking.viewNamePredicate(\n route,\n route.name\n );\n\n if (key != null && screenName != null) {\n if (appStateStatus === 'background') {\n DdRum.stopView(key);\n } else if (appStateStatus === 'active') {\n // case when app goes into foreground,\n // in that case navigation listener won't be called\n DdRum.startView(key, screenName);\n }\n }\n }\n\n private static resolveNavigationStateChangeListener(): NavigationListener {\n if (\n DdRumReactNavigationTracking.navigationStateChangeListener == null\n ) {\n DdRumReactNavigationTracking.navigationStateChangeListener = () => {\n const route = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n\n if (route === undefined) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleRouteNavigation(\n route,\n AppState.currentState\n );\n };\n }\n return DdRumReactNavigationTracking.navigationStateChangeListener;\n }\n\n private static appStateListener: AppStateListener = (\n appStateStatus: AppStateStatus\n ) => {\n const currentRoute = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n if (currentRoute === undefined || currentRoute === null) {\n InternalLog.log(\n `We could not determine the route when changing the application state to: ${appStateStatus}. No RUM View event will be sent in this case.`,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleAppStateChanged(\n currentRoute,\n appStateStatus\n );\n };\n}\n"]}
@@ -29,7 +29,7 @@ export class DdRumReactNavigationTracking {
29
29
  } else if (DdRumReactNavigationTracking.registeredContainer == null) {
30
30
  DdRumReactNavigationTracking.viewNamePredicate = viewNamePredicate;
31
31
  const listener = DdRumReactNavigationTracking.resolveNavigationStateChangeListener();
32
- DdRumReactNavigationTracking.handleRouteNavigation(navigationRef.getCurrentRoute());
32
+ DdRumReactNavigationTracking.handleRouteNavigation(navigationRef.getCurrentRoute(), AppState.currentState);
33
33
  navigationRef.addListener('state', listener);
34
34
  DdRumReactNavigationTracking.registeredContainer = navigationRef;
35
35
  DdRumReactNavigationTracking.backHandler = BackHandler.addEventListener('hardwareBackPress', DdRumReactNavigationTracking.onBackPress);
@@ -70,7 +70,7 @@ export class DdRumReactNavigationTracking {
70
70
  }
71
71
  }
72
72
 
73
- static handleRouteNavigation(route, appStateStatus = undefined) {
73
+ static handleRouteNavigation(route, appStateStatus) {
74
74
  if (route === undefined || route === null) {
75
75
  InternalLog.log(DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE, SdkVerbosity.WARN); // RUMM-1400 in some cases the route seem to be undefined
76
76
 
@@ -78,13 +78,24 @@ export class DdRumReactNavigationTracking {
78
78
  }
79
79
 
80
80
  const key = route.key;
81
- const predicate = DdRumReactNavigationTracking.viewNamePredicate;
82
- const screenName = predicate(route, route.name);
81
+ const screenName = DdRumReactNavigationTracking.viewNamePredicate(route, route.name);
82
+
83
+ if (key != null && screenName != null) {
84
+ // On iOS, the app can start in either "active", "background" or "unknown" state
85
+ if (appStateStatus !== 'background') {
86
+ DdRum.startView(key, screenName);
87
+ }
88
+ }
89
+ }
90
+
91
+ static handleAppStateChanged(route, appStateStatus) {
92
+ const key = route.key;
93
+ const screenName = DdRumReactNavigationTracking.viewNamePredicate(route, route.name);
83
94
 
84
95
  if (key != null && screenName != null) {
85
96
  if (appStateStatus === 'background') {
86
97
  DdRum.stopView(key);
87
- } else if (appStateStatus === 'active' || appStateStatus === undefined) {
98
+ } else if (appStateStatus === 'active') {
88
99
  // case when app goes into foreground,
89
100
  // in that case navigation listener won't be called
90
101
  DdRum.startView(key, screenName);
@@ -104,7 +115,7 @@ export class DdRumReactNavigationTracking {
104
115
  return;
105
116
  }
106
117
 
107
- DdRumReactNavigationTracking.handleRouteNavigation(route);
118
+ DdRumReactNavigationTracking.handleRouteNavigation(route, AppState.currentState);
108
119
  };
109
120
  }
110
121
 
@@ -161,6 +172,6 @@ _defineProperty(DdRumReactNavigationTracking, "appStateListener", appStateStatus
161
172
  return;
162
173
  }
163
174
 
164
- DdRumReactNavigationTracking.handleRouteNavigation(currentRoute, appStateStatus);
175
+ DdRumReactNavigationTracking.handleAppStateChanged(currentRoute, appStateStatus);
165
176
  });
166
177
  //# sourceMappingURL=DdRumReactNavigationTracking.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["DdRumReactNavigationTracking.tsx"],"names":["DdRum","SdkVerbosity","InternalLog","AppState","BackHandler","DdRumReactNavigationTracking","startTrackingViews","navigationRef","viewNamePredicate","_route","trackedName","log","NULL_NAVIGATION_REF_ERROR_MESSAGE","ERROR","registeredContainer","NAVIGATION_REF_IN_USE_ERROR_MESSAGE","listener","resolveNavigationStateChangeListener","handleRouteNavigation","getCurrentRoute","addListener","backHandler","addEventListener","onBackPress","appStateSubscription","appStateListener","stopTrackingViews","removeListener","navigationStateChangeListener","remove","removeEventListener","route","appStateStatus","undefined","ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE","WARN","key","predicate","screenName","name","stopView","startView","canGoBack","isAppExitingOnBackPress","currentRoute"],"mappings":"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","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\nimport { DdRum, SdkVerbosity, InternalLog } from '@datadog/mobile-react-native';\nimport type { AppStateStatus, NativeEventSubscription } from 'react-native';\nimport { AppState, BackHandler } from 'react-native';\n\nimport type {\n NavigationContainerRef,\n Route,\n NavigationListener\n} from './react-navigation';\n\n// AppStateStatus can have values:\n// 'active' - The app is running in the foreground\n// 'background' - The app is running in the background. The user is either in another app or on the home screen\n// 'inactive' [iOS] - This is a transition state that currently never happens for typical React Native apps.\n// 'unknown' [iOS] - Initial value until the current app state is determined\n// 'extension' [iOS] - The app is running as an app extension\ndeclare type AppStateListener = (appStateStatus: AppStateStatus) => void | null;\n\nexport type ViewNamePredicate = (\n route: Route<string, any | undefined>,\n trackedName: string\n) => string | null;\n\n/**\n * Provides RUM integration for the [ReactNavigation](https://reactnavigation.org/) API.\n */\nexport class DdRumReactNavigationTracking {\n private static registeredContainer: NavigationContainerRef | null;\n\n private static navigationStateChangeListener: NavigationListener;\n\n private static viewNamePredicate: ViewNamePredicate;\n\n private static backHandler: NativeEventSubscription | null;\n\n private static appStateSubscription?: NativeEventSubscription;\n\n static ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE =\n 'A navigation change was detected but the RUM ViewEvent was dropped as the route was undefined.';\n static NULL_NAVIGATION_REF_ERROR_MESSAGE =\n 'Cannot track views with a null navigationRef.';\n static NAVIGATION_REF_IN_USE_ERROR_MESSAGE =\n 'Cannot track new navigation container while another one is still tracked. Please call `DdRumReactNavigationTracking.stopTrackingViews` on the previous container reference.';\n\n static isAppExitingOnBackPress = (): boolean => {\n if (DdRumReactNavigationTracking.registeredContainer === null) {\n return false;\n }\n if (DdRumReactNavigationTracking.registeredContainer.canGoBack()) {\n return false;\n }\n return true;\n };\n\n static onBackPress = () => {\n if (DdRumReactNavigationTracking.isAppExitingOnBackPress()) {\n DdRumReactNavigationTracking.stopTrackingViews(\n DdRumReactNavigationTracking.registeredContainer\n );\n }\n // We always return false so we make sure the react-navigation callback is called.\n // See https://reactnative.dev/docs/backhandler\n return false;\n };\n\n /**\n * Starts tracking the NavigationContainer and sends a RUM View event every time the navigation route changed.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static startTrackingViews(\n navigationRef: NavigationContainerRef | null,\n viewNamePredicate: ViewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n }\n ): void {\n if (navigationRef == null) {\n InternalLog.log(\n DdRumReactNavigationTracking.NULL_NAVIGATION_REF_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n if (\n DdRumReactNavigationTracking.registeredContainer != null &&\n this.registeredContainer !== navigationRef\n ) {\n InternalLog.log(\n DdRumReactNavigationTracking.NAVIGATION_REF_IN_USE_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n } else if (DdRumReactNavigationTracking.registeredContainer == null) {\n DdRumReactNavigationTracking.viewNamePredicate = viewNamePredicate;\n const listener = DdRumReactNavigationTracking.resolveNavigationStateChangeListener();\n DdRumReactNavigationTracking.handleRouteNavigation(\n navigationRef.getCurrentRoute()\n );\n navigationRef.addListener('state', listener);\n DdRumReactNavigationTracking.registeredContainer = navigationRef;\n DdRumReactNavigationTracking.backHandler = BackHandler.addEventListener(\n 'hardwareBackPress',\n DdRumReactNavigationTracking.onBackPress\n );\n this.appStateSubscription = AppState.addEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n /**\n * Stops tracking the NavigationContainer.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static stopTrackingViews(\n navigationRef: NavigationContainerRef | null\n ): void {\n if (navigationRef != null) {\n navigationRef.removeListener(\n 'state',\n DdRumReactNavigationTracking.navigationStateChangeListener\n );\n DdRumReactNavigationTracking.backHandler?.remove();\n DdRumReactNavigationTracking.backHandler = null;\n DdRumReactNavigationTracking.registeredContainer = null;\n DdRumReactNavigationTracking.viewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n };\n }\n\n // For versions of React Native below 0.65, addEventListener does not return a subscription.\n // We have to call AppState.removeEventListener instead.\n if (this.appStateSubscription) {\n this.appStateSubscription.remove();\n\n // The next if check is important as users can call `stopTrackingViews` before `startTrackingViews`\n // see https://github.com/DataDog/dd-sdk-reactnative/issues/422\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n } else if (AppState.removeEventListener) {\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n AppState.removeEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n private static handleRouteNavigation(\n route: Route<string, any | undefined> | undefined,\n appStateStatus: AppStateStatus | undefined = undefined\n ) {\n if (route === undefined || route === null) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n // RUMM-1400 in some cases the route seem to be undefined\n return;\n }\n const key = route.key;\n\n const predicate = DdRumReactNavigationTracking.viewNamePredicate;\n const screenName = predicate(route, route.name);\n\n if (key != null && screenName != null) {\n if (appStateStatus === 'background') {\n DdRum.stopView(key);\n } else if (\n appStateStatus === 'active' ||\n appStateStatus === undefined\n ) {\n // case when app goes into foreground,\n // in that case navigation listener won't be called\n DdRum.startView(key, screenName);\n }\n }\n }\n\n private static resolveNavigationStateChangeListener(): NavigationListener {\n if (\n DdRumReactNavigationTracking.navigationStateChangeListener == null\n ) {\n DdRumReactNavigationTracking.navigationStateChangeListener = () => {\n const route = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n\n if (route === undefined) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleRouteNavigation(route);\n };\n }\n return DdRumReactNavigationTracking.navigationStateChangeListener;\n }\n\n private static appStateListener: AppStateListener = (\n appStateStatus: AppStateStatus\n ) => {\n const currentRoute = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n if (currentRoute === undefined || currentRoute === null) {\n InternalLog.log(\n `We could not determine the route when changing the application state to: ${appStateStatus}. No RUM View event will be sent in this case.`,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleRouteNavigation(\n currentRoute,\n appStateStatus\n );\n };\n}\n"]}
1
+ {"version":3,"sources":["DdRumReactNavigationTracking.tsx"],"names":["DdRum","SdkVerbosity","InternalLog","AppState","BackHandler","DdRumReactNavigationTracking","startTrackingViews","navigationRef","viewNamePredicate","_route","trackedName","log","NULL_NAVIGATION_REF_ERROR_MESSAGE","ERROR","registeredContainer","NAVIGATION_REF_IN_USE_ERROR_MESSAGE","listener","resolveNavigationStateChangeListener","handleRouteNavigation","getCurrentRoute","currentState","addListener","backHandler","addEventListener","onBackPress","appStateSubscription","appStateListener","stopTrackingViews","removeListener","navigationStateChangeListener","remove","removeEventListener","route","appStateStatus","undefined","ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE","WARN","key","screenName","name","startView","handleAppStateChanged","stopView","canGoBack","isAppExitingOnBackPress","currentRoute"],"mappings":"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","sourcesContent":["/*\n * Unless explicitly stated otherwise all files in this repository are licensed under the Apache License Version 2.0.\n * This product includes software developed at Datadog (https://www.datadoghq.com/).\n * Copyright 2016-Present Datadog, Inc.\n */\n\nimport { DdRum, SdkVerbosity, InternalLog } from '@datadog/mobile-react-native';\nimport type { AppStateStatus, NativeEventSubscription } from 'react-native';\nimport { AppState, BackHandler } from 'react-native';\n\nimport type {\n NavigationContainerRef,\n Route,\n NavigationListener\n} from './react-navigation';\n\n// AppStateStatus can have values:\n// 'active' - The app is running in the foreground\n// 'background' - The app is running in the background. The user is either in another app or on the home screen\n// 'inactive' [iOS] - This is a transition state that currently never happens for typical React Native apps.\n// 'unknown' [iOS] - Initial value until the current app state is determined\n// 'extension' [iOS] - The app is running as an app extension\ndeclare type AppStateListener = (appStateStatus: AppStateStatus) => void | null;\n\nexport type ViewNamePredicate = (\n route: Route<string, any | undefined>,\n trackedName: string\n) => string | null;\n\n/**\n * Provides RUM integration for the [ReactNavigation](https://reactnavigation.org/) API.\n */\nexport class DdRumReactNavigationTracking {\n private static registeredContainer: NavigationContainerRef | null;\n\n private static navigationStateChangeListener: NavigationListener;\n\n private static viewNamePredicate: ViewNamePredicate;\n\n private static backHandler: NativeEventSubscription | null;\n\n private static appStateSubscription?: NativeEventSubscription;\n\n static ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE =\n 'A navigation change was detected but the RUM ViewEvent was dropped as the route was undefined.';\n static NULL_NAVIGATION_REF_ERROR_MESSAGE =\n 'Cannot track views with a null navigationRef.';\n static NAVIGATION_REF_IN_USE_ERROR_MESSAGE =\n 'Cannot track new navigation container while another one is still tracked. Please call `DdRumReactNavigationTracking.stopTrackingViews` on the previous container reference.';\n\n static isAppExitingOnBackPress = (): boolean => {\n if (DdRumReactNavigationTracking.registeredContainer === null) {\n return false;\n }\n if (DdRumReactNavigationTracking.registeredContainer.canGoBack()) {\n return false;\n }\n return true;\n };\n\n static onBackPress = () => {\n if (DdRumReactNavigationTracking.isAppExitingOnBackPress()) {\n DdRumReactNavigationTracking.stopTrackingViews(\n DdRumReactNavigationTracking.registeredContainer\n );\n }\n // We always return false so we make sure the react-navigation callback is called.\n // See https://reactnative.dev/docs/backhandler\n return false;\n };\n\n /**\n * Starts tracking the NavigationContainer and sends a RUM View event every time the navigation route changed.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static startTrackingViews(\n navigationRef: NavigationContainerRef | null,\n viewNamePredicate: ViewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n }\n ): void {\n if (navigationRef == null) {\n InternalLog.log(\n DdRumReactNavigationTracking.NULL_NAVIGATION_REF_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n if (\n DdRumReactNavigationTracking.registeredContainer != null &&\n this.registeredContainer !== navigationRef\n ) {\n InternalLog.log(\n DdRumReactNavigationTracking.NAVIGATION_REF_IN_USE_ERROR_MESSAGE,\n SdkVerbosity.ERROR\n );\n } else if (DdRumReactNavigationTracking.registeredContainer == null) {\n DdRumReactNavigationTracking.viewNamePredicate = viewNamePredicate;\n const listener = DdRumReactNavigationTracking.resolveNavigationStateChangeListener();\n DdRumReactNavigationTracking.handleRouteNavigation(\n navigationRef.getCurrentRoute(),\n AppState.currentState\n );\n navigationRef.addListener('state', listener);\n DdRumReactNavigationTracking.registeredContainer = navigationRef;\n DdRumReactNavigationTracking.backHandler = BackHandler.addEventListener(\n 'hardwareBackPress',\n DdRumReactNavigationTracking.onBackPress\n );\n this.appStateSubscription = AppState.addEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n /**\n * Stops tracking the NavigationContainer.\n * @param navigationRef the reference to the real NavigationContainer.\n */\n static stopTrackingViews(\n navigationRef: NavigationContainerRef | null\n ): void {\n if (navigationRef != null) {\n navigationRef.removeListener(\n 'state',\n DdRumReactNavigationTracking.navigationStateChangeListener\n );\n DdRumReactNavigationTracking.backHandler?.remove();\n DdRumReactNavigationTracking.backHandler = null;\n DdRumReactNavigationTracking.registeredContainer = null;\n DdRumReactNavigationTracking.viewNamePredicate = function (\n _route: Route<string, any | undefined>,\n trackedName: string\n ) {\n return trackedName;\n };\n }\n\n // For versions of React Native below 0.65, addEventListener does not return a subscription.\n // We have to call AppState.removeEventListener instead.\n if (this.appStateSubscription) {\n this.appStateSubscription.remove();\n\n // The next if check is important as users can call `stopTrackingViews` before `startTrackingViews`\n // see https://github.com/DataDog/dd-sdk-reactnative/issues/422\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n } else if (AppState.removeEventListener) {\n // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n // @ts-ignore\n AppState.removeEventListener(\n 'change',\n DdRumReactNavigationTracking.appStateListener\n );\n }\n }\n\n private static handleRouteNavigation(\n route: Route<string, any | undefined> | undefined,\n appStateStatus: AppStateStatus\n ) {\n if (route === undefined || route === null) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n // RUMM-1400 in some cases the route seem to be undefined\n return;\n }\n const key = route.key;\n const screenName = DdRumReactNavigationTracking.viewNamePredicate(\n route,\n route.name\n );\n\n if (key != null && screenName != null) {\n // On iOS, the app can start in either \"active\", \"background\" or \"unknown\" state\n if (appStateStatus !== 'background') {\n DdRum.startView(key, screenName);\n }\n }\n }\n\n private static handleAppStateChanged(\n route: Route<string, any | undefined>,\n appStateStatus: AppStateStatus\n ) {\n const key = route.key;\n const screenName = DdRumReactNavigationTracking.viewNamePredicate(\n route,\n route.name\n );\n\n if (key != null && screenName != null) {\n if (appStateStatus === 'background') {\n DdRum.stopView(key);\n } else if (appStateStatus === 'active') {\n // case when app goes into foreground,\n // in that case navigation listener won't be called\n DdRum.startView(key, screenName);\n }\n }\n }\n\n private static resolveNavigationStateChangeListener(): NavigationListener {\n if (\n DdRumReactNavigationTracking.navigationStateChangeListener == null\n ) {\n DdRumReactNavigationTracking.navigationStateChangeListener = () => {\n const route = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n\n if (route === undefined) {\n InternalLog.log(\n DdRumReactNavigationTracking.ROUTE_UNDEFINED_NAVIGATION_WARNING_MESSAGE,\n SdkVerbosity.WARN\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleRouteNavigation(\n route,\n AppState.currentState\n );\n };\n }\n return DdRumReactNavigationTracking.navigationStateChangeListener;\n }\n\n private static appStateListener: AppStateListener = (\n appStateStatus: AppStateStatus\n ) => {\n const currentRoute = DdRumReactNavigationTracking.registeredContainer?.getCurrentRoute();\n if (currentRoute === undefined || currentRoute === null) {\n InternalLog.log(\n `We could not determine the route when changing the application state to: ${appStateStatus}. No RUM View event will be sent in this case.`,\n SdkVerbosity.ERROR\n );\n return;\n }\n\n DdRumReactNavigationTracking.handleAppStateChanged(\n currentRoute,\n appStateStatus\n );\n };\n}\n"]}
@@ -12,6 +12,34 @@ export declare enum VitalsUpdateFrequency {
12
12
  RARE = "RARE",
13
13
  NEVER = "NEVER"
14
14
  }
15
+ export declare enum UploadFrequency {
16
+ /**
17
+ * Upload data every 1000ms.
18
+ */
19
+ FREQUENT = "FREQUENT",
20
+ /**
21
+ * Upload data every 5000ms.
22
+ */
23
+ AVERAGE = "AVERAGE",
24
+ /**
25
+ * Upload data every 10000ms.
26
+ */
27
+ RARE = "RARE"
28
+ }
29
+ export declare enum BatchSize {
30
+ /**
31
+ * Upload less frequent, larger batches of data
32
+ */
33
+ LARGE = "LARGE",
34
+ /**
35
+ * Use default size for batches of data
36
+ */
37
+ MEDIUM = "MEDIUM",
38
+ /**
39
+ * Upload more frequent, smaller batches of data
40
+ */
41
+ SMALL = "SMALL"
42
+ }
15
43
  export declare type FirstPartyHostsConfiguration = (FirstPartyHost | LegacyFirstPartyHost)[];
16
44
  export declare type LegacyFirstPartyHost = string;
17
45
  /**
@@ -130,6 +158,22 @@ export declare class DdSdkReactNativeConfiguration {
130
158
  * Enables tracking of frustration signals (error taps). Defaults to `true`.
131
159
  */
132
160
  trackFrustrations: boolean;
161
+ /**
162
+ * Sets the preferred frequency for uploading batches of data.
163
+ */
164
+ uploadFrequency: UploadFrequency;
165
+ /**
166
+ * Defines the Datadog SDK policy when batching data together before uploading it to Datadog servers.
167
+ * Smaller batches mean smaller but more network requests, whereas larger batches mean fewer but larger network requests.
168
+ */
169
+ batchSize: BatchSize;
170
+ /**
171
+ * Enables tracking of RUM event when no RUM View is active.
172
+ *
173
+ * By default, background events are not tracked. Enabling this feature might increase the
174
+ * number of sessions tracked and impact your billing.
175
+ */
176
+ trackBackgroundEvents: boolean;
133
177
  logEventMapper: LogEventMapper | null;
134
178
  errorEventMapper: ErrorEventMapper | null;
135
179
  resourceEventMapper: ResourceEventMapper | null;
@@ -196,6 +240,9 @@ export declare type PartialInitializationConfiguration = {
196
240
  readonly telemetrySampleRate?: number;
197
241
  readonly vitalsUpdateFrequency?: VitalsUpdateFrequency;
198
242
  readonly trackFrustrations?: boolean;
243
+ readonly uploadFrequency?: UploadFrequency;
244
+ readonly batchSize?: BatchSize;
245
+ readonly trackBackgroundEvents?: boolean;
199
246
  };
200
247
  export declare const buildConfigurationFromPartialConfiguration: (features: AutoInstrumentationConfiguration, configuration: PartialInitializationConfiguration) => DdSdkReactNativeConfiguration;
201
248
  export declare class DatadogProviderConfiguration extends DdSdkReactNativeConfiguration {
@@ -1,4 +1,4 @@
1
- import { DatadogProviderConfiguration, DdSdkReactNativeConfiguration, InitializationMode, VitalsUpdateFrequency } from './DdSdkReactNativeConfiguration';
1
+ import { DatadogProviderConfiguration, DdSdkReactNativeConfiguration, InitializationMode, VitalsUpdateFrequency, UploadFrequency, BatchSize } from './DdSdkReactNativeConfiguration';
2
2
  import { DdSdkReactNative } from './DdSdkReactNative';
3
3
  import { InternalLog } from './InternalLog';
4
4
  import { ProxyConfiguration, ProxyType } from './ProxyConfiguration';
@@ -9,4 +9,4 @@ import { DdRum } from './rum/DdRum';
9
9
  import { RumActionType, ErrorSource, PropagatorType } from './rum/types';
10
10
  import { DatadogProvider } from './sdk/DatadogProvider/DatadogProvider';
11
11
  import { DdTrace } from './trace/DdTrace';
12
- export { DatadogProvider, DatadogProviderConfiguration, InitializationMode, DdLogs, DdTrace, DdRum, RumActionType, ErrorSource, DdSdkReactNativeConfiguration, DdSdkReactNative, InternalLog, ProxyConfiguration, ProxyType, TrackingConsent, SdkVerbosity, VitalsUpdateFrequency, PropagatorType };
12
+ export { DatadogProvider, DatadogProviderConfiguration, InitializationMode, DdLogs, DdTrace, DdRum, RumActionType, ErrorSource, DdSdkReactNativeConfiguration, DdSdkReactNative, InternalLog, ProxyConfiguration, ProxyType, TrackingConsent, SdkVerbosity, VitalsUpdateFrequency, PropagatorType, UploadFrequency, BatchSize };
@@ -218,6 +218,13 @@ export declare type DdNativeRumType = {
218
218
  * Stops the current RUM Session.
219
219
  */
220
220
  stopSession(): Promise<void>;
221
+ /**
222
+ * Adds the result of evaluating a feature flag with a given name and value to the view.
223
+ * Feature flag evaluations are local to the active view and are cleared when the view is stopped.
224
+ * @param name: The name of the feature flag
225
+ * @param value: The value of the feature flag, encapsulated in an object to accept all types
226
+ */
227
+ addFeatureFlagEvaluation(name: string, value: object): Promise<void>;
221
228
  };
222
229
  declare type ActionType = 'TAP' | 'SCROLL' | 'SWIPE' | 'BACK' | 'CUSTOM';
223
230
  declare type ResourceKind = 'image' | 'xhr' | 'beacon' | 'css' | 'document' | 'fetch' | 'font' | 'js' | 'media' | 'other' | 'native';
@@ -26,6 +26,7 @@ declare class DdRumWrapper implements DdRumType {
26
26
  addError(message: string, source: ErrorSource, stacktrace: string, context?: object, timestampMs?: number): Promise<void>;
27
27
  addTiming(name: string): Promise<void>;
28
28
  stopSession(): Promise<void>;
29
+ addFeatureFlagEvaluation(name: string, value: unknown): Promise<void>;
29
30
  registerErrorEventMapper(errorEventMapper: ErrorEventMapper): void;
30
31
  unregisterErrorEventMapper(): void;
31
32
  registerResourceEventMapper(resourceEventMapper: ResourceEventMapper): void;
@@ -14,7 +14,10 @@ export declare class DdSdkConfiguration {
14
14
  readonly additionalConfig: object;
15
15
  readonly telemetrySampleRate: number;
16
16
  readonly vitalsUpdateFrequency: string;
17
+ readonly uploadFrequency: string;
18
+ readonly batchSize: string;
17
19
  readonly trackFrustrations: boolean;
20
+ readonly trackBackgroundEvents: boolean;
18
21
  readonly configurationForTelemetry: {
19
22
  initializationType: string;
20
23
  trackErrors: boolean;
@@ -23,7 +26,7 @@ export declare class DdSdkConfiguration {
23
26
  reactVersion: string;
24
27
  reactNativeVersion: string;
25
28
  };
26
- constructor(clientToken: string, env: string, applicationId: string, nativeCrashReportEnabled: boolean, nativeLongTaskThresholdMs: number, longTaskThresholdMs: number, sampleRate: number, site: string, trackingConsent: string, additionalConfig: object, telemetrySampleRate: number, vitalsUpdateFrequency: string, trackFrustrations: boolean, configurationForTelemetry: {
29
+ constructor(clientToken: string, env: string, applicationId: string, nativeCrashReportEnabled: boolean, nativeLongTaskThresholdMs: number, longTaskThresholdMs: number, sampleRate: number, site: string, trackingConsent: string, additionalConfig: object, telemetrySampleRate: number, vitalsUpdateFrequency: string, uploadFrequency: string, batchSize: string, trackFrustrations: boolean, trackBackgroundEvents: boolean, configurationForTelemetry: {
27
30
  initializationType: string;
28
31
  trackErrors: boolean;
29
32
  trackInteractions: boolean;
@@ -1 +1 @@
1
- export declare const version = "1.6.0";
1
+ export declare const version = "1.7.1";
@@ -25,6 +25,7 @@ export declare class DdRumReactNavigationTracking {
25
25
  */
26
26
  static stopTrackingViews(navigationRef: NavigationContainerRef | null): void;
27
27
  private static handleRouteNavigation;
28
+ private static handleAppStateChanged;
28
29
  private static resolveNavigationStateChangeListener;
29
30
  private static appStateListener;
30
31
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@datadog/mobile-react-navigation",
3
- "version": "1.6.0",
3
+ "version": "1.7.1",
4
4
  "description": "A client-side React Native module to interact with Datadog",
5
5
  "keywords": [
6
6
  "datadog",
@@ -36,7 +36,7 @@
36
36
  "prepare": "rm -rf lib && yarn bob build"
37
37
  },
38
38
  "devDependencies": {
39
- "@datadog/mobile-react-native": "^1.6.0",
39
+ "@datadog/mobile-react-native": "^1.7.1",
40
40
  "@react-navigation/native-v5": "npm:@react-navigation/native@5.9.8",
41
41
  "@react-navigation/native-v6": "npm:@react-navigation/native@6.1.2",
42
42
  "@react-navigation/stack-v5": "npm:@react-navigation/stack@5.14.2",
@@ -77,5 +77,5 @@
77
77
  ]
78
78
  ]
79
79
  },
80
- "gitHead": "b95779b45f4917992f898f426a6640472b77cc3d"
80
+ "gitHead": "fc56f843fcd9d218be684ac52a1be8d2c31e455c"
81
81
  }
@@ -386,6 +386,7 @@ describe.each([
386
386
  (reactNativeVersion, AppStateMockVersion) => {
387
387
  let appStateMock;
388
388
  beforeEach(() => {
389
+ AppState.currentState = 'active';
389
390
  appStateMock = new AppStateMockVersion();
390
391
  mocked(AppState.addEventListener).mockImplementation(
391
392
  // @ts-ignore
@@ -476,7 +477,7 @@ describe.each([
476
477
  ).toBe('string');
477
478
  });
478
479
 
479
- it('starts last view when app goes into foreground', async () => {
480
+ it('restarts last view when app goes into foreground', async () => {
480
481
  // GIVEN
481
482
  const navigationRef = createRef<any>();
482
483
  render(<FakeNavigator1 navigationRef={navigationRef} />);
@@ -531,6 +532,43 @@ describe.each([
531
532
  // THEN
532
533
  expect(DdRum.stopView).toHaveBeenCalled();
533
534
  });
535
+
536
+ it('does not create a RUM view when the app starts in background', async () => {
537
+ // GIVEN
538
+ appStateMock.changeValue('background');
539
+ const navigationRef = createRef<any>();
540
+ render(<FakeNavigator1 navigationRef={navigationRef} />);
541
+
542
+ DdRumReactNavigationTracking.startTrackingViews(
543
+ navigationRef.current
544
+ );
545
+
546
+ // THEN
547
+ expect(DdRum.startView).not.toHaveBeenCalled();
548
+ });
549
+
550
+ // Note: currently iOS apps start in "unknown" app state, but should default to "inactive"
551
+ it.each(['unknown', 'inactive'])(
552
+ 'creates 2 RUM Views when the app starts in %s then becomes active',
553
+ async initialAppState => {
554
+ // GIVEN
555
+ appStateMock.changeValue(initialAppState);
556
+ const navigationRef = createRef<any>();
557
+ render(
558
+ <FakeNavigator1 navigationRef={navigationRef} />
559
+ );
560
+
561
+ DdRumReactNavigationTracking.startTrackingViews(
562
+ navigationRef.current
563
+ );
564
+
565
+ // WHEN
566
+ appStateMock.changeValue('active');
567
+
568
+ // THEN
569
+ expect(DdRum.startView).toHaveBeenCalledTimes(2);
570
+ }
571
+ );
534
572
  }
535
573
  );
536
574
 
@@ -9,6 +9,7 @@ import type {
9
9
  AppStateStatus,
10
10
  NativeEventSubscription
11
11
  } from 'react-native';
12
+ import { AppState } from 'react-native';
12
13
 
13
14
  type handler = (type: AppStateStatus) => void;
14
15
 
@@ -55,6 +56,8 @@ export class AppStateMock {
55
56
  };
56
57
 
57
58
  changeValue = (value: AppStateStatus) => {
59
+ // Currently jest does not let us mock getters
60
+ AppState.currentState = value;
58
61
  if (!this.listeners.change) {
59
62
  return;
60
63
  }
@@ -5,6 +5,7 @@
5
5
  */
6
6
 
7
7
  import type { AppStateEvent, AppStateStatus } from 'react-native';
8
+ import { AppState } from 'react-native';
8
9
 
9
10
  type handler = (type: AppStateStatus) => void;
10
11
 
@@ -41,6 +42,8 @@ export class AppStateMockLegacy {
41
42
  };
42
43
 
43
44
  changeValue = (value: AppStateStatus) => {
45
+ // Currently jest does not let us mock getters
46
+ AppState.currentState = value;
44
47
  if (!this.listeners.change) {
45
48
  return;
46
49
  }
@@ -102,7 +102,8 @@ export class DdRumReactNavigationTracking {
102
102
  DdRumReactNavigationTracking.viewNamePredicate = viewNamePredicate;
103
103
  const listener = DdRumReactNavigationTracking.resolveNavigationStateChangeListener();
104
104
  DdRumReactNavigationTracking.handleRouteNavigation(
105
- navigationRef.getCurrentRoute()
105
+ navigationRef.getCurrentRoute(),
106
+ AppState.currentState
106
107
  );
107
108
  navigationRef.addListener('state', listener);
108
109
  DdRumReactNavigationTracking.registeredContainer = navigationRef;
@@ -161,7 +162,7 @@ export class DdRumReactNavigationTracking {
161
162
 
162
163
  private static handleRouteNavigation(
163
164
  route: Route<string, any | undefined> | undefined,
164
- appStateStatus: AppStateStatus | undefined = undefined
165
+ appStateStatus: AppStateStatus
165
166
  ) {
166
167
  if (route === undefined || route === null) {
167
168
  InternalLog.log(
@@ -172,17 +173,33 @@ export class DdRumReactNavigationTracking {
172
173
  return;
173
174
  }
174
175
  const key = route.key;
176
+ const screenName = DdRumReactNavigationTracking.viewNamePredicate(
177
+ route,
178
+ route.name
179
+ );
175
180
 
176
- const predicate = DdRumReactNavigationTracking.viewNamePredicate;
177
- const screenName = predicate(route, route.name);
181
+ if (key != null && screenName != null) {
182
+ // On iOS, the app can start in either "active", "background" or "unknown" state
183
+ if (appStateStatus !== 'background') {
184
+ DdRum.startView(key, screenName);
185
+ }
186
+ }
187
+ }
188
+
189
+ private static handleAppStateChanged(
190
+ route: Route<string, any | undefined>,
191
+ appStateStatus: AppStateStatus
192
+ ) {
193
+ const key = route.key;
194
+ const screenName = DdRumReactNavigationTracking.viewNamePredicate(
195
+ route,
196
+ route.name
197
+ );
178
198
 
179
199
  if (key != null && screenName != null) {
180
200
  if (appStateStatus === 'background') {
181
201
  DdRum.stopView(key);
182
- } else if (
183
- appStateStatus === 'active' ||
184
- appStateStatus === undefined
185
- ) {
202
+ } else if (appStateStatus === 'active') {
186
203
  // case when app goes into foreground,
187
204
  // in that case navigation listener won't be called
188
205
  DdRum.startView(key, screenName);
@@ -205,7 +222,10 @@ export class DdRumReactNavigationTracking {
205
222
  return;
206
223
  }
207
224
 
208
- DdRumReactNavigationTracking.handleRouteNavigation(route);
225
+ DdRumReactNavigationTracking.handleRouteNavigation(
226
+ route,
227
+ AppState.currentState
228
+ );
209
229
  };
210
230
  }
211
231
  return DdRumReactNavigationTracking.navigationStateChangeListener;
@@ -223,7 +243,7 @@ export class DdRumReactNavigationTracking {
223
243
  return;
224
244
  }
225
245
 
226
- DdRumReactNavigationTracking.handleRouteNavigation(
246
+ DdRumReactNavigationTracking.handleAppStateChanged(
227
247
  currentRoute,
228
248
  appStateStatus
229
249
  );