Skip to content

Find the right control ​

Start with a readable label. Add enough detail to identify the intended control when a page repeats the same text. These actions are available in Flowstride and Flowstride Pro.

Choose a target deliberately ​

Page situationExampleWhy
Distinct button textflow.click button "Login";Limits the search to button-like controls
Distinct input placeholderflow.type input "Email" "reader@example.test";Uses supported input heuristics
Repeated label beside a headingflow.click "Edit" near "Billing address";Adds a spatial anchor
Repeated action in a recordflow.click button "View" inside "#order-102";Scopes the action to the record
Stable test attributeflow.click "[data-testid='save-profile']";Uses an explicit selector
Repeated identical controlsflow.click "Edit[1]";Selects a zero-based occurrence; order must be stable
A table coordinateflow.click "table[0] tr[2] td[0]";Uses zero-based table/row/cell positions

Readable targeting uses heuristics over text, attributes, wrapped labels and nearby controls. It is not identical to Playwright's accessibility-role lookup. For an exact accessible role/name check, use flow.assert.that with role and name.

Input qualifiers and placeholders ​

flow
flow.type input "Enter your email" "{{env.TEST_EMAIL}}";
flow.type placeholder "Enter your email" "{{env.TEST_EMAIL}}";

The explicit placeholder form resolves a placeholder. An input qualifier uses a narrower input-specific search; not every external <label for> arrangement is equivalent to a wrapped label in that path. If a readable target is ambiguous or absent, inspect the control and use a stable selector:

flow
flow.type "input[name='email']" "{{env.TEST_EMAIL}}";
flow.assert.that {
  "selector": "input[name='email']",
  "condition": "value",
  "value": "{{env.TEST_EMAIL}}"
};

Typing can tolerate application formatting, such as punctuation removal. Pair it with an exact value assertion when format matters.

Password toggles ​

Use flow.click passToggle for "Password"; to click the show/hide control associated with Password. On a sign-up form, use flow.click passToggle for "Confirm password"; for the second field. The quoted text names the input. FS can recognize controls through their relationship to a field, show/hide semantics or a nearby eye icon. The control must be visible and identifiable.

If several controls match, FS stops before clicking and reports the number of matches. Give the field label first. When several candidates still match that field, use the reported zero-based index. For example, flow.click passToggle[1] for "Password"; selects the second match for Password. On a form with stable ordering, flow.click passToggle[0]; selects the first matching control across the search scope. An out-of-range index fails.

FS can find a password field inside nested iframes. When more than one frame contains the same form, select the intended frame with flow.frame.use, perform the click and assertions there, then return with flow.frame.main {}. Frame scoping · Runnable password examples

Spatial relationships ​

Use near, above, below/under, leftOf, rightOf, and inside/in to distinguish controls. These depend on rendered layout or containment. A viewport change can alter the geometry.

flow
flow.click "Log in" near "Sign up";
flow.click button "Start SOAP" inside "table[0] tr[1] td[9]";
flow.click "My SOAPs" rightOf "My Appointments";

Choose one clear relationship and a unique anchor. Do not assume arbitrary chains of several spatial clauses have a defined constraint-solving meaning. A record selector is usually more stable than geometry when the relationship is logical rather than visual.

Explicit selectors ​

Raw CSS and supported Playwright selector prefixes such as css=, text= and xpath= bypass parts of the readable-target heuristic. Keep selectors understandable and verify the result of the action. Raw selectors target the current page; they do not instruct every action to search all iframes. Frames need their own scope.

If Flowstride reports ambiguity, qualify the element, scope it to a record, or use a stable selector. A forced click bypasses actionability protections; it does not explain which of several identical records you intended.

Try the table example to practice row-based selection and extraction, then read forms and dates for complete input workflows.

Flowstride is MIT licensed. Flowstride Cloud offers free and paid workspace plans.