Класс UnsupportedError

Класс UnsupportedError представляет собой ошибку, которая сигнализирует о том, что вызванная операция или метод не поддерживается текущим объектом. Обычно такая ошибка выбрасывается, когда реализация некоторого интерфейса намеренно оставляет часть методов нереализованными. Конструктор класса принимает в первый параметр сообщение об ошибке - строку, описывающую причину возникновения исключения. Объект UnsupportedError наследуется от класса Error и содержит свойство message, в котором хранится переданное сообщение.

Синтаксис

UnsupportedError(String message)

Пример

Давайте создадим объект ошибки и выведем её сообщение в консоль:

void main()
{
	UnsupportedError err = UnsupportedError('Operation is not supported');
	print(err.message);
}

Результат выполнения кода:

"Operation is not supported"

Пример

Давайте выбросим ошибку UnsupportedError внутри метода и перехватим её с помощью конструкции try-catch:

void check(int value)
{
	if (value < 0) {
		throw UnsupportedError('Negative values are not supported');
	}
	print(value);
}

void main()
{
	try {
		check(-1);
	} catch (e) {
		print(e);
	}
}

Результат выполнения кода:

"UnsupportedError: Negative values are not supported"

Пример

Давайте проверим, что объект UnsupportedError является экземпляром класса Error:

void main()
{
	UnsupportedError err = UnsupportedError('Not supported');
	print(err is Error);
}

Результат выполнения кода:

true

Смотрите также

ключевое слово throw,
которое выбрасывает исключение
конструкция try,
которая обрабатывает исключения
конструкция catch,
которая перехватывает исключение
класс UnimplementedError,
который сигнализирует о нереализованном методе