Investigate widget state and navigation in your running app
Find Flutter widgets, inspect their diagnostics, and examine observed routes to understand the UI your app is displaying.
Flutter Inspection tools help explain a screen by finding mounted widgets, inspecting their diagnostics, and checking routes observed by your navigation observer. Use them when you need framework-level detail about the current UI.
Flutter instrumentation registers these read tools by default:
Tree responses use the shared compact visual-tree v2 contract. Resolve widget types through the top-level types registry and node typeId; stable string ValueKey values are exposed as automationId when available.
| Id | Purpose |
|---|---|
flutter.get_widget_tree | Return mounted elements, widget types, render-object types, keys, bounds, and child ids. |
flutter.inspect_widget | Return diagnostics and debug properties for one captured widget id. |
flutter.find_widgets | Search mounted widgets by type, key, text, or other captured values. |
flutter.get_navigation_state | Return routes observed by AnsightNavigatorObserver. |
await AnsightFlutterInstrumentation.instance.install(
registerWidgetTools: true,
);flutter.get_widget_tree accepts maxDepth and maxNodes. Node ids are capture-oriented and should be refreshed when the widget tree changes.
Set registerWidgetTools: false when the workflow needs telemetry without framework UI inspection.