Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/davidG97/qa-flow/llms.txt

Use this file to discover all available pages before exploring further.

Every step in a QA Flow test is represented by a node. Nodes are dragged from the palette onto the canvas, configured through a field panel, and wired together with edges to define execution order. This page documents every node type available in QA Flow, including its ID, label, purpose, and all configurable fields.

​
Trigger Nodes

Trigger nodes mark the entry point of a test flow. Every flow must start with exactly one trigger.
Category: trigger | Label: InicioThe Start node is the anchor of every flow. It defines the base URL, names the test, assigns tags for filtering, and optionally configures full device emulation for the browser context that Playwright will open.Basic fields:
FieldTypeRequiredDescription
testNametext—Human-readable name for the test (e.g. My login test)
tagstags—Comma-separated tags for filtering (e.g. @smoke, @regression)
baseUrltext✅The root URL all relative paths resolve against (e.g. https://example.com)
Emulation group (advanced):
FieldTypeDefaultDescription
deviceselect(none)Emulate a named device: Pixel 5, Pixel 7, iPhone 12–14 Pro Max, iPad Mini, iPad Pro 11, Galaxy S9+, Galaxy Tab S4
viewportWidthnumber1280Viewport width in pixels
viewportHeightnumber720Viewport height in pixels
deviceScaleFactornumber1Device pixel ratio
isMobilebooleanfalseTreat the context as a mobile browser
hasTouchbooleanfalseEnable touch event support
localeselect(default)Browser locale: en-US, en-GB, es-ES, es-MX, es-CO, pt-BR, fr-FR, de-DE, it-IT, ja-JP, ko-KR, zh-CN
timezoneIdselect(default)IANA timezone: America/New_York, America/Los_Angeles, America/Bogota, Europe/London, Asia/Tokyo, and more
geoLatitudetext—GPS latitude for geolocation emulation
geoLongitudetext—GPS longitude for geolocation emulation
geoAccuracynumber—Geolocation accuracy in metres
colorSchemeselect(default)Preferred color scheme: light, dark, or no-preference
reducedMotionselect(default)Reduced motion preference: reduce or no-preference
forcedColorsselect(default)Forced colors mode: active or none
offlinebooleanfalseSimulate an offline network state
javaScriptEnabledbooleantrueToggle JavaScript execution in the browser context
userAgenttextarea—Override the browser’s User-Agent string
permissionstags—Browser permissions to grant (e.g. geolocation, notifications, camera)

​
Action Nodes

Action nodes drive the browser — they navigate, interact with elements, and read data from the page. Use them to simulate everything a real user would do.
Category: action | Label: Hacer ClickClicks a DOM element identified by a selector. Supports left, right, and middle mouse buttons with configurable click count and delay.
FieldTypeRequiredDefaultDescription
selectortext✅—CSS/XPath selector (e.g. #id, .class, button[type="submit"])
buttonselect—leftMouse button: left, right, or middle
clickCountnumber—1Number of clicks to perform
delaynumber—0Milliseconds between mousedown and mouseup
forceboolean—falseSkip actionability checks and force the click
timeoutnumber—30000Maximum wait time in milliseconds
Category: action | Label: Marcar/Desmarcar CheckboxChecks or unchecks a checkbox or radio input element.
FieldTypeRequiredDefaultDescription
selectortext✅—Selector targeting the checkbox (e.g. input[type="checkbox"])
actionselect—checkcheck to mark, uncheck to clear
forceboolean—falseSkip actionability checks
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Escribir TextoTypes text into a focused input field, optionally clearing it first. Each character fires individual keyboard events, which is useful for inputs that react to keydown/keyup events.
FieldTypeRequiredDefaultDescription
selectortext✅—Target input selector (e.g. input[name="email"])
texttext✅—The text to type
clearFirstboolean—trueClear the field before typing
delaynumber—0Milliseconds between each keypress
Category: action | Label: Rellenar CampoFills an input field instantly by setting its value directly — faster than type and suitable for most form inputs that don’t depend on keyboard event sequences.
FieldTypeRequiredDefaultDescription
selectortext✅—Target input selector
valuetext✅—The value to insert
Category: action | Label: Seleccionar OpciónSelects an option from a <select> dropdown element by value, visible label, or index.
FieldTypeRequiredDefaultDescription
selectortext✅—Selector for the <select> element (e.g. select#country)
valuetext✅—The option to select
selectByselect—valueSelection strategy: value (option value attribute), label (visible text), index
Category: action | Label: HoverMoves the mouse over an element, triggering mouseover and mouseenter events. Useful for revealing dropdown menus or tooltips.
FieldTypeRequiredDescription
selectortext✅Target element selector (e.g. .menu-item)
Category: action | Label: EsperarPauses execution for a fixed time, until an element is visible or hidden, or until the network is idle.
FieldTypeRequiredDefaultDescription
waitTypeselect—timeStrategy: time (fixed ms), selector (element visible), hidden (element hidden), networkidle
valuetext✅—Milliseconds (for time) or a selector string (for element strategies)
timeoutnumber—30000Maximum wait time in milliseconds
Category: action | Label: Captura de PantallaCaptures a screenshot and saves it to disk. Can capture the full page or a specific element.
FieldTypeRequiredDefaultDescription
nametext✅—Output filename without extension (e.g. login-capture)
fullPageboolean—falseCapture the full scrollable page height
selectortext——Restrict capture to this element (hidden when fullPage is true)
Category: action | Label: Doble ClickPerforms a double-click on an element. Supports mouse button selection and delay configuration.
FieldTypeRequiredDefaultDescription
selectortext✅—Target element selector
buttonselect—leftMouse button: left, right, middle
delaynumber—0Milliseconds between the two clicks
forceboolean—falseSkip actionability checks
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Limpiar CampoClears the contents of an input or textarea element.
FieldTypeRequiredDefaultDescription
selectortext✅—Target input selector (e.g. input#email)
forceboolean—falseSkip actionability checks
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Quitar FocoRemoves focus from an element by dispatching a blur event. Useful for triggering validation that fires on blur.
FieldTypeRequiredDefaultDescription
selectortext✅—Target element selector
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Dar FocoFocuses an element by dispatching a focus event, without simulating any user input.
FieldTypeRequiredDefaultDescription
selectortext✅—Target element selector
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Presionar TeclaPresses a keyboard key or combination on a focused element. Choose from a preset list or supply a custom key string.
FieldTypeRequiredDefaultDescription
selectortext✅—Element to focus before pressing (e.g. input#search)
keyselect—EnterPreset key: Enter, Tab, Escape, Backspace, Delete, Arrow keys, Home, End, PageUp/Down, Ctrl+A/C/V/Z/S, F1/F5/F12
customKeytext——Custom key combination overriding the preset (e.g. Shift+Control+a)
delaynumber—0Delay in milliseconds
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Escribir SecuencialmenteTypes text one character at a time, simulating a real human typing. Each character fires its own keyboard events with a configurable inter-key delay.
FieldTypeRequiredDefaultDescription
selectortext✅—Target input selector
texttext✅—Text to type character by character
delaynumber—50Milliseconds between each character
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Seleccionar TextoSelects all text inside an input or textarea element.
FieldTypeRequiredDefaultDescription
selectortext✅—Target input or textarea selector
forceboolean—falseSkip actionability checks
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Subir ArchivoSets the value of a file input element by providing the path to the file on the server.
FieldTypeRequiredDefaultDescription
selectortext✅—Selector for the <input type="file"> element
filePathtext✅—Absolute path to the file to upload (e.g. /path/to/document.pdf)
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Tap (Móvil)Performs a touch tap on an element. Use this in flows that emulate mobile devices with hasTouch enabled on the Start node.
FieldTypeRequiredDefaultDescription
selectortext✅—Target element selector (e.g. button.submit)
forceboolean—falseSkip actionability checks
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Arrastrar y SoltarDrags a source element and drops it onto a target element.
FieldTypeRequiredDefaultDescription
sourceSelectortext✅—Selector for the element to drag
targetSelectortext✅—Selector for the drop target
forceboolean—falseSkip actionability checks
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Hacer ScrollScrolls the page until the target element becomes visible in the viewport.
FieldTypeRequiredDefaultDescription
selectortext✅—Selector for the element to scroll to
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Disparar EventoProgrammatically dispatches a DOM event on an element. Useful for triggering behavior that native Playwright interactions cannot reach.
FieldTypeRequiredDefaultDescription
selectortext✅—Target element selector
eventTypeselect—clickEvent to dispatch: click, dblclick, mousedown, mouseup, mouseover, mouseout, focus, blur, input, change, submit, keydown, keyup, keypress, dragstart, dragend, drop
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Esperar ElementoWaits until an element reaches a specific DOM state before the flow continues.
FieldTypeRequiredDefaultDescription
selectortext✅—Selector to watch
stateselect—visibleExpected state: visible, hidden, attached (in DOM), detached (removed from DOM)
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Obtener AtributoReads an attribute value from a DOM element and optionally stores it in a named variable for use in subsequent nodes.
FieldTypeRequiredDefaultDescription
selectortext✅—Target element selector (e.g. a#link)
attributetext✅—Attribute name to read (e.g. href, class, data-id)
variableNametext——Variable name to store the result in
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Obtener Valor de InputReads the current value of an input, textarea, or select element and optionally stores it in a variable.
FieldTypeRequiredDefaultDescription
selectortext✅—Target input selector (e.g. input#email)
variableNametext——Variable name to store the result in
timeoutnumber—30000Timeout in milliseconds
Category: action | Label: Obtener TextoReads the inner text content of an element and optionally stores it in a variable.
FieldTypeRequiredDefaultDescription
selectortext✅—Target element selector (e.g. span.message)
variableNametext——Variable name to store the result in
timeoutnumber—30000Timeout in milliseconds

​
Assertion Nodes

Assertion nodes verify your application’s state by wrapping Playwright’s expect() API. A failing assertion marks the test as failed and halts the flow at that point.
assertVisible (toBeVisible) — Verifies that an element is rendered and visible on the page.
FieldTypeDefaultDescription
selectortext—Element to check (e.g. .success-message)
negatebooleanfalseWhen true, asserts the element is NOT visible
timeoutnumber5000Timeout in milliseconds
assertHidden (toBeHidden) — Verifies that an element is hidden or absent from the visible layout.
FieldTypeDefaultDescription
selectortext—Element to check
timeoutnumber5000Timeout in milliseconds
assertAttached (toBeAttached) — Verifies that an element exists in the DOM, regardless of whether it is visible.
FieldTypeDefaultDescription
selectortext—Element to check (e.g. #component)
attachedselecttruetrue = in DOM, false = not in DOM
timeoutnumber5000Timeout in milliseconds
assertChecked (toBeChecked) — Verifies whether a checkbox or radio input is checked or unchecked.
FieldTypeDefaultDescription
selectortext—Checkbox or radio selector
checkedselecttruetrue = expects checked, false = expects unchecked
timeoutnumber5000Timeout in milliseconds
assertEnabled (toBeEnabled) — Verifies that an interactive element (button, input, etc.) is not disabled.assertDisabled (toBeDisabled) — Verifies that an element has the disabled attribute or state.Both nodes share the same field structure:
FieldTypeDefaultDescription
selectortext—Element to check (e.g. button#submit)
timeoutnumber5000Timeout in milliseconds
assertEditable (toBeEditable) — Verifies whether an input is editable (not read-only and not disabled).
FieldTypeDefaultDescription
selectortext—Input or textarea selector
editableselecttruetrue = editable, false = not editable
timeoutnumber5000Timeout in milliseconds
assertEmpty (toBeEmpty) — Verifies that an element has no child elements and no text content.
FieldTypeDefaultDescription
selectortext—Container selector (e.g. .item-list)
timeoutnumber5000Timeout in milliseconds
assertFocused (toBeFocused) — Verifies that an element currently has keyboard focus.
FieldTypeDefaultDescription
selectortext—Element to check (e.g. input#email)
timeoutnumber5000Timeout in milliseconds
assertInViewport (toBeInViewport) — Verifies that an element is within the visible viewport area. An optional ratio sets the minimum fraction of the element that must be visible.
FieldTypeDefaultDescription
selectortext—Element to check
rationumber0Minimum visible ratio from 0.0 to 1.0
timeoutnumber5000Timeout in milliseconds
assertText (toHaveText / toContainText) — Verifies the text content of an element, with options for exact match, substring, or regular expression.
FieldTypeDefaultDescription
selectortext—Element to read (e.g. h1.title)
expectedTexttext—The text to match against
matchTypeselectcontainsexact (toHaveText), contains (toContainText), or regex
ignoreCasebooleanfalseCase-insensitive comparison
timeoutnumber5000Timeout in milliseconds
assertAttribute (toHaveAttribute) — Verifies the value of a DOM attribute on an element. If expectedValue is left empty, the assertion only checks that the attribute exists.
FieldTypeDefaultDescription
selectortext—Target element selector (e.g. a#link)
attributetext—Attribute name to verify (e.g. href, class, data-id)
expectedValuetext—Expected attribute value; leave empty to assert existence only
timeoutnumber5000Timeout in milliseconds
assertClass (toHaveClass / toContainClass) — Verifies the CSS class or classes applied to an element. Use contains to check that a class is present among others, or exact to match the full class list.
FieldTypeDefaultDescription
selectortext—Target element selector (e.g. div#card)
expectedClasstext—One or more space-separated class names to verify (e.g. active highlighted)
matchTypeselectcontainsexact (toHaveClass — full class list must match) or contains (toContainClass — class must be present)
timeoutnumber5000Timeout in milliseconds
assertCSS (toHaveCSS) — Verifies that a computed CSS property of an element has the expected value.
FieldTypeDefaultDescription
selectortext—Target element (e.g. .button)
cssPropertytext—CSS property name (e.g. background-color, display, opacity)
expectedValuetext—Expected computed value (e.g. rgb(255, 0, 0), block, 1)
timeoutnumber5000Timeout in milliseconds
assertId (toHaveId) — Verifies that the id attribute of an element matches an expected value.
FieldTypeDefaultDescription
selectortext—Element to inspect
expectedIdtext—Expected id attribute value (e.g. user-profile)
timeoutnumber5000Timeout in milliseconds
assertRole (toHaveRole) — Verifies the ARIA role of an element. Supports the full set of WAI-ARIA roles including button, checkbox, dialog, link, navigation, textbox, grid, and many more.
FieldTypeDefaultDescription
selectortext—Element to check
expectedRoleselectbuttonExpected ARIA role (full list covers ~35 roles)
timeoutnumber5000Timeout in milliseconds
assertAccessibleName (toHaveAccessibleName) — Verifies the accessible name of an element as computed by the accessibility tree.assertAccessibleDescription (toHaveAccessibleDescription) — Verifies the accessible description of an element.Both follow the same structure:
FieldTypeDefaultDescription
selectortext—Element to inspect
expectedName / expectedDescriptiontext—Expected accessible name or description string
timeoutnumber5000Timeout in milliseconds
assertUrl (toHaveURL) — Verifies the current page URL.
FieldTypeDefaultDescription
expectedUrltext—URL to match (e.g. /dashboard or https://...)
matchTypeselectcontainsexact, contains, or regex
timeoutnumber5000Timeout in milliseconds
assertTitle (toHaveTitle) — Verifies the <title> of the current page.
FieldTypeDefaultDescription
expectedTitletext—Title to match
matchTypeselectcontainsexact, contains, or regex
timeoutnumber5000Timeout in milliseconds
assertValue (toHaveValue) — Verifies the current value of an input, textarea, or select element.
FieldTypeDefaultDescription
selectortext—Input to inspect
expectedValuetext—Expected value string
timeoutnumber5000Timeout in milliseconds
assertValues (toHaveValues) — Verifies the selected values of a multi-select element.
FieldTypeDefaultDescription
selectortext—<select multiple> selector
expectedValuestext—Comma-separated expected values (e.g. red,blue,green)
timeoutnumber5000Timeout in milliseconds
assertCount (toHaveCount) — Verifies the number of elements matching a selector, with flexible comparison operators.
FieldTypeDefaultDescription
selectortext—Selector to count (e.g. .list-item)
expectedCountnumber—The count to compare against
comparisonselectequalequal, greaterThan, lessThan, greaterOrEqual, lessOrEqual
timeoutnumber5000Timeout in milliseconds
assertScreenshot (toHaveScreenshot) — Captures a screenshot and compares it pixel-by-pixel against a stored baseline image. Fails if the difference exceeds the configured threshold.
FieldTypeDefaultDescription
selectortext—Element to capture (leave empty for full page)
screenshotNametext—Name for the baseline image (e.g. login-form)
maxDiffPixelsnumber0Maximum number of differing pixels allowed
maxDiffPixelRationumber0Maximum ratio of differing pixels (0.0–1.0)
timeoutnumber5000Timeout in milliseconds
On the first run, assertScreenshot creates the baseline image automatically. Subsequent runs compare against that baseline. Delete the baseline file to regenerate it after intentional UI changes.

​
Control Flow Nodes

Control flow nodes add branching and repetition to your test graph. They let you handle dynamic states and data-driven scenarios without writing code.
Category: control | Label: Condición (If)Evaluates a condition and routes execution down one of two output edges — the true branch or the false branch. This lets your flow adapt to variable page states such as the presence of a cookie banner or an optional modal.
FieldTypeDefaultDescription
conditionTypeselectelementExistsCondition to evaluate: elementExists, elementVisible, textContains, urlContains
selectortext—Element selector or text/URL value to evaluate
Connect nodes to the true output for the path when the condition passes, and to the false output for when it does not.
Category: control | Label: Bucle (Loop)Repeats a connected sequence of nodes a fixed number of times, once per matched element, or once per item in a data array.
FieldTypeDefaultDescription
loopTypeselectcountLoop strategy: count (fixed iterations), elements (one pass per matching DOM element), data (one pass per data row)
valuetext—Number of iterations (for count) or a CSS selector (for elements)
Category: control | Label: Código JavaScriptExecutes arbitrary JavaScript inside the Playwright test context. The script has access to the page, context, and browser objects, enabling anything Playwright can do.
FieldTypeDefaultDescription
codetextarea—JavaScript code to execute. Variables page, context, and browser are available.
descriptiontext—Human-readable summary of what this code does
awaitResultbooleantrueWhether to await the result of the code expression
// Example: read the page title and log it
const title = await page.title();
console.log('Page title:', title);
Code nodes execute with full access to the Playwright API. Only run trusted code — malicious scripts can access the file system or network from the test runner process.

​
Hook Nodes

Hook nodes mirror Playwright’s test lifecycle and let you define shared setup and teardown logic that runs before or after individual tests or entire test suites.
beforeAll — Runs once before all tests in the current group. Use it to set up shared state such as seeding a database or spinning up a mock server.afterAll — Runs once after all tests in the group complete, regardless of pass/fail. Use it to tear down anything created in beforeAll.Both nodes share the same fields:
FieldTypeDescription
hookNametextDescriptive name for the hook (e.g. Initial Setup)
descriptiontextareaWhat this hook does
beforeEach — Runs before every individual test in the group. Common uses: navigate to the starting URL, log in, or reset application state.afterEach — Runs after every individual test. Common uses: take a failure screenshot, log out, or clean up test data.Both nodes share the same fields:
FieldTypeDescription
hookNametextDescriptive name (e.g. Login before each test)
descriptiontextareaWhat this hook does

Build docs developers (and LLMs) love

Get started for freeTalk to us