Method describe

lib/element/WebElement.js:530–547

* Plain-object snapshot of the element — text, simplified HTML, visibility, * enabled state, and a curated set of attributes. Each underlying call is * isolated so a single failure (e.g. detached element) doesn't poison the * rest. Suitable for JSON.stringify, log output, MCP tool responses

({ maxHtmlLength = 300, attrs = ['id', 'class', 'name', 'role', 'type', 'href', 'value', 'aria-label', 'placeholder', 'data-testid'] } = {})

   * @returns {Promise<{text?: string, html?: string, visible?: boolean, enabled?: boolean, attrs?: object}>}
   */
  async describe({ maxHtmlLength = 300, attrs = ['id', 'class', 'name', 'role', 'type', 'href', 'value', 'aria-label', 'placeholder', 'data-testid'] } = {}) {
    const out = {}
    await Promise.all([
      this.toSimplifiedHTML(maxHtmlLength).then(v => { if (v) out.html = v }, () => {}),
      this.getText().then(v => { const t = v?.trim(); if (t) out.text = t }, () => {}),
      this.isVisible().then(v => { out.visible = v }, () => {}),
      this.isEnabled().then(v => { out.enabled = v }, () => {}),
    ])
    const collected = {}
    await Promise.all(attrs.map(async name => {
      try {
        const v = await this.getAttribute(name)
        if (v != null && v !== '') collected[name] = v
      } catch {}
    }))
    if (Object.keys(collected).length) out.attrs = collected
    return out
  }

  // Make accidental JSON.stringify (e.g. returning a WebElement from MCP run_code)
  // produce a usable hint instead of `{}` — the underlying handle isn't