You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 445934c
Browse filesBrowse the repository at this point in the historyBrowse files
fix(components): point recording hints at record-change-detection and wait for the page
#433 moved `record` from `change-detection` to `record-change-detection`
and refuses the old argument, but several answers still told agents to
call `change-detection` with `record: "start"`, and the recording tool
pointed back at itself. Every hint and the docs now name the right tool,
and a test keeps the old wording out.
The panel announced "Recording started." as soon as the request reached
the server, and a stop that got no report still announced a total. It
now waits for the page to report that recording is on or off, and says
the page did not confirm when no report comes within 3 seconds.
Refs #366
Copy file name to clipboardExpand all lines: apps/docs/src/content/guides/inspect-fix-verify.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -57,7 +57,7 @@ Call `list-pages`. If more than one tab reports, pass its id as `page` to every
57
57
The audit reads what the inspectors already hold. Errors, hydration, router, form and HTTP findings are there as soon as the page reports. Change detection numbers need a recording:
Then use the app: open the screens and click what the change is about. Subscriptions after destroy need tracking, so call `track-subscriptions` with `action: "start"` too if leaks matter to the change.
@@ -104,7 +104,7 @@ Call `open-in-panel` with `tab: "audit"` to give the user a link to the same lis
With <code>agent.readOnly</code>, <code>audit</code> has no <code>axe</code> argument and <code>change-detection</code> can't record. Run axe and the recording from the panel, and the agent's audit reads them.
107
+
With <code>agent.readOnly</code>, <code>audit</code> has no <code>axe</code> argument and <code>record-change-detection</code> is not registered. Run axe and the recording from the panel, and the agent's audit reads them.
108
108
</ngmd-callout>
109
109
110
110
- Findings are matched by area, rule and subject, not by position. A renamed component or route counts as one finding resolved and one new.
Copy file name to clipboardExpand all lines: apps/docs/src/content/inspectors/components.md
+13-2Lines changed: 13 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -143,7 +143,18 @@ Set [`actions.components`](../getting-started/configuration.md#actions) to `fals
143
143
144
144
When the page renders `@defer` blocks, a **Defer blocks** list follows the tree. Each row shows the component whose template holds the block, its state (`placeholder`, `loading`, `complete` or `error`) and its triggers. With [incremental hydration](https://angular.dev/guide/incremental-hydration), a row also shows `dehydrated` or `hydrated`, and a **hydrate never** flag marks a block that stays as server HTML.
145
145
146
-
Hover or focus a row to highlight the block in the page. Click it to select the component that holds it. The list is hidden when the page renders no defer blocks, or when its Angular version has no util to read them.
146
+
A row also carries the notes the [`defer-blocks`](../agents/tools.md#defer-blocks) tool prints. Hover a note to read it in full.
|**stuck**_N_ s | The block has been on its placeholder for 10 seconds or more. |
152
+
|**waiting**_N_ s | The same, for a block whose triggers only wait for the user (`on viewport`, `on interaction` or `on hover`). |
153
+
|**@error block**| The block has an `@error` block. |
154
+
155
+
When the block sets times, the row lists them, such as `placeholder min 500ms · loading after 100ms, min 1s`. Ages are counted on the page's clock, so a page on another device with its clock set wrong still shows the right age.
156
+
157
+
Hover or focus a row to highlight the block in the page. A block with several root elements gets one box around all of them. Click it to select the component that holds it. The list is hidden when the page renders no defer blocks, or when its Angular version has no util to read them.
147
158
148
159
The list holds the first 500 blocks of a page. When the page has more, the count reads **500+**.
149
160
@@ -178,7 +189,7 @@ The list needs Angular 22.0 or later in a development build. On an older Angular
178
189
179
190
### Change detection
180
191
181
-
Below the tree and the defer blocks, the **Change detection** section records change detection cycles with Angular's profiler. Click **Record**, use the app, then click **Stop recording**. A check is a component whose template Angular ran. A clean OnPush component that Angular only walked past is not a check, and neither is the second pass that development builds run to catch `ExpressionChangedAfterItHasBeenChecked` errors. The flash overlay and the Performance panel track count the same way. **Clear** empties the recording. Each new recording starts empty, but a start sent while the page records, such as an agent's `record: "start"`, keeps the cycles recorded so far.
192
+
Below the tree and the defer blocks, the **Change detection** section records change detection cycles with Angular's profiler. Click **Record**, use the app, then click **Stop recording**. A check is a component whose template Angular ran. A clean OnPush component that Angular only walked past is not a check, and neither is the second pass that development builds run to catch `ExpressionChangedAfterItHasBeenChecked` errors. The flash overlay and the Performance panel track count the same way. **Clear** empties the recording. Each new recording starts empty, but a start sent while the page records, such as an agent's `record-change-detection` call with `record: "start"`, keeps the cycles recorded so far. **Record** and **Stop recording** wait up to 3 seconds for the page to report the recording on or off before they announce it. If no report comes, the status says the page did not confirm, and the button keeps the state the page last reported.
182
193
183
194
-**Cycles**: a bar chart with one bar per recorded cycle, its height the cycle's duration. A line marks the 16.6 ms frame budget (one frame at 60 frames per second). A cycle over the budget has a striped bar, a triangle under it, and says "over budget" in its tooltip and in the table. Hover or focus a bar to see the cycle number, duration, output trigger, checks and its three slowest components.
184
195
-**Spans in the picked cycles**: when the page reports timed spans, a flame graph of the picked cycles. Time runs left to right, cycle after cycle with the idle time between them left out, and a span nested in another sits one row lower. Each span is a component check (solid), a lifecycle hook (stripes), an `afterRender` callback (dots) or the output listener that triggered the cycle (lines, drawn before the cycle's start), with a key under the graph. Hover or focus a span to read its total and self time. The arrow keys move along a row, **Up** goes to the enclosing span and **Down** to the first nested one. **Enter** or a click on a component, hook or output selects that component in the tree. **Show the spans as a table** lists the same spans. The graph shows at most 30 cycles; pick a smaller range when more are picked.
- Fixes from the audit of every inspector, the panel shell, the hub, the extension and the native overlays (#361, #362, #363, #364), the follow-ups in #418, and the release blockers found by the test campaign (#432).
186
186
- One malformed component report no longer breaks the agent tools for every page. Reports are checked when they reach the server.
187
187
- Change detection counts only template runs, not skipped children or the `checkNoChanges` pass.
188
+
- The change detection answers with no recording, the audit note and the `record-change-detection` result send agents to `record-change-detection`, not to `change-detection` with `record`, which that tool refuses.
189
+
- The panel announces **Record** and **Stop recording** once the page reports the recording on or off. If no report comes within 3 seconds, it says the page did not confirm and keeps the button state the page last reported.
188
190
- The forms tools answer with the forms of the tab they were asked about.
189
191
- Signal graph edges name their nodes instead of positions.
192
+
-`inspect-signals` reads the graph of a component the page is not showing: a `component` the component tree knows, or a component host matched by the new `selector` argument (CSS). A selector that matches no component host is refused at once (#367).
190
193
- A `Store` provided in a route is found, and the DI tools keep each signal store's name instead of `SignalStore`.
191
194
- The SSR hydration count is right, and a request is no longer reported as a transfer cache hit when it was not.
192
195
- A failed write answers with `isError: true`, and a failing call keeps its response body.
193
196
- The Express hub turns itself off with a warning on a Node.js that can't load it, instead of crashing the server.
194
197
-`@pangular-inspector/devtools/devframe` (and the package root) load Devframe from `node_modules` when imported, as the hub entry does, so an Angular 20 server bundle that imports them no longer fails with `Identifier 'createRequire' has already been declared` (#427).
195
198
- Picking works inside shadow roots and `ShadowDom` components.
196
199
- Analog server calls link only to the request they ran under (#405).
200
+
- The Analog page chain includes pages in named outlets and sibling child routes, not only the first child. The primary chain comes first, and each other page names its outlet in the **Routes** tab and in `analog-inspect-page` (#369).
197
201
- Signal Forms checkboxes, radios and selects are written in user mode (#360).
198
202
- Live counts in **Timeline**, **Errors** and **Audit** speak only after a filter change, so they no longer flood screen readers.
199
203
- Control outlines and **Signals** graph edges meet 3:1 contrast in both themes, and status pills keep their contrast on selected rows.
-`explain-invalid-forms` no longer says no field has an error when the failing field is past the forms collector's limit of 100 fields per group. A cut group carries `truncatedInvalid` with the invalid fields it left out, `explain-invalid-forms` and `explain-submit` name them, and `inspect-forms` says which group was cut and how many fields it left out, or that a group past the 8-level depth limit was not read (#423).
203
207
-`scan-signals` and `scan-components` cap their answer at 200 items or 20,000 characters, say how many items they left out, and take `filter`, `offset` and `limit` to read the rest. A list that fits is still the JSON array alone. One item longer than the cap is cut, with a note (#429).
204
208
- The panel switches tabs when only the `#tab=` hash changes after load (#425).
209
+
- The `defer-blocks` tool and the **Defer blocks** list count how long a block sat on its placeholder on the page's clock. The component report carries the page clock (`pageNow`) and the server keeps the offset as `clockOffset`, so a page whose clock runs ahead or behind no longer reads as stuck, or never stuck (#366).
210
+
- The **Defer blocks** list shows the notes the `defer-blocks` tool prints (**failed**, **stuck**_N_ s, **waiting**_N_ s, **dehydrated**), an **@error block** flag and the `@placeholder` and `@loading` times (#366).
211
+
- Highlighting a `@defer` block draws one box around all of its root elements instead of the first one. `request-page-highlight` takes `ids` for several elements next to `id` (#366).
212
+
- The **SSR & HTTP** hydration mismatches name the component class, such as `ProductCard`, instead of the DOM node name (#366).
205
213
- At narrow widths the **Components** toolbar fits on two rows, with its tree actions as icons, and a cut off component name shows its full text on hover and focus (#421).
214
+
- The **Forms** tab lists WebMCP tools that are not linked to a form under **Other WebMCP tools**, with the same parts as a form's **WebMCP tool** block (#368).
215
+
- The **Forms** tab shows the forms setup errors Angular logs on the page, such as `NG01203`, in a notice above the list (#368).
0 commit comments