DiagnosticsBlock class Null safety

DiagnosticsNode that exists mainly to provide a container for other diagnostics that typically lacks a meaningful value of its own.

This class is typically used for displaying complex nested error messages.



DiagnosticsBlock({String? name, DiagnosticsTreeStyle style = DiagnosticsTreeStyle.whitespace, bool showName = true, bool showSeparator = true, String? linePrefix, Object? value, String? description, DiagnosticLevel level = DiagnosticLevel.info, bool allowTruncate = false, List<DiagnosticsNode> children = const <DiagnosticsNode>[], List<DiagnosticsNode> properties = const <DiagnosticsNode>[]})
Creates a diagnostic with properties specified by properties and children specified by children.


allowNameWrap bool
Whether to wrap the name onto multiple lines or not.
read-only, inherited
allowTruncate bool
Whether to allow truncation when displaying the node and its children.
allowWrap bool
Whether to wrap text on onto multiple lines or not.
read-only, inherited
emptyBodyDescription String?
Description to show if the node has no displayed properties or children.
read-only, inherited
hashCode int
The hash code for this object.
read-only, inherited
level DiagnosticLevel
Priority level of the diagnostic used to control which diagnostics should be shown and filtered.
linePrefix String?
Prefix to include at the start of each line.
final, inherited
name String?
Label describing the DiagnosticsNode, typically shown before a separator (see showSeparator).
final, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited
showName bool
Whether the name of the property should be shown when showing the default view of the tree.
final, inherited
showSeparator bool
Whether to show a separator between name and description.
final, inherited
style DiagnosticsTreeStyle?
Hint for how the node should be displayed.
final, inherited
textTreeConfiguration TextTreeConfiguration?
Returns a configuration specifying how this object should be rendered as text art.
@protected, read-only, inherited
value Object?
The actual object this is diagnostics data for.


getChildren() List<DiagnosticsNode>
Children of this DiagnosticsNode.
getProperties() List<DiagnosticsNode>
Properties of this DiagnosticsNode.
isFiltered(DiagnosticLevel minLevel) bool
Whether the diagnostic should be filtered due to its level being lower than minLevel.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed.
toDescription({TextTreeConfiguration? parentConfiguration}) String
Returns a description with a short summary of the node itself not including children or properties.
toJsonMap(DiagnosticsSerializationDelegate delegate) Map<String, Object?>
Serialize the node to a JSON map according to the configuration provided in the DiagnosticsSerializationDelegate.
@mustCallSuper, inherited
toString({TextTreeConfiguration? parentConfiguration, DiagnosticLevel minLevel = DiagnosticLevel.info}) String
Returns a string representation of this diagnostic that is compatible with the style of the parent if the node is not the root.
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, TextTreeConfiguration? parentConfiguration, DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a string representation of this node and its descendants.
toTimelineArguments() Map<String, String>?
Converts the properties (getProperties) of this node to a form useful for Timeline event arguments (as in Timeline.startSync).


operator ==(Object other) bool
The equality operator.