From 7d6ed32474653d4da6a47177ec51f177f103be9e Mon Sep 17 00:00:00 2001 From: PJ Date: Sat, 15 Aug 2026 18:59:27 +0530 Subject: [PATCH] docs(spec-language): say what a trace records for an element-valued extractor --- docs/manual/spec-language.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/manual/spec-language.md b/docs/manual/spec-language.md index afc9757..9b4516d 100644 --- a/docs/manual/spec-language.md +++ b/docs/manual/spec-language.md @@ -169,6 +169,8 @@ loggedIn.previous // T | undefined - value from the previous step, undefined o Extractors are evaluated before properties and action generators. Use `.previous` to detect transitions between steps. Named extractors appear by name in the replay UI and trace. +An extractor may return elements. The trace records their data (id, text, desc, class, the flags, bounds, attrs) and not their `find`/`findAll` methods; a cycle, a NaN or a branch nested deeper than 32 levels is recorded as null. A value with no JSON form at all fails the step and names the extractor, so nothing goes unrecorded without the author hearing about it. + ## LTL operators | Function | Meaning |