expo-error-recovery/src/ErrorRecovery.ts

import { setRecoveryPropsToSave } from './ErroRecoveryStore';
import ExpoErrorRecovery from './ExpoErrorRecovery';
import './ErrorRecovery.fx';

// @docsMissing
export const recoveredProps = _getRecoveredProps();

// @docsMissing
export type ErrorRecoveryProps = Record<string, any>;

// @needsAudit
/**
 * Set arbitrary error recovery props. If your project crashes in production as a result of a fatal
 * JS error, Expo will reload your project. If you've set these props, they'll be passed to your
 * reloaded project's initial props under `exp.errorRecovery`. Access to `localStorage` is required
 * on web, or else this will simply be a no-op.
 *
 * [Read more about error handling with Expo](/guides/errors).
 * @param props An object which will be passed to your reloaded project's initial props if the
 * project was reloaded as a result of a fatal JS error.
 */
export function setRecoveryProps(props: ErrorRecoveryProps): void {
  setRecoveryPropsToSave(props);
}

function _getRecoveredProps(): ErrorRecoveryProps | null {
  if (ExpoErrorRecovery.recoveredProps) {
    return JSON.parse(ExpoErrorRecovery.recoveredProps);
  }
  return null;
}