Added in API level 1

Error

open class Error : Throwable

kotlin.Any
↳	kotlin.Throwable
	↳	java.lang.Error

Known Direct Subclasses AnnotationFormatError, AssertionError, AssertionFailedError, CoderMalfunctionError, FactoryConfigurationError, IOError, LinkageError, ServiceConfigurationError, ThreadDeath, TransformerFactoryConfigurationError, VirtualMachineError AnnotationFormatError Thrown when the annotation parser attempts to read an annotation from a class file and determines that the annotation is malformed. AssertionError Thrown to indicate that an assertion has failed. AssertionFailedError Thrown when an assertion failed. CoderMalfunctionError Error thrown when the decodeLoop method of a CharsetDecoder, or the encodeLoop method of a CharsetEncoder, throws an unexpected exception. FactoryConfigurationError Thrown when a problem with configuration with the Parser Factories exists. IOError Thrown when a serious I/O error has occurred. LinkageError Subclasses of LinkageError indicate that a class has some dependency on another class; however, the latter class has incompatibly changed after the compilation of the former class. ServiceConfigurationError Error thrown when something goes wrong while locating, loading, or instantiating a service provider. ThreadDeath An instance of ThreadDeath is thrown in the victim thread when the (deprecated) Thread#stop() method is invoked. TransformerFactoryConfigurationError Thrown when a problem with configuration with the Transformer Factories exists. VirtualMachineError Thrown to indicate that the Java Virtual Machine is broken or has run out of resources necessary for it to continue operating.

Known Indirect Subclasses AbstractMethodError, BootstrapMethodError, ClassCircularityError, ClassFormatError, ComparisonFailure, ExceptionInInitializerError, GenericSignatureFormatError, IllegalAccessError, IncompatibleClassChangeError, InstantiationError, InternalError, NoClassDefFoundError, and 9 others. AbstractMethodError Thrown when an application tries to call an abstract method. BootstrapMethodError Thrown to indicate that an invokedynamic instruction or a dynamic constant failed to resolve its bootstrap method and arguments, or for invokedynamic instruction the bootstrap method has failed to provide a call site with a target of the correct method type, or for a dynamic constant the bootstrap method has failed to provide a constant value of the required type. ClassCircularityError Thrown when the Java Virtual Machine detects a circularity in the superclass hierarchy of a class being loaded. ClassFormatError Thrown when the Java Virtual Machine attempts to read a class file and determines that the file is malformed or otherwise cannot be interpreted as a class file. ComparisonFailure Thrown when an assert equals for Strings failed. ExceptionInInitializerError Signals that an unexpected exception has occurred in a static initializer. GenericSignatureFormatError Thrown when a syntactically malformed signature attribute is encountered by a reflective method that needs to interpret the generic signature information for a type, method or constructor. IllegalAccessError Thrown if an application attempts to access or modify a field, or to call a method that it does not have access to. IncompatibleClassChangeError Thrown when an incompatible class change has occurred to some class definition. InstantiationError Thrown when an application tries to use the Java new construct to instantiate an abstract class or an interface. InternalError Thrown to indicate some unexpected internal error has occurred in the Java Virtual Machine. NoClassDefFoundError Thrown if the Java Virtual Machine or a ClassLoader instance tries to load in the definition of a class (as part of a normal method call or as part of creating a new instance using the new expression) and no definition of the class could be found. NoSuchFieldError Thrown if an application tries to access or modify a specified field of an object, and that object no longer has that field. NoSuchMethodError Thrown if an application tries to call a specified method of a class (either static or instance), and that class no longer has a definition of that method. OutOfMemoryError Thrown when the Java Virtual Machine cannot allocate an object because it is out of memory, and no more memory could be made available by the garbage collector. StackOverflowError Thrown when a stack overflow occurs because an application recurses too deeply. UnknownError Thrown when an unknown but serious exception has occurred in the Java Virtual Machine. UnsatisfiedLinkError Thrown if the Java Virtual Machine cannot find an appropriate native-language definition of a method declared native. UnsupportedClassVersionError Thrown when the Java Virtual Machine attempts to read a class file and determines that the major and minor version numbers in the file are not supported. VerifyError Thrown when the "verifier" detects that a class file, though well formed, contains some sort of internal inconsistency or security problem. ZipError Signals that an unrecoverable error has occurred.

An Error is a subclass of Throwable that indicates serious problems that a reasonable application should not try to catch. Most such errors are abnormal conditions. The ThreadDeath error, though a "normal" condition, is also a subclass of Error because most applications should not try to catch it.

A method is not required to declare in its throws clause any subclasses of Error that might be thrown during the execution of the method but not caught, since these errors are abnormal conditions that should never occur. That is, Error and its subclasses are regarded as unchecked exceptions for the purposes of compile-time checking of exceptions.

Summary

Public constructors
Error() Constructs a new error with null as its detail message.
Error(message: String!) Constructs a new error with the specified detail message.
Error(message: String!, cause: Throwable!) Constructs a new error with the specified detail message and cause.
Error(cause: Throwable!) Constructs a new error with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause).

Protected constructors
Error(message: String!, cause: Throwable!, enableSuppression: Boolean, writableStackTrace: Boolean) Constructs a new error with the specified detail message, cause, suppression enabled or disabled, and writable stack trace enabled or disabled.

Public constructors

Error

Added in API level 1

Error()

Constructs a new error with null as its detail message. The cause is not initialized, and may subsequently be initialized by a call to initCause.

Error

Added in API level 1

Error(message: String!)

Constructs a new error with the specified detail message. The cause is not initialized, and may subsequently be initialized by a call to initCause.

Parameters
message	String!: the detail message. The detail message is saved for later retrieval by the getMessage() method.

Error

Added in API level 1

Error(
    message: String!, 
    cause: Throwable!)

Constructs a new error with the specified detail message and cause.

Note that the detail message associated with cause is not automatically incorporated in this error's detail message.

Parameters
message	String!: the detail message (which is saved for later retrieval by the getMessage() method).
cause	Throwable!: the cause (which is saved for later retrieval by the getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

Error

Added in API level 1

Error(cause: Throwable!)

Constructs a new error with the specified cause and a detail message of (cause==null ? null : cause.toString()) (which typically contains the class and detail message of cause). This constructor is useful for errors that are little more than wrappers for other throwables.

Parameters
cause	Throwable!: the cause (which is saved for later retrieval by the getCause() method). (A null value is permitted, and indicates that the cause is nonexistent or unknown.)

Protected constructors

Error

Added in API level 24

protected Error(
    message: String!, 
    cause: Throwable!, 
    enableSuppression: Boolean, 
    writableStackTrace: Boolean)

Constructs a new error with the specified detail message, cause, suppression enabled or disabled, and writable stack trace enabled or disabled.

Parameters
message	String!: the detail message.
cause	Throwable!: the cause. (A null value is permitted, and indicates that the cause is nonexistent or unknown.)
enableSuppression	Boolean: whether or not suppression is enabled or disabled
writableStackTrace	Boolean: whether or not the stack trace should be writable