`requestIdleCallback` is not defined in TS types

Open Beginner friendly
#58,565 1 comment 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
82/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
react-native, typescript
Domain
mobile

Research direction

Start with the mandatory reproducer at https://github.com/simon-abbott/rn-bug-idle-callback-type-missing and inspect the React Native 0.87 TypeScript declarations related to requestIdleCallback. The issue is done when a requestIdleCallback call type-checks successfully without the TS2304 error.

Written by the indexing model from the issue text.

Description

Needs: Triage :mag:
Description

The v0.87 announcement says that InteractionManager has been removed (https://github.com/react/react-native/pull/57394) and we should use requestIdleCallback instead. The only issue with that is that when I put a call to requestIdleCallback in the code TypeScript spits out the error Cannot find name 'requestIdleCallback'., which means we can't actually use requestIdleCallback without breaking the TypeScript build.

Steps to reproduce
  1. Update to React Native 0.87
  2. Try to call requestIdleCallback
React Native Version

0.87.1

Affected Platforms

Build - MacOS

Output of npx @react-native-community/cli info
info Fetching system and libraries information...
System:
  OS: macOS 26.7
  CPU: (14) arm64 Apple M4 Pro
  Memory: 258.31 MB / 48.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 24.16.0
    path: /Users/<redacted>/.nvm/versions/node/v24.16.0/bin/node
  Yarn:
    version: 1.22.19
    path: /usr/local/bin/yarn
  npm:
    version: 11.13.0
    path: /Users/<redacted>/.nvm/versions/node/v24.16.0/bin/npm
  Watchman:
    version: 2026.07.27.00
    path: /run/current-system/sw/bin/watchman
Managers:
  CocoaPods:
    version: 1.16.2
    path: /usr/local/bin/pod
SDKs:
  iOS SDK:
    Platforms:
      - DriverKit 25.5
      - iOS 26.5
      - macOS 26.5
      - tvOS 26.5
      - visionOS 26.5
      - watchOS 26.5
  Android SDK: Not Found
IDEs:
  Android Studio: 2025.1 AI-251.26094.121.2512.13930704
  Xcode:
    version: 26.6/17F113
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.19
    path: /run/current-system/sw/bin/javac
  Ruby:
    version: 2.7.8
    path: /Users/<redacted>/.rbenv/shims/ruby
npmPackages:
  "@react-native-community/cli":
    installed: 20.2.0
    wanted: 20.2.0
  react:
    installed: 19.2.3
    wanted: 19.2.3
  react-native:
    installed: 0.87.1
    wanted: 0.87.1
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: true
iOS:
  hermesEnabled: true
  newArchEnabled: true
Stacktrace or Logs
path/to/problem/file.ts:36:20 - error TS2304: Cannot find name 'requestIdleCallback'.

36       const task = requestIdleCallback(() => {
                      ~~~~~~~~~~~~~~~~~~~
MANDATORY Reproducer

https://github.com/simon-abbott/rn-bug-idle-callback-type-missing

Screenshots and Videos

No response

Dominant language
C++
Stars
127k
Forks
25.3k
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from react/react-native

All issues in react/react-native

Similar issues

More C++ issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.