expo-error-recovery/src/ErrorRecovery.ts

Utilities for helping you gracefully handle crashes due to fatal JavaScript errors.

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

/** @deprecated This package only works with the deprecated classic Expo build service. */
export const recoveredProps = _getRecoveredProps();

/** @deprecated This package only works with the deprecated classic Expo build service. */
export type ErrorRecoveryProps = Record<string, any>;

// @needsAudit
/**
 * @deprecated This package only works with the deprecated classic Expo build service.
 *
 * 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;
}