traces.ribdsp.com

{
  "type": "object",
  "properties": {
    "selector": {
      "type": "string",
      "description": "CSS selector for the element to watch, e.g. \"#checkout button[type=submit]\". Use find_element first if you are not sure it exists."
    },
    "predicate": {
      "type": "object",
      "description": "The condition to search for. A structured object from a fixed set — expressions and code are not accepted.",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "propertyEquals",
            "attributeExists",
            "attributeEquals",
            "optionCount",
            "visible",
            "textContains",
            "exists"
          ],
          "description": "propertyEquals: a live DOM property. attributeExists / attributeEquals: an attribute. optionCount: number of <option> children, use 0 to find an empty dropdown. visible: rendered and non-zero-sized. textContains: substring of the text content. exists: the element is in the document."
        },
        "property": {
          "type": "string",
          "enum": [
            "disabled",
            "checked",
            "readOnly",
            "value"
          ],
          "description": "For propertyEquals only."
        },
        "attribute": {
          "type": "string",
          "description": "For attributeExists and attributeEquals. Letters and hyphens, up to 30 characters."
        },
        "text": {
          "type": "string",
          "description": "For textContains. Up to 100 characters, matched case-insensitively."
        },
        "equals": {
          "description": "The value to compare against: boolean for visible and exists, integer for optionCount, string or boolean for propertyEquals, string for attributeEquals."
        }
      },
      "required": [
        "kind"
      ]
    },
    "from": {
      "type": "number",
      "description": "Start of the search window, in ms from the beginning of the recording."
    },
    "to": {
      "type": "number",
      "description": "End of the search window, in ms. Usually durationMs from read_session_meta."
    },
    "precisionMs": {
      "type": "number",
      "description": "How close the answer needs to be, in ms. Defaults to 250. Larger is faster."
    }
  },
  "required": [
    "selector",
    "predicate",
    "from",
    "to"
  ],
  "additionalProperties": false
}