dart:core

Устаревший класс

Аннотация @Deprecated('expires when') отмечает функцию как устаревшую.

Аннотация @deprecated — это сокращение для устаревания до неопределённой "следующей версии" разработки.

Цель аннотации @Deprecated — проинформировать пользователей о функции, код которой необходимо изменить, даже если он сейчас работает корректно.

Устаревшая функция планируется к удалению в будущем, возможно, это указано в поле "expires" аннотации. Это означает, что устаревшая функция не должна использоваться, или код, использующий её, сломается в какой-то момент в будущем. Если в коде используется эта функция, этот код следует переписать, чтобы не использовать устаревшую функцию.

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

Аннотация @Deprecated применяется к библиотекам, объявлениям верхнего уровня (переменным, геттерам, сеттерам, функциям, классам и типам), объявлениям уровня класса (переменным, геттерам, сеттерам, методам, операторам или конструкторам, статическим или нет), именованным необязательным аргументам и необязательным позиционным параметрам.

Устаревание является транзитивным:

• Если библиотека устарела, то устарели и все её члены.
• Если класс устарел, то устарели и все его члены.
• Если переменная устарела, то устарели и её неявный геттер и сеттер.

Инструмент, обрабатывающий исходный код Dart, может сообщить о следующих случаях:

• код импортирует устаревшую библиотеку.
• код экспортирует устаревшую библиотеку или любой устаревший член не устаревшей библиотеки.
• код статически ссылается на устаревшее объявление.
• код динамически использует член объекта со статически известным типом, где член устарел в статическом типе объекта.
• код динамически вызывает метод с аргументом, где соответствующий необязательный параметр устарел в статическом типе объекта.

Если устаревшее использование находится внутри библиотеки, класса или метода, которые сами устарели, инструмент не должен беспокоить пользователя об этом. Ожидается, что устаревшая функция будет использовать другие устаревшие функции.

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

Deprecated(String expires)

const

Создаёт аннотацию устаревания, которая указывает на истечение срока действия аннотированной функции.

Свойства

expires → String

final

Описание того, когда планируется прекратить поддержку устаревшей функции.

hashCode → int

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

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

runtimeType → Type

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

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

Операторы

operator ==(other) → bool

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

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

Методы

toString() → String

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

noSuchMethod(Invocation invocation) → dynamic

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

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