xref: /expo/packages/expo-modules-core/build/requireNativeModule.js (revision 5585864b)

import NativeModulesProxy from './NativeModulesProxy';
/**
 * Imports the native module registered with given name. In the first place it tries to load
 * the module installed through the JSI host object and then falls back to the bridge proxy module.
 * Notice that the modules loaded from the proxy may not support some features like synchronous functions.
 *
 * @param moduleName Name of the requested native module.
 * @returns Object representing the native module.
 * @throws Error when there is no native module with given name.
 */
export function requireNativeModule(moduleName) {
    const nativeModule = requireOptionalNativeModule(moduleName);
    if (!nativeModule) {
        throw new Error(`Cannot find native module '${moduleName}'`);
    }
    return nativeModule;
}
/**
 * Imports the native module registered with the given name. The same as `requireNativeModule`,
 * but returns `null` when the module cannot be found instead of throwing an error.
 *
 * @param moduleName Name of the requested native module.
 * @returns Object representing the native module or `null` when it cannot be found.
 */
export function requireOptionalNativeModule(moduleName) {
    return (globalThis.expo?.modules?.[moduleName] ??
        globalThis.ExpoModules?.[moduleName] ??
        NativeModulesProxy[moduleName] ??
        null);
}
//# sourceMappingURL=requireNativeModule.js.map