// Copyright 2004-present Facebook. All Rights Reserved. #include "JSCExecutor.h" #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "JSBigString.h" #include "JSBundleType.h" #include "JSCLegacyTracing.h" #include "JSCMemory.h" #include "JSCNativeModules.h" #include "JSCPerfStats.h" #include "JSCSamplingProfiler.h" #include "JSCTracing.h" #include "JSCUtils.h" #include "JSModulesUnbundle.h" #include "ModuleRegistry.h" #include "Platform.h" #include "RecoverableError.h" #include "SystraceSection.h" #if defined(WITH_JSC_MEMORY_PRESSURE) #include #endif #if defined(WITH_FB_JSC_TUNING) && defined(__ANDROID__) #include #endif namespace facebook { namespace react { namespace { template inline JSObjectCallAsFunctionCallback exceptionWrapMethod() { struct funcWrapper { static JSValueRef call( JSContextRef ctx, JSObjectRef function, JSObjectRef thisObject, size_t argumentCount, const JSValueRef arguments[], JSValueRef *exception) { try { auto executor = Object::getGlobalObject(ctx).getPrivate(); if (executor && executor->getJavaScriptContext()) { // Executor not invalidated return (executor->*method)(argumentCount, arguments); } } catch (...) { *exception = translatePendingCppExceptionToJSError(ctx, function); } return Value::makeUndefined(ctx); } }; return &funcWrapper::call; } template inline JSObjectGetPropertyCallback exceptionWrapMethod() { struct funcWrapper { static JSValueRef call( JSContextRef ctx, JSObjectRef object, JSStringRef propertyName, JSValueRef *exception) { try { auto executor = Object::getGlobalObject(ctx).getPrivate(); if (executor && executor->getJavaScriptContext()) { // Executor not invalidated return (executor->*method)(object, propertyName); } } catch (...) { *exception = translatePendingCppExceptionToJSError(ctx, object); } return Value::makeUndefined(ctx); } }; return &funcWrapper::call; } } #if DEBUG static JSValueRef nativeInjectHMRUpdate( JSContextRef ctx, JSObjectRef function, JSObjectRef thisObject, size_t argumentCount, const JSValueRef arguments[], JSValueRef *exception) { String execJSString = Value(ctx, arguments[0]).toString(); String jsURL = Value(ctx, arguments[1]).toString(); evaluateScript(ctx, execJSString, jsURL); return Value::makeUndefined(ctx); } #endif std::unique_ptr JSCExecutorFactory::createJSExecutor( std::shared_ptr delegate, std::shared_ptr jsQueue) { return folly::make_unique(delegate, jsQueue, m_jscConfig); } JSCExecutor::JSCExecutor(std::shared_ptr delegate, std::shared_ptr messageQueueThread, const folly::dynamic& jscConfig) throw(JSException) : m_delegate(delegate), m_messageQueueThread(messageQueueThread), m_nativeModules(delegate ? delegate->getModuleRegistry() : nullptr), m_jscConfig(jscConfig) { initOnJSVMThread(); { SystraceSection s("nativeModuleProxy object"); installGlobalProxy(m_context, "nativeModuleProxy", exceptionWrapMethod<&JSCExecutor::getNativeModule>()); } } JSCExecutor::~JSCExecutor() { CHECK(*m_isDestroyed) << "JSCExecutor::destroy() must be called before its destructor!"; } void JSCExecutor::destroy() { *m_isDestroyed = true; if (m_messageQueueThread.get()) { m_messageQueueThread->runOnQueueSync([this] () { terminateOnJSVMThread(); }); } else { terminateOnJSVMThread(); } } void JSCExecutor::setContextName(const std::string& name) { String jsName = String(m_context, name.c_str()); JSC_JSGlobalContextSetName(m_context, jsName); } static bool canUseInspector(JSContextRef context) { #ifdef WITH_INSPECTOR #if defined(__APPLE__) return isCustomJSCPtr(context); // WITH_INSPECTOR && Apple #else return true; // WITH_INSPECTOR && Android #endif #else return false; // !WITH_INSPECTOR #endif } static bool canUseSamplingProfiler(JSContextRef context) { #if defined(__APPLE__) || defined(WITH_JSC_EXTRA_TRACING) return JSC_JSSamplingProfilerEnabled(context); #else return false; #endif } void JSCExecutor::initOnJSVMThread() throw(JSException) { SystraceSection s("JSCExecutor::initOnJSVMThread"); #if defined(__APPLE__) const bool useCustomJSC = m_jscConfig.getDefault("UseCustomJSC", false).getBool(); if (useCustomJSC) { JSC_configureJSCForIOS(true, toJson(m_jscConfig)); } #else const bool useCustomJSC = false; #endif #if defined(WITH_FB_JSC_TUNING) && defined(__ANDROID__) configureJSCForAndroid(m_jscConfig); #endif // Create a custom global class, so we can store data in it later using JSObjectSetPrivate JSClassRef globalClass = nullptr; { SystraceSection s_("JSClassCreate"); JSClassDefinition definition = kJSClassDefinitionEmpty; definition.attributes |= kJSClassAttributeNoAutomaticPrototype; globalClass = JSC_JSClassCreate(useCustomJSC, &definition); } { SystraceSection s_("JSGlobalContextCreateInGroup"); m_context = JSC_JSGlobalContextCreateInGroup(useCustomJSC, nullptr, globalClass); } JSC_JSClassRelease(useCustomJSC, globalClass); // Add a pointer to ourselves so we can retrieve it later in our hooks Object::getGlobalObject(m_context).setPrivate(this); if (canUseInspector(m_context)) { const std::string ownerId = m_jscConfig.getDefault("OwnerIdentity", "main").getString(); IInspector* pInspector = JSC_JSInspectorGetInstance(true); pInspector->registerGlobalContext(ownerId, m_context); } installNativeHook<&JSCExecutor::nativeFlushQueueImmediate>("nativeFlushQueueImmediate"); installNativeHook<&JSCExecutor::nativeCallSyncHook>("nativeCallSyncHook"); installGlobalFunction(m_context, "nativeLoggingHook", JSCNativeHooks::loggingHook); installGlobalFunction(m_context, "nativePerformanceNow", JSCNativeHooks::nowHook); #if DEBUG installGlobalFunction(m_context, "nativeInjectHMRUpdate", nativeInjectHMRUpdate); #endif addNativeTracingHooks(m_context); addNativeTracingLegacyHooks(m_context); addJSCMemoryHooks(m_context); addJSCPerfStatsHooks(m_context); JSCNativeHooks::installPerfHooks(m_context); if (canUseSamplingProfiler(m_context)) { initSamplingProfilerOnMainJSCThread(m_context); } } void JSCExecutor::terminateOnJSVMThread() { JSGlobalContextRef context = m_context; m_context = nullptr; Object::getGlobalObject(context).setPrivate(nullptr); m_nativeModules.reset(); if (canUseInspector(context)) { IInspector* pInspector = JSC_JSInspectorGetInstance(true); pInspector->unregisterGlobalContext(context); } JSC_JSGlobalContextRelease(context); } #ifdef WITH_FBJSCEXTENSIONS static const char* explainLoadSourceStatus(JSLoadSourceStatus status) { switch (status) { case JSLoadSourceIsCompiled: return "No error encountered during source load"; case JSLoadSourceErrorOnRead: return "Error reading source"; case JSLoadSourceIsNotCompiled: return "Source is not compiled"; case JSLoadSourceErrorVersionMismatch: return "Source version not supported"; default: return "Bad error code"; } } #endif // basename_r isn't in all iOS SDKs, so use this simple version instead. static std::string simpleBasename(const std::string &path) { size_t pos = path.rfind("/"); return (pos != std::string::npos) ? path.substr(pos) : path; } void JSCExecutor::loadApplicationScript(std::unique_ptr script, std::string sourceURL) { SystraceSection s("JSCExecutor::loadApplicationScript", "sourceURL", sourceURL); std::string scriptName = simpleBasename(sourceURL); ReactMarker::logTaggedMarker(ReactMarker::RUN_JS_BUNDLE_START, scriptName.c_str()); String jsSourceURL(m_context, sourceURL.c_str()); // TODO t15069155: reduce the number of overrides here #ifdef WITH_FBJSCEXTENSIONS if (auto fileStr = dynamic_cast(script.get())) { JSContextLock lock(m_context); JSLoadSourceStatus jsStatus; auto bcSourceCode = JSCreateSourceCodeFromFile(fileStr->fd(), jsSourceURL, nullptr, &jsStatus); switch (jsStatus) { case JSLoadSourceIsCompiled: if (!bcSourceCode) { throw std::runtime_error("Unexpected error opening compiled bundle"); } evaluateSourceCode(m_context, bcSourceCode, jsSourceURL); flush(); ReactMarker::logMarker(ReactMarker::CREATE_REACT_CONTEXT_STOP); ReactMarker::logMarker(ReactMarker::RUN_JS_BUNDLE_STOP); return; case JSLoadSourceErrorVersionMismatch: throw RecoverableError(explainLoadSourceStatus(jsStatus)); case JSLoadSourceErrorOnRead: case JSLoadSourceIsNotCompiled: // Not bytecode, fall through. break; } } #elif defined(__APPLE__) BundleHeader header; memcpy(&header, script->c_str(), std::min(script->size(), sizeof(BundleHeader))); auto scriptTag = parseTypeFromHeader(header); if (scriptTag == ScriptTag::BCBundle) { using file_ptr = std::unique_ptr; file_ptr source(fopen(sourceURL.c_str(), "r"), fclose); int sourceFD = fileno(source.get()); JSValueRef jsError; JSValueRef result = JSC_JSEvaluateBytecodeBundle(m_context, NULL, sourceFD, jsSourceURL, &jsError); if (result == nullptr) { throw JSException(m_context, jsError, jsSourceURL); } } else #endif { String jsScript; JSContextLock lock(m_context); { SystraceSection s_("JSCExecutor::loadApplicationScript-createExpectingAscii"); ReactMarker::logMarker(ReactMarker::JS_BUNDLE_STRING_CONVERT_START); jsScript = adoptString(std::move(script)); ReactMarker::logMarker(ReactMarker::JS_BUNDLE_STRING_CONVERT_STOP); } #ifdef WITH_FBSYSTRACE fbsystrace_end_section(TRACE_TAG_REACT_CXX_BRIDGE); #endif SystraceSection s_("JSCExecutor::loadApplicationScript-evaluateScript"); evaluateScript(m_context, jsScript, jsSourceURL); } flush(); ReactMarker::logMarker(ReactMarker::CREATE_REACT_CONTEXT_STOP); ReactMarker::logMarker(ReactMarker::RUN_JS_BUNDLE_STOP); } void JSCExecutor::setJSModulesUnbundle(std::unique_ptr unbundle) { if (!m_unbundle) { installNativeHook<&JSCExecutor::nativeRequire>("nativeRequire"); } m_unbundle = std::move(unbundle); } void JSCExecutor::bindBridge() throw(JSException) { SystraceSection s("JSCExecutor::bindBridge"); std::call_once(m_bindFlag, [this] { auto global = Object::getGlobalObject(m_context); auto batchedBridgeValue = global.getProperty("__fbBatchedBridge"); if (batchedBridgeValue.isUndefined()) { auto requireBatchedBridge = global.getProperty("__fbRequireBatchedBridge"); if (!requireBatchedBridge.isUndefined()) { batchedBridgeValue = requireBatchedBridge.asObject().callAsFunction({}); } if (batchedBridgeValue.isUndefined()) { throw JSException("Could not get BatchedBridge, make sure your bundle is packaged correctly"); } } auto batchedBridge = batchedBridgeValue.asObject(); m_callFunctionReturnFlushedQueueJS = batchedBridge.getProperty("callFunctionReturnFlushedQueue").asObject(); m_invokeCallbackAndReturnFlushedQueueJS = batchedBridge.getProperty("invokeCallbackAndReturnFlushedQueue").asObject(); m_flushedQueueJS = batchedBridge.getProperty("flushedQueue").asObject(); m_callFunctionReturnResultAndFlushedQueueJS = batchedBridge.getProperty("callFunctionReturnResultAndFlushedQueue").asObject(); }); } void JSCExecutor::callNativeModules(Value&& value) { SystraceSection s("JSCExecutor::callNativeModules"); // If this fails, you need to pass a fully functional delegate with a // module registry to the factory/ctor. CHECK(m_delegate) << "Attempting to use native modules without a delegate"; try { auto calls = value.toJSONString(); m_delegate->callNativeModules(*this, folly::parseJson(calls), true); } catch (...) { std::string message = "Error in callNativeModules()"; try { message += ":" + value.toString().str(); } catch (...) { // ignored } std::throw_with_nested(std::runtime_error(message)); } } void JSCExecutor::flush() { SystraceSection s("JSCExecutor::flush"); if (m_flushedQueueJS) { callNativeModules(m_flushedQueueJS->callAsFunction({})); return; } // When a native module is called from JS, BatchedBridge.enqueueNativeCall() // is invoked. For that to work, require('BatchedBridge') has to be called, // and when that happens, __fbBatchedBridge is set as a side effect. auto global = Object::getGlobalObject(m_context); auto batchedBridgeValue = global.getProperty("__fbBatchedBridge"); // So here, if __fbBatchedBridge doesn't exist, then we know no native calls // have happened, and we were able to determine this without forcing // BatchedBridge to be loaded as a side effect. if (!batchedBridgeValue.isUndefined()) { // If calls were made, we bind to the JS bridge methods, and use them to // get the pending queue of native calls. bindBridge(); callNativeModules(m_flushedQueueJS->callAsFunction({})); } else if (m_delegate) { // If we have a delegate, we need to call it; we pass a null list to // callNativeModules, since we know there are no native calls, without // calling into JS again. If no calls were made and there's no delegate, // nothing happens, which is correct. callNativeModules(Value::makeNull(m_context)); } } void JSCExecutor::callFunction(const std::string& moduleId, const std::string& methodId, const folly::dynamic& arguments) { SystraceSection s("JSCExecutor::callFunction"); // This weird pattern is because Value is not default constructible. // The lambda is inlined, so there's no overhead. auto result = [&] { JSContextLock lock(m_context); try { if (!m_callFunctionReturnResultAndFlushedQueueJS) { bindBridge(); } return m_callFunctionReturnFlushedQueueJS->callAsFunction({ Value(m_context, String::createExpectingAscii(m_context, moduleId)), Value(m_context, String::createExpectingAscii(m_context, methodId)), Value::fromDynamic(m_context, std::move(arguments)) }); } catch (...) { std::throw_with_nested( std::runtime_error("Error calling " + moduleId + "." + methodId)); } }(); callNativeModules(std::move(result)); } void JSCExecutor::invokeCallback(const double callbackId, const folly::dynamic& arguments) { SystraceSection s("JSCExecutor::invokeCallback"); auto result = [&] { JSContextLock lock(m_context); try { if (!m_invokeCallbackAndReturnFlushedQueueJS) { bindBridge(); } return m_invokeCallbackAndReturnFlushedQueueJS->callAsFunction({ Value::makeNumber(m_context, callbackId), Value::fromDynamic(m_context, std::move(arguments)) }); } catch (...) { std::throw_with_nested( std::runtime_error(folly::to("Error invoking callback ", callbackId))); } }(); callNativeModules(std::move(result)); } Value JSCExecutor::callFunctionSyncWithValue( const std::string& module, const std::string& method, Value args) { SystraceSection s("JSCExecutor::callFunction"); Object result = [&] { JSContextLock lock(m_context); if (!m_callFunctionReturnResultAndFlushedQueueJS) { bindBridge(); } return m_callFunctionReturnResultAndFlushedQueueJS->callAsFunction({ Value(m_context, String::createExpectingAscii(m_context, module)), Value(m_context, String::createExpectingAscii(m_context, method)), std::move(args), }).asObject(); }(); Value length = result.getProperty("length"); if (!length.isNumber() || length.asInteger() != 2) { std::runtime_error("Return value of a callFunction must be an array of size 2"); } callNativeModules(result.getPropertyAtIndex(1)); return result.getPropertyAtIndex(0); } void JSCExecutor::setGlobalVariable(std::string propName, std::unique_ptr jsonValue) { try { SystraceSection s("JSCExecutor::setGlobalVariable", "propName", propName); auto valueToInject = Value::fromJSON(adoptString(std::move(jsonValue))); Object::getGlobalObject(m_context).setProperty(propName.c_str(), valueToInject); } catch (...) { std::throw_with_nested(std::runtime_error("Error setting global variable: " + propName)); } } String JSCExecutor::adoptString(std::unique_ptr script) { #if defined(WITH_FBJSCEXTENSIONS) const JSBigString* string = script.release(); auto jsString = JSStringCreateAdoptingExternal(string->c_str(), string->size(), (void*)string, [](void* s) { delete static_cast(s); }); return String::adopt(m_context, jsString); #else return script->isAscii() ? String::createExpectingAscii(m_context, script->c_str(), script->size()) : String(m_context, script->c_str()); #endif } void* JSCExecutor::getJavaScriptContext() { return m_context; } #ifdef WITH_JSC_MEMORY_PRESSURE void JSCExecutor::handleMemoryPressure(int pressureLevel) { JSHandleMemoryPressure(this, m_context, static_cast(pressureLevel)); } #endif void JSCExecutor::flushQueueImmediate(Value&& queue) { auto queueStr = queue.toJSONString(); m_delegate->callNativeModules(*this, folly::parseJson(queueStr), false); } void JSCExecutor::loadModule(uint32_t moduleId) { auto module = m_unbundle->getModule(moduleId); auto sourceUrl = String::createExpectingAscii(m_context, module.name); auto source = String::createExpectingAscii(m_context, module.code); evaluateScript(m_context, source, sourceUrl); } // Native JS hooks template void JSCExecutor::installNativeHook(const char* name) { installGlobalFunction(m_context, name, exceptionWrapMethod()); } JSValueRef JSCExecutor::getNativeModule(JSObjectRef object, JSStringRef propertyName) { if (JSC_JSStringIsEqualToUTF8CString(m_context, propertyName, "name")) { return Value(m_context, String(m_context, "NativeModules")); } return m_nativeModules.getModule(m_context, propertyName); } JSValueRef JSCExecutor::nativeRequire( size_t argumentCount, const JSValueRef arguments[]) { if (argumentCount != 1) { throw std::invalid_argument("Got wrong number of args"); } double moduleId = Value(m_context, arguments[0]).asNumber(); if (moduleId < 0) { throw std::invalid_argument(folly::to("Received invalid module ID: ", Value(m_context, arguments[0]).toString().str())); } ReactMarker::logMarker(ReactMarker::NATIVE_REQUIRE_START); loadModule(moduleId); ReactMarker::logMarker(ReactMarker::NATIVE_REQUIRE_STOP); return Value::makeUndefined(m_context); } JSValueRef JSCExecutor::nativeFlushQueueImmediate( size_t argumentCount, const JSValueRef arguments[]) { if (argumentCount != 1) { throw std::invalid_argument("Got wrong number of args"); } flushQueueImmediate(Value(m_context, arguments[0])); return Value::makeUndefined(m_context); } JSValueRef JSCExecutor::nativeCallSyncHook( size_t argumentCount, const JSValueRef arguments[]) { if (argumentCount != 3) { throw std::invalid_argument("Got wrong number of args"); } unsigned int moduleId = Value(m_context, arguments[0]).asUnsignedInteger(); unsigned int methodId = Value(m_context, arguments[1]).asUnsignedInteger(); folly::dynamic args = folly::parseJson(Value(m_context, arguments[2]).toJSONString()); if (!args.isArray()) { throw std::invalid_argument( folly::to("method parameters should be array, but are ", args.typeName())); } MethodCallResult result = m_delegate->callSerializableNativeHook( *this, moduleId, methodId, std::move(args)); if (!result.hasValue()) { return Value::makeUndefined(m_context); } return Value::fromDynamic(m_context, result.value()); } } }