Class: Toybox.Lang.Exception

Inherits:

Toybox.Lang.Object

• Toybox.Lang.Object
• Toybox.Lang.Exception

Overview

Exception is a class that represents a thrown Exception. Custom exceptions can be created by extending this class.

Example:

Creating and throwing a new Exception class

import Toybox.Lang;
var myVar;

class myException extends Exception {
    function initialize() {
        Exception.initialize();
    }
}

if (myVar == false) {
    throw new myException();
}

Example:

Handling an Exception in a try-catch block

import Toybox.Lang;
import Toybox.System;
try {
    // Do something here
} catch (e instanceof Exception) {
    System.println(e.getErrorMessage());
}

Since:

API Level 1.0.0

Direct Known Subclasses

Ant.EncryptionInvalidSettingsException, Ant.UnableToAcquireChannelException, Ant.UnableToAcquireEncryptedChannelException, AntPlus.AntPlusNotAllowedException, Application.ObjectStoreAccessException, Properties.InvalidKeyException, Attention.BacklightOnTooLongException, Capture.InitializationFailedException, Background.ExitDataSizeLimitException, Background.InvalidBackgroundTimeException, Background.MessageSizeLimitException, BluetoothLowEnergy.DevicePairException, BluetoothLowEnergy.InvalidRequestException, BluetoothLowEnergy.ProfileRegistrationException, BluetoothLowEnergy.UuidFormatException, Complications.ComplicationNotFoundException, Cryptography.InvalidBlockSizeException, Graphics.InvalidBitmapResourceException, Graphics.InvalidPaletteException, Graphics.OutOfGraphicsMemoryException, Lang.InvalidOptionsException, Lang.InvalidValueException, Lang.OperationNotAllowedException, Lang.SerializationException, Lang.StorageFullException, Lang.SymbolNotAllowedException, Lang.UnexpectedTypeException, Lang.ValueOutOfBoundsException, Sensor.TooManySensorDataListenersException, StringUtil.InvalidHexStringException, System.AppNotInstalledException, System.PreviousOperationNotCompleteException, System.UnexpectedAppTypeException, Test.AssertException, Time.RealTimeClockNotValidException, WatchUi.InvalidMenuItemTypeException, WatchUi.InvalidPointException, WatchUi.InvalidSelectableStateException

Instance Method Summary

• getErrorMessage() as Lang.String or Null

  Get the error message for the Exception.

• initialize()

  Exception constructor.

• printStackTrace() as Void

  Print the stack trace of the thrown Exception.

Instance Method Details

getErrorMessage() as Lang.String or Null

Get the error message for the Exception.

Returns:

• Lang.String —

  The Exception's error message, or null if no message is given

Since:

API Level 1.2.0

initialize()

Exception constructor.

Since:

API Level 1.1.2

printStackTrace() as Void

Print the stack trace of the thrown Exception.

Since:

API Level 1.1.2