Entrada humanizada
Con humanize, el SDK mueve el mouse, hace clic, hace scroll y escribe con trayectorias y tiempos similares a los humanos. showCursor dibuja el puntero para que puedas verlo.
Entrada humanizada (humanize & showCursor)
Pasa humanize y toda la entrada —mover, hacer clic, arrastrar, hacer scroll y escribir— sigue un mismo estándar humanizado, tanto a nivel de página (page.click / hover / type / fill / mouse.* / keyboard.type) como a nivel de locator (locator.click / type / fill / pressSequentially / dragTo / …). Los movimientos siguen una trayectoria bézier cúbica ligeramente curvada que parte de la última posición del cursor y se recorre como una suma de submovimientos de jerk mínimo (un movimiento balístico principal + uno correctivo: la velocidad con varios picos de un gesto real de alcance, no una única campana simétrica), y todo se despacha como eventos reales y confiables (isTrusted === true, y navigator.webdriver sigue en false). En Pro, los clics por coordenadas (mouse.click(x, y)) siguen movimientos grabados de personas reales; todo lo demás, y cada clic en el build abierto y en Gratis con GitHub, usa trayectorias generadas. Agrega showCursor para dibujar un punto que sigue el movimiento y así poder verlo.
Como los movimientos usan entrada nativa, un botón presionado con mouse.down() se mantiene presionado durante el movimiento, así que down → move → up es un arrastre real con el botón presionado (los controles de arrastrar hasta una posición, como los sliders, reciben un arrastre realmente presionado), y locator.dragTo también está humanizado. La escritura va tecla por tecla, con tiempos entre teclas aleatorios + pausas entre palabras, alguna que otra corrección de dedazo y key rollover: en algunos pares rápidos, la siguiente tecla baja antes de que suba la anterior, con una frecuencia fija por identidad (SDK 0.41.1). fill hace clic en el campo y escribe el valor (un valor de más de 200 caracteres recibe primero el clic y luego se inserta de una vez, para que los rellenos grandes no se eternicen).
El scroll avanza en muescas enteras de la rueda del mouse, en desplazamientos cortos con alguna pausa ocasional de lectura, y antes mueve el puntero sobre el contenido si todavía no está ahí. Un navegador reporta cada evento de rueda como una muesca completa, y una muesca real desplaza 100 px en Windows, 120 en Linux y 40 en macOS, así que la muesca sigue a la plataforma que reporta la página y una distancia solicitada se redondea a la muesca más cercana, como mínimo una: mouse.wheel(0, 800) desplaza 800 px con una identidad de Windows y 840 con una de Linux (SDK 0.41.1).
Formularios (SDK 0.48.0)
fill se adapta al tipo de campo. El texto se escribe, borrando antes con teclas mantenidas solo cuando el campo tiene un valor, y el resultado se comprueba; un control deslizante de rango se arrastra al valor exacto; un campo de fecha, hora, mes, semana o fecha y hora se escribe segmento a segmento en el orden en que el navegador los muestra. Un valor que un campo no admite lanza el propio error de Playwright, como antes.
selectOption abre un desplegable con un clic, escribe el comienzo de la etiqueta de la opción (espacios incluidos) y confirma con Enter, de modo que la página ve un único cambio de confianza, no uno por fila; a las filas a las que no se llega escribiendo se llega con una tecla de flecha mantenida. Un cuadro de lista se desplaza con la rueda y se elige con clics en las filas, con Ctrl pulsado para las filas adicionales de una selección múltiple. check / uncheck solo hacen clic cuando el estado tiene que cambiar.
Nunca se cometen errores de tecleo en campos de contraseña, correo electrónico, número, teléfono, URL o código de un solo uso, ni en un campo dentro de un marco, y solo se corrige lo que de verdad llegó al campo. CLEARCOTE_HUMANIZE_TYPO_RATE fija la tasa por tecla (por defecto 0.02; 0 desactiva los errores). Se respetan todas las opciones de clic (botón, número de clics, mantener, modificadores, posición, force, trial), funciona cualquier locator de Playwright y la comprobación de que un punto de clic no está tapado usa la propia prueba de impacto del navegador, así que el puntero nunca se mueve antes de su trayectoria y nada se pulsa antes de tiempo.
Tiempos y puntería (SDK 0.49.0)
Las trayectorias del ratón, los arrastres y ambient_motion / ambientMotion mantienen la duración con la que se planificaron, también en una máquina ocupada. Algunas trayectorias pasan el objetivo y vuelven, con una frecuencia fija por identidad, y un arrastre con el botón pulsado se mantiene a pocos píxeles de su línea, de modo que el tirador de un control deslizante sigue en su carril. Cada pulsación que hace el propio SDK llega tras una breve pausa una vez que el puntero ha llegado (de 40 a 250 ms, duración típica fija por identidad).
Un control bajo una capa que deja pasar los clics (un degradado, un icono, una etiqueta flotante) se pulsa como cualquier otro. trial ejecuta las comprobaciones de Playwright y no realiza ninguna entrada. Un campo con longitud máxima o máscara de entrada (una fecha de caducidad, un número de teléfono) se escribe una sola vez, nunca se borra para volver a escribirlo, y los campos de fecha y hora se escriben con el mismo ritmo de teclas que el texto. Los errores son los de Playwright, con la misma redacción.
En Python, Node y .NET (.NET desde 0.58.0), un clic por coordenadas (mouse.click(x, y)) puede recorrerlo y pulsarlo el propio motor del navegador; en motores hasta 154 r39 esa pulsación llega unos 10 ms después de que llegue el puntero, sin la pausa. CLEARCOTE_HUMANIZE_ENGINE_CLICKS=off mantiene todos los clics en la ruta del SDK, y =all (opcional) envía también al motor los clics por selector.
from clearcote import launch
browser = launch(fingerprint="seed-123", humanize=True, show_cursor=True)
page = browser.new_page()
page.goto("https://example.com")
page.click("text=Sign in") # eased curve, then a trusted click
page.fill("#email", "you@example.com") # focus + key-by-key human typing
page.locator("#password").type("s3cr3t") # locators are humanized too
# held-button drag (e.g. a slider): the press stays held across the move
x0, y0, x1 = 100, 300, 400 # the handle's start, and where to release it
page.mouse.move(x0, y0); page.mouse.down()
page.mouse.move(x1, y0); page.mouse.up()
browser.close()Mantener pulsado
Algunos controles solo actúan mientras el botón sigue pulsado: un botón de mantener para confirmar, un menú de pulsación larga, un botón de mantener pulsado que se llena antes de aceptar. press_and_hold / pressAndHold / PressAndHoldAsync hace una pulsación larga y humanizada sobre un elemento. Con humanize está en la página (page.press_and_hold(selector)) y en cada locator (locator.press_and_hold()), incluidos los frame locators; la función del módulo press_and_hold(locator) funciona en cualquier página. La API async (clearcote.async_api) tiene los mismos nombres, con await.
Espera a que el elemento sea visible y lo trae a la vista (con el desplazamiento humanizado de la rueda), lleva el puntero a un punto cercano al centro con la forma propia de la identidad (o a position, relativo a la esquina superior izquierda del elemento, como en Playwright), hace una breve pausa y pulsa. El botón queda pulsado durante duration milisegundos, por defecto entre 2,8 y 3,8 s elegidos cada vez, o hasta que until devuelva true: se consulta cada 100 ms, duration pasa a ser lo máximo que puede durar (15 s si no se indica), y el botón se suelta tras un tiempo de reacción humano de 160 a 350 ms, no en el mismo instante en que cambia la condición.
Mientras el botón está pulsado, una mano en reposo sigue moviendo el ratón de vez en cuando: una deriva escasa en píxeles enteros, nunca a más de 2 px del punto de pulsación, cada movimiento de confianza y con el botón indicado como pulsado. tremor=False / tremor: false deja el puntero quieto. button elige izquierdo, derecho o central, y timeout es cuánto esperar a que el elemento sea visible. La llamada devuelve true cuando la pulsación duró todo su tiempo o until se volvió true, y false cuando until nunca lo hizo. El botón siempre se suelta, también cuando until lanza un error; en la API async, until puede ser una función async, y cancelar la llamada también suelta el botón.
from clearcote import launch, press_and_hold
browser = launch(fingerprint="seed-123", humanize=True)
page = browser.new_page()
page.goto("https://example.com")
# hold until the button reports it is done (at most 15 s), then let go
done = page.press_and_hold(
"#hold", until=lambda: page.locator("#hold[data-state=done]").count() > 0
)
print(done) # False if the state never changed
# a fixed 4-second hold, pressed 20 px in from the left edge
page.locator("#confirm").press_and_hold(4000, position={"x": 20, "y": 10})
# a control inside an iframe
frame = page.frame_locator("iframe#widget")
frame.locator("#hold").press_and_hold(
until=lambda: frame.locator("#hold[data-state=done]").count() > 0
)
# the module function works on any Playwright page
press_and_hold(page.locator("#menu-item"), 1200)
browser.close()