Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Selector queries have no fallback producer on the iOS Simulator, and any fallback needs producer equivalence

Open
#2,274 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
42/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
ios, typescript
Domain
mobile, testing

Research direction

Read #2197 and #2273 first to understand the Simulator snapshot contract and typed query failure distinction. Then trace the primary snapshot producer, its private-AX fallback, and the selector query path. Done means fallback queries preserve identifier and label matching, report true negatives with the same error code, and answer consistently before and after degradation.

Written by the indexing model from the issue text.

Description

needs-info

Split out of #2273 at triage request, to keep that issue scoped to the typed failure contract.

What this asks for

A selector query on the iOS Simulator has no fallback producer. Where the snapshot path degrades,
snapshot switches to the private-ax producer and still returns the element, and a selector query
for that same element fails.

This issue tracks giving the selector path a fallback, and the equivalence it would have to hold.

The observation behind it

Measured on agent-device 0.20.10, iOS Simulator, in a remote EAS Simulator session. Full method
and diagnostics are in #2273.

Six screens, 30 is visible calls each. Three screens answered every call. Three answered almost
none, all with XCTEST_RECORDED_FAILURE.

The split follows one thing only, which each capture states in its own header.

screen nodes capture truncated and fell back queries
screen 1 189 no answer
screen 2 177 no answer
screen 3 188 no answer
screen 4 901 no answer
screen 5 178 yes fail
screen 6 170 yes fail
screen 7 149 yes fail

Node count does not predict it in either direction. Screen 4 holds 901 nodes and answers. Screen 7
holds 149 and fails.

A capture taken immediately before each probe held the element every time. So the element was
present and readable while the query for it failed.

Why this is not simply "add the fallback"

Triage notes that #2197 establishes the Simulator snapshot producer and presentation contract
first, and that this work should follow it. We agree, and we want to add one requirement from a
caller's side.

Producer equivalence. A selector resolved through the fallback producer must match identifiers
and labels the same way the primary producer matches them. If the two producers expose different
identifiers, or propagate labels differently, then a query answered from the fallback could report
an element absent when it is present.

For us that would be worse than the failure we reported. A failure stops a flow and names itself. A
false negative passes a check that should have failed, or fails a check that should have passed, and
neither names the producer.

We cannot measure that equivalence ourselves. We tried. We captured one screen twice in one
run, once clean and once degraded, and the two captures turned out to be different states of the
screen rather than one state read two ways. So we have no data on how the two producers differ, and
we are not claiming any.

Acceptance tests we would find convincing

  • An element that is present is never reported absent, on either producer, for identifier and label
    selectors alike.
  • A true negative is reported identically by both producers, and with the same error code.
  • A screen that forces the fallback answers the same selector query as the same screen before it
    degraded.

What would unblock us sooner

Nothing here is urgent for us if #2273 lands. A typed reason that separates "the query could not
run" from "the element is absent" lets a flow retry or read the screen instead, which is enough to
work around this. The fallback is the better fix and the slower one.

Dominant language
TypeScript
Stars
4.7k
Forks
304
Avg merge
11h 29m
Merged PRs (30d)
514

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from callstack/agent-device

All issues in callstack/agent-device

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.