> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.doc-detective.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.doc-detective.com/_mcp/server.

# Element criteria

> Wait for a specific element to be present. At least one finding field must be specified.

Wait for a specific element to be present. At least one finding field must be specified.

## Referenced In

* [Browser readiness](/reference/schemas/browser-readiness)
* [App readiness](/reference/schemas/app-readiness)

## Fields

| Field            | Type                               | Description                                                                                                                                                                                                         | Default |
| :--------------- | :--------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :------ |
| selector         | string                             | Optional. Selector for the element to wait for. On browser surfaces, a CSS selector. On app surfaces, a native selector — an XPath (`//`), or `~` for an accessibility id; CSS is rejected at runtime.              | —       |
| elementText      | string                             | Optional. Text content the element must contain. Supports exact match or regex pattern using /pattern/ syntax.                                                                                                      | —       |
| elementId        | string                             | Optional. ID attribute of the element to find. Supports exact match or regex pattern using /pattern/ syntax.                                                                                                        | —       |
| elementTestId    | string                             | Optional. data-testid attribute of the element to find. Supports exact match or regex pattern using /pattern/ syntax.                                                                                               | —       |
| elementClass     | one of: - string - array of string | Optional. Class or array of classes that the element must have. Each class supports exact match or regex pattern using /pattern/ syntax. Element must have all specified classes.                                   | —       |
| elementAttribute | object                             | Optional. Object of attribute key-value pairs that the element must have. Values can be strings (supporting /pattern/ regex), numbers, or booleans. Boolean true matches attribute presence, false matches absence. | —       |
| elementAria      | string                             | Optional. Computed accessible name of the element per ARIA specification. Supports exact match or regex pattern using /pattern/ syntax.                                                                             | —       |

## Examples

```json
{
  "selector": "example",
  "elementText": "example",
  "elementId": "example",
  "elementTestId": "example",
  "elementClass": "example",
  "elementAttribute": {},
  "elementAria": "example"
}
```