Библиотека dart:developer

Взаимодействие со средствами разработки, такими как отладчик и инспектор.

Библиотека dart:developer нестабильна, и её API может незначительно меняться в результате отзывов разработчиков. Эта библиотека зависит от платформы и поэтому имеет реализации как для dart2js, так и для Dart VM. Обе находятся в разработке и могут не поддерживать все операции.

Чтобы использовать эту библиотеку в вашем коде:

import 'dart:developer';

Типы данных

ServiceExtensionHandler(String метод, Map<String, String> параметры) → Future<ServiceExtensionResponse>

Обработчик расширений протокола сервиса. Регистрируется с помощью registerExtension.

TimelineAsyncFunction() → Future

TimelineSyncFunction() → dynamic

Функции

debugger({bool когда: true, String сообщение }) → bool

Если when равно true, останавливает программу так, как будто была достигнута точка останова в следующей строке.

getCurrentTag() → UserTag

Возвращает текущую метку пользователя UserTag для изолята.

inspect(Object объект) → Object

Отправляет ссылку на object всем подключенным отладчикам.

log(String сообщение, { DateTime время, int номерПоследовательности, int уровень: 0, String имя: '', Zone зона, Object ошибка, StackTrace стекВызовов }) → void

Выводит событие журнала. message — это сообщение журнала. time (необязательно) — метка времени. sequenceNumber (необязательно) — монотонно возрастающий номер последовательности. level (необязательно) — уровень серьезности (значение от 0 до 2000). name (необязательно) — имя источника сообщения журнала. zone (необязательно) — зона, в которой было выведено сообщение журнала. error (необязательно) — объект ошибки, связанный с этим событием журнала. stackTrace (необязательно) — стек вызовов, связанный с этим событием журнала.

postEvent(String видСобытия, Map данныеСобытия) → void

Отправляет событие eventKind с полезной нагрузкой eventData в поток событий Extension.

registerExtension(String метод, ServiceExtensionHandler обработчик) → void

Регистрирует ServiceExtensionHandler, который будет вызываться в этом изоляте для method. ПРИМЕЧАНИЕ: расширения протокола сервиса должны регистрироваться в каждом изоляте.

Классы

Counter

Изменяемое значение. Начальное значение равно 0,0.

Gauge

Измеренное значение с минимальным и максимальным значениями. Начальное значение равно min. Значение будет ограничено интервалом min, max.

Metric

Абстрактный класс Metric. Имена метрик должны быть уникальными, иерархическими и использовать точки в качестве разделителей. Например, 'a.b.c'. Уникальность обеспечивается только при регистрации метрики. Имя метрики не может содержать символ косой черты ('/') .

Metrics

Service

Доступ к информации о протоколе сервиса и управление веб-сервером, предоставляющим доступ к службам, предоставляемым Dart VM для отладки и инспектирования Dart-программ.

ServiceExtensionResponse

Ответ на RPC расширения протокола сервиса.

ServiceProtocolInfo

Протокол сервиса — это протокол, который клиент, например, observatory, может использовать для доступа к службам, предоставляемым Dart VM для отладки и инспектирования Dart-программ. Этот класс инкапсулирует номер версии и URI для доступа к этому сервису.

Timeline

Добавление в хронологию.

TimelineTask

Асинхронная задача в хронологии. Асинхронная задача может иметь множество (вложенных) синхронных операций. Синхронные операции могут существовать дольше, чем текущее событие изолята. Чтобы передать TimelineTask в другой изолят, сначала необходимо вызвать pass, чтобы получить идентификатор задачи, а затем создать новый TimelineTask в другом изоляте.

UserTag

Метка пользователя UserTag может использоваться для группировки выборок в профилировщике Observatory.