Entrada humanizada
Com humanize, o SDK executa movimentos do mouse, cliques, rolagem e digitação com trajetórias e ritmo de uma pessoa. O showCursor desenha o ponteiro para você acompanhar.
Entrada humanizada (humanize & showCursor)
Passe humanize e toda a entrada — mover, clicar, arrastar, rolar e digitar — segue um único padrão humanizado, tanto no nível da página (page.click / hover / type / fill / mouse.* / keyboard.type) quanto no nível do locator (locator.click / type / fill / pressSequentially / dragTo / …). Os movimentos seguem uma trajetória bézier cúbica levemente arqueada, construída a partir da última posição do cursor e percorrida como uma soma de submovimentos min-jerk (um movimento balístico primário + um corretivo — a velocidade com vários picos de um alcance real, e não um único sino simétrico), e tudo é disparado como eventos reais e confiáveis (isTrusted === true, e navigator.webdriver continua false). No Pro, cliques por coordenada (mouse.click(x, y)) seguem movimentos gravados de pessoas reais; todo o resto, e todo clique no build aberto e no Grátis com GitHub, usa trajetórias geradas. Adicione showCursor para desenhar um ponto que acompanha o movimento, para você ver o que acontece.
Como os movimentos usam entrada nativa, um botão pressionado com mouse.down() continua pressionado durante o movimento — então down → move → up é um arraste real com o botão pressionado (controles de arrastar até uma posição, como sliders, recebem um arraste de fato pressionado), e locator.dragTo também é humanizado. A digitação é feita tecla por tecla, com intervalos aleatórios entre teclas + pausas entre palavras, a correção ocasional de um erro de digitação e rollover de teclas: em alguns pares rápidos, a próxima tecla é pressionada antes de a anterior ser solta, numa taxa fixa por identidade (SDK 0.41.1). O fill clica no campo e digita o valor (um valor com mais de 200 caracteres recebe primeiro o clique e depois é inserido de uma vez, para que preenchimentos grandes não se arrastem).
A rolagem anda em entalhes inteiros da roda do mouse, em toques curtos com uma pausa de leitura ocasional, e antes leva o ponteiro para cima do conteúdo quando ele ainda não está lá. Um navegador reporta cada evento de roda como um entalhe completo, e um entalhe real move 100 px no Windows, 120 no Linux e 40 no macOS; por isso, o entalhe segue a plataforma que a página reporta, e uma distância pedida é arredondada para o entalhe mais próximo, no mínimo um: mouse.wheel(0, 800) rola 800 px numa identidade Windows e 840 numa identidade Linux (SDK 0.41.1).
Formulários (SDK 0.48.0)
fill segue o tipo de campo. O texto é digitado, com uma limpeza por teclas mantidas antes só quando o campo tem um valor, e o resultado é conferido; um controle deslizante de intervalo é arrastado até o valor exato; um campo de data, hora, mês, semana ou data e hora é digitado segmento por segmento na ordem em que o navegador os mostra. Um valor que o campo não comporta gera o próprio erro do Playwright, como antes.
selectOption abre um menu suspenso com um clique, digita o início do rótulo da opção (espaços incluídos) e confirma com Enter, de modo que a página vê uma única mudança confiável, não uma por linha; linhas que não podem ser alcançadas digitando são alcançadas com uma tecla de seta mantida. Uma caixa de listagem é rolada com a roda e escolhida com cliques nas linhas, com Ctrl mantido para as linhas extras de uma seleção múltipla. check / uncheck só clicam quando o estado precisa mudar.
Erros de digitação nunca acontecem em campos de senha, e-mail, número, telefone, URL ou código de uso único, nem em um campo dentro de um frame, e só é corrigido o que de fato chegou ao campo. CLEARCOTE_HUMANIZE_TYPO_RATE define a taxa por tecla (padrão 0.02; 0 desliga os erros). Toda opção de clique é respeitada (botão, número de cliques, segurar, modificadores, posição, force, trial), todo locator do Playwright funciona, e a verificação de que um ponto de clique não está coberto usa o próprio teste de acerto do navegador, então o ponteiro nunca se move antes do seu caminho e nada é pressionado cedo demais.
Tempo e mira (SDK 0.49.0)
Caminhos do mouse, arrastos e ambient_motion / ambientMotion mantêm a duração com que foram planejados, também em uma máquina ocupada. Alguns caminhos passam do alvo e voltam, com uma frequência fixa por identidade, e um arrasto com o botão pressionado fica a poucos pixels da sua linha, de modo que a alça de um controle deslizante continua no trilho. Cada pressionamento que o próprio SDK faz vem após uma breve pausa depois que o ponteiro chega (de 40 a 250 ms, duração típica fixa por identidade).
Um controle sob uma camada que deixa os cliques passarem (um gradiente, um ícone, um rótulo flutuante) é clicado como qualquer outro. trial executa as verificações do Playwright e não faz nenhuma entrada. Um campo com tamanho máximo ou máscara de entrada (uma data de validade, um número de telefone) é digitado uma vez, nunca limpo e digitado de novo, e campos de data e hora são digitados com o mesmo ritmo de teclas do texto. Os erros são os do Playwright, com a mesma redação.
Em Python, Node e .NET (.NET desde a 0.58.0), um clique por coordenadas (mouse.click(x, y)) pode ser percorrido e pressionado pelo próprio motor do navegador; em motores até 154 r39 esse pressionamento vem cerca de 10 ms depois que o ponteiro chega, sem a pausa. CLEARCOTE_HUMANIZE_ENGINE_CLICKS=off mantém todo clique no caminho do SDK, e =all (opcional) também envia ao motor os cliques por seletor.
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()Pressionar e segurar
Alguns controles só agem enquanto o botão continua pressionado: um botão de segurar para confirmar, um menu de toque longo, um botão de pressionar e segurar que se enche antes de aceitar. press_and_hold / pressAndHold / PressAndHoldAsync faz um único pressionamento longo e humanizado em um elemento. Com humanize, ele está na página (page.press_and_hold(selector)) e em todo locator (locator.press_and_hold()), frame locators incluídos; a função do módulo press_and_hold(locator) funciona em qualquer página. A API async (clearcote.async_api) tem os mesmos nomes, com await.
Ele espera o elemento ficar visível e o traz para a tela (com a rolagem humanizada da roda), leva o ponteiro até um ponto perto do centro com o formato da identidade (ou até position, relativo ao canto superior esquerdo do elemento, como no Playwright), faz uma breve pausa e pressiona. O botão fica pressionado por duration milissegundos, por padrão um valor novo entre 2,8 e 3,8 s, ou até until retornar true: ele é consultado a cada 100 ms, duration passa a ser o máximo que o pressionamento pode durar (15 s se não for informado), e o botão é solto após um tempo de reação humano de 160 a 350 ms, não no mesmo instante em que a condição mudou.
Enquanto o botão está pressionado, uma mão em repouso ainda move o mouse de vez em quando: uma deriva esparsa em pixels inteiros, nunca a mais de 2 px do ponto pressionado, cada movimento confiável e com o botão informado como pressionado. tremor=False / tremor: false mantém o ponteiro parado. button escolhe esquerdo, direito ou do meio, e timeout é quanto esperar o elemento ficar visível. A chamada retorna true quando o pressionamento durou o tempo todo ou until se tornou verdadeiro, e false quando until nunca se tornou. O botão é sempre solto, também quando until lança um erro; na API async, until pode ser uma função async, e cancelar a chamada também solta o botão.
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()