Skip to content

Conversation

@huntie
Copy link
Member

@huntie huntie commented Oct 24, 2025

Summary:
Introduces the concept of Performance Issues, an experimental performance signals concept for React Native.

Design

Performance Issues are an experimental user space API via the User Timings devtools object.

performance.measure({
  start,
  end,
  detail: {
    devtools: {
      ...
      rnIssueLevel: 'info' | 'warning' | 'error'
    }
  }
});

When rnIssueLevel is present, we eagerly report an the event over CDP, regardless of an active performance trace, via the "__react_native_perf_issues_reporter" runtime binding.

This diff

This feature is gated by the perfMonitorV2Enabled feature flag.

Changelog: [Internal]

Differential Revision: D85448200

Summary:
Introduces the concept of **Performance Issues**, an experimental performance signals concept for React Native.

**Design**

Performance Issues are an **experimental** user space API via the User Timings [`devtools` object](https://developer.chrome.com/docs/devtools/performance/extension#devtools_object).

```
performance.measure({
  start,
  end,
  detail: {
    devtools: {
      ...
      rnIssueLevel: 'info' | 'warning' | 'error'
    }
  }
});
```

When `rnIssueLevel` is present, we eagerly report an the event over CDP, regardless of an active performance trace, via the `"__react_native_perf_issues_reporter"` runtime binding.

**This diff**

- Adds a `perfIssuesEnabled` feature flag.
- Initial implementation of the above API.
- Initially reports a "Cascading Render" issue, aligning 1:1 with the corresponding React performance track event (note: to be added in the React codebase, see facebook/react#34961).

This feature is gated by the `perfMonitorV2Enabled` feature flag.

Changelog: [Internal]

Differential Revision: D85448200
@meta-cla meta-cla bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Oct 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. fb-exported meta-exported p: Facebook Partner: Facebook Partner

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants