Thread.UncaughtExceptionHandler (Java Platform SE 8 )
Keywords: java.lang.Thread.UncaughtExceptionHandler interface
Date: 2026-04-17

compact1, compact2, compact3
java.lang

## Interface Thread.UncaughtExceptionHandler

- All Known Implementing Classes:
    ThreadGroup
  Enclosing class:
    Thread
  Functional Interface:
    This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

      @FunctionalInterface
      public static interface Thread.UncaughtExceptionHandler

  Interface for handlers invoked when a `Thread` abruptly terminates due to an uncaught exception.

  When a thread is about to terminate due to an uncaught exception the Java Virtual Machine will query the thread for its `UncaughtExceptionHandler` using `Thread.getUncaughtExceptionHandler()` and will invoke the handler's `uncaughtException` method, passing the thread and the exception as arguments. If a thread has not had its `UncaughtExceptionHandler` explicitly set, then its `ThreadGroup` object acts as its `UncaughtExceptionHandler`. If the `ThreadGroup` object has no special requirements for dealing with the exception, it can forward the invocation to the default uncaught exception handler.

  Since:
    1.5
  See Also:
    `Thread.setDefaultUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler)`, `Thread.setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler)`, `ThreadGroup.uncaughtException(java.lang.Thread, java.lang.Throwable)`

- - ### Method Summary

    All Methods Instance Methods Abstract Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `uncaughtException(Thread t, Throwable e)` Method invoked when the given thread terminates due to the given uncaught exception.

- - ### Method Detail

    - #### uncaughtException

          void uncaughtException(Thread t,
                                 Throwable e)

      Method invoked when the given thread terminates due to the given uncaught exception.

      Any exception thrown by this method will be ignored by the Java Virtual Machine.

      Parameters:
        `t` - the thread
        `e` - the exception

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.