// Copyright 2004-present Facebook. All Rights Reserved. #pragma once #include #include #include #include #include #include #include #include #include #include #include #include namespace folly { struct dynamic; } namespace facebook { namespace react { class ModuleRegistry; class JsToNativeBridge; struct InstanceCallback; // This class manages calls from native code to JS. It also manages // executors and their threads. All functions here can be called from // any thread. // // Except for loadApplicationScriptSync(), all void methods will queue // work to run on the jsQueue passed to the ctor, and return // immediately. class NativeToJsBridge { public: friend class JsToNativeBridge; /** * This must be called on the main JS thread. */ NativeToJsBridge( JSExecutorFactory* jsExecutorFactory, std::shared_ptr registry, std::shared_ptr jsQueue, std::shared_ptr callback); virtual ~NativeToJsBridge(); /** * Executes a function with the module ID and method ID and any additional * arguments in JS. */ void callFunction(std::string&& module, std::string&& method, folly::dynamic&& args); /** * Invokes a callback with the cbID, and optional additional arguments in JS. */ void invokeCallback(double callbackId, folly::dynamic&& args); /** * Executes a JS method on the given executor synchronously, returning its * return value. JSException will be thrown if JS throws an exception; * another standard exception may be thrown for C++ bridge failures, or if * the executor is not capable of synchronous calls. * * This method is experimental, and may be modified or removed. * * loadApplicationScriptSync() must be called and finished executing * before callFunctionSync(). */ template Value callFunctionSync(const std::string& module, const std::string& method, T&& args) { if (*m_destroyed) { throw std::logic_error( folly::to("Synchronous call to ", module, ".", method, " after bridge is destroyed")); } JSCExecutor *jscExecutor = dynamic_cast(m_executor.get()); if (!jscExecutor) { throw std::invalid_argument( folly::to("Executor type ", typeid(m_executor.get()).name(), " does not support synchronous calls")); } return jscExecutor->callFunctionSync(module, method, std::forward(args)); } /** * Starts the JS application. If unbundle is non-null, then it is * used to fetch JavaScript modules as individual scripts. * Otherwise, the script is assumed to include all the modules. */ void loadApplication( std::unique_ptr unbundle, std::unique_ptr startupCode, std::string sourceURL); void loadApplicationSync( std::unique_ptr unbundle, std::unique_ptr startupCode, std::string sourceURL); void setGlobalVariable(std::string propName, std::unique_ptr jsonValue); void* getJavaScriptContext(); bool supportsProfiling(); void startProfiler(const std::string& title); void stopProfiler(const std::string& title, const std::string& filename); void handleMemoryPressureUiHidden(); void handleMemoryPressureModerate(); void handleMemoryPressureCritical(); /** * Synchronously tears down the bridge and the main executor. */ void destroy(); private: void runOnExecutorQueue(std::function task); // This is used to avoid a race condition where a proxyCallback gets queued // after ~NativeToJsBridge(), on the same thread. In that case, the callback // will try to run the task on m_callback which will have been destroyed // within ~NativeToJsBridge(), thus causing a SIGSEGV. std::shared_ptr m_destroyed; std::shared_ptr m_delegate; std::unique_ptr m_executor; std::shared_ptr m_executorMessageQueueThread; #ifdef WITH_FBSYSTRACE std::atomic_uint_least32_t m_systraceCookie = ATOMIC_VAR_INIT(); #endif }; } }