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

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

Эта библиотека зависит от платформы и имеет отдельные реализации для веб-платформы и виртуальной машины Dart. Конкретная платформа может не поддерживать все операции.

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

import 'dart:developer';

Классы

Counter

Изменяющееся значение. Начальное значение — 0.0.

Flow

Класс для представления событий Flow.

Gauge

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

Metric

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

Metrics

Регистрация и отмена регистрации пользовательских метрик Metric для отображения в инструментах разработчика.

Service

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

ServiceExtensionResponse

Ответ на RPC-вызов расширения протокола службы.

ServiceProtocolInfo

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

Timeline

Добавление записи на временную шкалу.

TimelineTask

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

UserTag

UserTag можно использовать для группировки образцов в профилировщике ЦП DevTools.

Свойства

extensionStreamHasListener → bool

только для чтения

Есть ли в данный момент хотя бы один слушатель у потока «Extension».

reachabilityBarrier → int

только для чтения

Текущее состояние барьера достижимости.

Функции

debugger({bool when = true, String? message}) → bool

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

getCurrentTag() → UserTag

Возвращает текущий UserTag для изолята.

inspect(Object? object) → Object?

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

log(String message, {DateTime? time, int? sequenceNumber, int level = 0, String name = '', Zone? zone, Object? error, StackTrace? stackTrace}) → void

Создает событие журнала.

postEvent(String eventKind, Map eventData) → void

Отправляет событие типа eventKind с данными eventData в поток событий «Extension».

registerExtension(String method, ServiceExtensionHandler handler) → void

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

Псевдонимы типов

ServiceExtensionHandler = Future<ServiceExtensionResponse> Function(String method, Map<String, String> parameters)

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

TimelineAsyncFunction = Future Function()

TimelineSyncFunction<T> = T Function()

Псевдоним типа для аргумента-функции метода Timeline.timeSync.