Edit this page
A guide on configuring JS engines for both Android and iOS in an Expo project.
Edit this page
JavaScript engines execute your application code and provide various features such as memory management, optimization, and error handling. By default, Expo projects use Hermes as the JavaScript engine (in SDK 47 and lower, the default was JavaScriptCore). Switching to other engines, such as JSC or V8, for Android and iOS platforms is possible. However, not for the web because the JavaScript engine is included in the web browser.
jsEngine
through app configWe recommend Hermes because it is purpose built and optimized for React Native apps, and it has the best debugging experience. If you are familiar with the tradeoffs of different JavaScript engines and would like to change away from Hermes, the jsEngine
field inside app config allows you to specify the JavaScript engine for your app. The default value is hermes
.
If you want to use JSC instead, set the jsEngine
field in the app config:
{
"expo": {
"jsEngine": "jsc"
}
}
To change the JavaScript engine in a bare React Native project, update the expo.jsEngine
value in android/gradle.properties and ios/Podfile.properties.json.
It's important to highlight that changing the JS engine will require you to recompile development builds with eas build
to work properly.
To use the V8 engine, you need to install react-native-v8
, an opt-in package that adds V8 runtime support for React Native. You can install it by running the following command:
-
npx expo install react-native-v8 v8-android-jit
Make sure to remove the jsEngine
field from the app config.
Run npx expo prebuild -p android --clean
after the installation to prebuild again.
To use a different engine on one specific platform, you can set the "jsEngine"
value at the top level and then override it with a different value under the "android"
or "ios"
key. The value specified for the platform will take precedence over the common field.
{
"expo": {
"jsEngine": "hermes",
"ios": {
"jsEngine": "jsc"
}
}
}