Skip to content

Harness brings Jest-style tests to real native environments so you can test TurboModules like you would test your React Native app: with JavaScript.

License

Notifications You must be signed in to change notification settings

callstackincubator/react-native-harness

Repository files navigation

harness-banner

Jest-style tool for testing native behavior directly on devices

mit licence npm downloads Chat PRs Welcome

Bridge the testing gap: Jest-style tests in real native environments. Get the convenience of describe/it with full access to native modules.

Features

  • Jest-Style Syntax, Native Power: Write familiar describe/it tests that run in real iOS and Android environments with full native module access.
  • Best of Both Worlds: Unlike Jest (Node.js only) or Maestro (UI-based), get convenient test syntax AND native environment execution.
  • Real Device & Simulator Testing: Execute tests directly on iOS simulators and Android emulators — catch platform-specific issues Jest can't see.
  • Native Module Testing: Test native modules, platform APIs, and device-specific functionality that's impossible with JavaScript-only runners.
  • Familiar Test Structure: Use beforeEach, afterEach, describe, it, expect — all the testing patterns you know and love from Jest.
  • Zero Configuration Setup: Drop-in replacement for your existing test workflow with TypeScript support and seamless CI/CD integration.

Warning

This library is still under active development. Feel free to hack around, but use at your own risk.

Documentation

The documentation is available at react-native-harness.dev. You can also use the following links to jump to specific topics:

Made with ❤️ at Callstack

react-native-harness is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. Callstack is a group of React and React Native geeks, contact us at hello@callstack.com if you need any help with these or just want to say hi!

Like the project? ⚛️ Join the team who does amazing stuff for clients and drives React Native Open Source! 🔥

About

Harness brings Jest-style tests to real native environments so you can test TurboModules like you would test your React Native app: with JavaScript.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks