React Native raw event EventEmitter - intended for app-specific perf listeners and debugging

packages/react-native-renderer/src/ReactFabricEventEmitter.js

@@ -21,6 +21,8 @@ import {plugins} from './legacy-events/EventPluginRegistry';
 import getListener from './ReactNativeGetListener';
 import {runEventsInBatch} from './legacy-events/EventBatching';
 
+import {RawEventTelemetryEventEmitterOffByDefault} from 'react-native/Libraries/ReactPrivate/ReactNativePrivateInterface';
+
 export {getListener, registrationNameModules as registrationNames};
 
 /**
@@ -88,6 +90,31 @@ export function dispatchEvent(
   }
 
   batchedUpdates(function() {
+    // Emit event to the event telemetry system.
+    //
+    // NOTE: this event telemetry system does *nothing* without explicit,
+    // per-application opt-in, and merely emits events into the local
+    // EventEmitter below. If *you* do not add listeners to the `RawEventTelemetryEventEmitter`,
+    // then all of these emitted events will just blackhole and are no-ops.
+    // It is available (although not officially supported... yet) if you want to collect
+    // telemetry on event latency in your application, and could also be useful for debugging
+    // low-level events issues.
+    //
+    // If you do not have any event telemetry and are extremely concerned about event perf,
+    // it is safe to disable these "emit" statements; it will prevent checking the size of
+    // an empty array twice and prevent two no-ops. Practically the overhead is so low that
+    // we don't think it's worth thinking about in prod; your perf issues probably lie elsewhere.
+    //
+    // We emit two events here: one for listeners to this specific event,
+    // and one for the catchall listener '*', for any listeners that want
+    // to be notified for all events.
+    // Note that extracted events are *not* emitted into the telemetry system,
+    // only events that have a 1:1 mapping with a native event, at least for now.
+    const topLevelTypeStr: string = ((topLevelType: any): string);
+    const event = {eventName: topLevelTypeStr, nativeEvent};
+    RawEventTelemetryEventEmitterOffByDefault.emit(topLevelTypeStr, event);
+    RawEventTelemetryEventEmitterOffByDefault.emit('*', event);
+
     // Heritage plugin event system
     runExtractedPluginEventsInBatch(
       topLevelType,

packages/react-native-renderer/src/__mocks__/react-native/Libraries/ReactPrivate/RawEventTelemetryEventEmitterOffByDefault.js

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+// See the react-native repository for a full implementation.
+// However, this is just an EventEmitter.
+const RawEventTelemetryEventEmitterOffByDefault = {
+  emit: jest.fn(),
+};
+
+module.exports = {default: RawEventTelemetryEventEmitterOffByDefault};

packages/react-native-renderer/src/__mocks__/react-native/Libraries/ReactPrivate/ReactNativePrivateInterface.js

@@ -41,4 +41,7 @@ module.exports = {
   get legacySendAccessibilityEvent() {
     return require('./legacySendAccessibilityEvent');
   },
+  get RawEventTelemetryEventEmitterOffByDefault() {
+    return require('./RawEventTelemetryEventEmitterOffByDefault').default;
+  },
 };

scripts/flow/react-native-host-hooks.js

@@ -21,6 +21,13 @@ import type {CapturedError} from 'react-reconciler/src/ReactCapturedValue';
 import type {Fiber} from 'react-reconciler/src/ReactInternalTypes';
 
 type DeepDifferOptions = {|+unsafelyIgnoreFunctions?: boolean|};
+type RawEventTelemetryEvent = $ReadOnly<{|
+  eventName: string,
+  // We expect, but do not/cannot require, that nativeEvent is an object
+  // with the properties: key, elementType (string), type (string), tag (numeric),
+  // and a stateNode of the native element/Fiber the event was emitted to.
+  nativeEvent: {[string]: mixed},
+|}>;
 
 declare module 'react-native/Libraries/ReactPrivate/ReactNativePrivateInterface' {
   declare export function deepDiffer(
@@ -127,6 +134,10 @@ declare module 'react-native/Libraries/ReactPrivate/ReactNativePrivateInterface'
     get: (name: string) => ReactNativeBaseComponentViewConfig,
     ...
   };
+  declare export var RawEventTelemetryEventEmitterOffByDefault: {
+    emit: (channel: string, event: RawEventTelemetryEvent) => string,
+    ...
+  };
 }
 
 declare module 'react-native/Libraries/ReactPrivate/ReactNativePrivateInitializeCore' {