egutierrez
988e901066
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
---
|
|
name: cdp_evaluate
|
|
kind: function
|
|
lang: go
|
|
domain: browser
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "func CdpEvaluate(c *CDPConn, expression string) (string, error)"
|
|
description: "Ejecuta una expresion JavaScript arbitraria en la pagina actual via Runtime.evaluate. Retorna el resultado serializado como string. Soporta await (awaitPromise=true). Reporta excepciones JS como error."
|
|
tags: [chrome, cdp, browser, automation, javascript, devtools]
|
|
uses_functions: [cdp_connect_go_browser]
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [fmt]
|
|
params:
|
|
- name: c
|
|
desc: "conexión CDP activa"
|
|
- name: expression
|
|
desc: "expresión JavaScript a evaluar"
|
|
output: "string: resultado serializado, o error si falla"
|
|
tested: true
|
|
tests: ["TestCdpEvaluate"]
|
|
test_file_path: "functions/browser/chrome_launch_test.go"
|
|
file_path: "functions/browser/cdp_evaluate.go"
|
|
---
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
conn, _ := CdpConnect(9222)
|
|
result, err := CdpEvaluate(conn, "document.title")
|
|
// result = "My Page Title"
|
|
|
|
sum, err := CdpEvaluate(conn, "1 + 2")
|
|
// sum = "3"
|
|
```
|
|
|
|
## Notas
|
|
|
|
Los valores no-string se convierten con `fmt.Sprintf("%v", value)`. Numeros aparecen sin decimales si son enteros (ej: `"3"` no `"3.0"`). Para tipos complejos (objetos, arrays), el resultado es la representacion Go de la interfaz, no JSON — usar `JSON.stringify(...)` en la expresion JS para obtener JSON limpio.
|