/*
 * Copyright (c) Meta Platforms, Inc. and affiliates.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

package com.facebook.react.bridge

/**
 * Interface for a class that knows how to handle an Exception invoked from JS. Since these
 * Exceptions are triggered by JS calls (and can be fixed in JS), a common way to handle one is to
 * show a error dialog and allow the developer to change and reload JS.
 *
 * We should also note that we have a unique stance on what 'caused' means: even if there's a bug in
 * the framework/native code, it was triggered by JS and theoretically since we were able to set up
 * the React Instance, JS could change its logic, reload, and not trigger that crash.
 */
public fun interface JSExceptionHandler {
  /** Do something to display or log the exception. */
  public fun handleException(e: Exception)
}