dart:core

Класс ArgumentError

Ошибка, возникающая при передаче функции недопустимого аргумента.

Метод должен документировать ограничения на принимаемые аргументы, например, если целочисленный аргумент не должен допускать null, строковый аргумент должен быть непустым или аргумент типа dynamic фактически должен иметь один из нескольких допустимых типов.

Пользователь должен иметь возможность предсказать, какие аргументы вызовут ошибку, и избегать вызова метода с такими аргументами.

Почти всегда полезно включить недопустимое значение в описание ошибки, чтобы помочь пользователю понять, что пошло не так, поэтому конструктор ArgumentError.value является предпочтительным. Используйте ArgumentError.new только тогда, когда по какой-либо причине невозможно предоставить значение.

Наследование

• Object
• Error
• ArgumentError

Реализующие классы

• IndexError
• RangeError

Конструкторы

ArgumentError([dynamic message, @Since("2.14") String? name])

Создает ошибку с сообщением, описывающим проблему с аргументом.

ArgumentError.notNull([String? name])

Создает ошибку аргумента для аргумента null, который не должен быть null.

ArgumentError.value(dynamic value, [String? name, dynamic message])

Создает ошибку, содержащую недопустимое значение value.

Свойства

hashCode → int

только для чтенияунаследовано

Хеш-код этого объекта.

invalidValue → dynamic

неизменяемое

Недопустимое значение.

message → dynamic

неизменяемое

Сообщение, описывающее проблему.

name → String?

неизменяемое

Имя недопустимого аргумента, если оно доступно.

runtimeType → Type

только для чтенияунаследовано

Представление типа объекта во время выполнения.

stackTrace → StackTrace?

только для чтенияунаследовано

Трассировка стека в момент первого возникновения этой ошибки.

Методы

noSuchMethod(Invocation invocation) → dynamic

унаследовано

Вызывается при обращении к несуществующему методу или свойству.

toString() → String

переопределен

Строковое представление этого объекта.

Операторы

operator ==(Object other) → bool

унаследовано

Оператор равенства.

Статические методы

checkNotNull<@Since("2.8") T>(T? argument, [String? name]) → T

Вызывает исключение, если argument является null.