Menschenähnliche Eingaben
Mit humanize führt das SDK Mausbewegungen, Klicks, Scrollen und Tippen auf menschenähnlichen Pfaden und mit menschenähnlichem Timing aus. showCursor blendet den Mauszeiger ein, damit Sie ihm zusehen können.
Menschenähnliche Eingaben (humanize & showCursor)
Übergeben Sie humanize, und alle Eingaben — Bewegen, Klicken, Ziehen, Scrollen und Tippen — laufen nach einem einheitlichen, menschenähnlichen Standard ab, sowohl auf Page-Ebene (page.click / hover / type / fill / mouse.* / keyboard.type) als auch auf Locator-Ebene (locator.click / type / fill / pressSequentially / dragTo / …). Bewegungen folgen einem leicht gewölbten kubischen Bézier-Pfad ab der letzten Cursorposition und werden als Min-Jerk-Summe von Teilbewegungen abgefahren (eine ballistische Hauptbewegung + eine Korrekturbewegung — das mehrgipflige Geschwindigkeitsprofil echter Zielbewegungen statt einer einzigen symmetrischen Glockenkurve), und alles wird als echte, vertrauenswürdige Events ausgelöst (isTrusted === true, und navigator.webdriver bleibt false). Auf Pro folgen Koordinaten-Klicks (mouse.click(x, y)) Bewegungen, die bei echten Menschen aufgezeichnet wurden; alles andere sowie jeder Klick auf dem offenen Build und mit „Kostenlos mit GitHub“ nutzt generierte Pfade. Mit showCursor blenden Sie einen Punkt ein, der der Bewegung folgt, sodass Sie zusehen können.
Weil Bewegungen nativen Input nutzen, bleibt eine mit mouse.down() gedrückte Taste während der Bewegung gehalten — down → move → up ist also echtes Ziehen mit gehaltener Taste (Bedienelemente wie Slider, die man an eine Position zieht, erhalten einen wirklich gedrückten Drag), und auch locator.dragTo ist menschenähnlich. Getippt wird Taste für Taste mit zufälligen Abständen zwischen den Anschlägen + Pausen an Wortgrenzen, gelegentlich einem korrigierten Vertipper und Key-Rollover: Bei manchen schnellen Tastenpaaren wird die nächste Taste gedrückt, bevor die vorherige losgelassen ist, mit einer Rate, die pro Identität feststeht (SDK 0.41.1). fill klickt in das Feld und tippt den Wert aus (ein Wert über 200 Zeichen wird zuerst angeklickt und dann in einem Zug eingefügt, damit große Füllvorgänge nicht dahinkriechen).
Gescrollt wird in ganzen Mausrad-Rasten, in kurzen Schüben mit gelegentlichen Lesepausen, und der Zeiger wird zuerst über den Inhalt bewegt, wenn er nicht schon dort ist. Ein Browser meldet jedes Wheel-Event als eine volle Raste, und eine echte Raste bewegt unter Windows 100 px, unter Linux 120 und unter macOS 40; die Raste folgt deshalb der Plattform, die die Seite meldet, und eine gewünschte Distanz wird auf die nächste Raste gerundet, mindestens eine: mouse.wheel(0, 800) scrollt bei einer Windows-Identität 800 px und bei einer Linux-Identität 840 (SDK 0.41.1).
Formulare (SDK 0.48.0)
fill richtet sich nach der Art des Felds. Text wird getippt, vorher nur dann mit gehaltenen Tasten geleert, wenn das Feld einen Wert hat, und das Ergebnis wird geprüft; ein Range-Slider wird genau auf den Wert gezogen; ein Datums-, Zeit-, Monats-, Wochen- oder Datum-Zeit-Feld wird Segment für Segment in der Reihenfolge getippt, in der der Browser es anzeigt. Ein Wert, den ein Feld nicht aufnehmen kann, löst wie bisher Playwrights eigenen Fehler aus.
selectOption öffnet ein Drop-down mit einem Klick, tippt den Anfang der Beschriftung der Option (Leerzeichen eingeschlossen) und bestätigt mit Enter, sodass die Seite eine vertrauenswürdige Änderung sieht, nicht eine pro Zeile; Zeilen, die sich nicht per Tippen erreichen lassen, werden mit einer gehaltenen Pfeiltaste angesteuert. Eine Listbox wird mit dem Mausrad gescrollt und per Klick auf Zeilen bedient, bei einer Mehrfachauswahl mit gehaltener Strg-Taste für die weiteren Zeilen. check / uncheck klicken nur, wenn sich der Zustand ändern muss.
Vertipper passieren nie in Passwort-, E-Mail-, Zahlen-, Telefon-, URL- oder Einmalcode-Feldern oder in einem Feld innerhalb eines Frames, und korrigiert wird nur, was tatsächlich angekommen ist. CLEARCOTE_HUMANIZE_TYPO_RATE legt die Rate pro Taste fest (Standard 0.02; 0 schaltet Vertipper ab). Jede Klickoption wird beachtet (Taste, Klickanzahl, Halten, Modifier, Position, force, trial), jeder Playwright-Locator funktioniert, und die Prüfung, ob ein Klickpunkt verdeckt ist, nutzt den eigenen Hit-Test des Browsers, sodass sich der Zeiger nie vor seinem Pfad bewegt und nichts zu früh gedrückt wird.
Timing und Treffsicherheit (SDK 0.49.0)
Mauspfade, Drags und ambient_motion / ambientMotion behalten die Dauer, mit der sie geplant wurden, auch auf einem ausgelasteten Rechner. Manche Pfade schießen über das Ziel hinaus und kehren zurück, mit einer Rate, die pro Identität feststeht, und ein Drag mit gehaltener Taste bleibt wenige Pixel um seine Linie, sodass ein Slider-Griff auf seiner Spur bleibt. Jeder Druck, den das SDK selbst ausführt, kommt nach einer kurzen Pause, sobald der Zeiger angekommen ist (40 bis 250 ms, typische Länge pro Identität fest).
Ein Bedienelement unter einer Ebene, die Klicks durchlässt (ein Verlauf, ein Icon, ein schwebendes Label), wird wie jedes andere geklickt. trial führt Playwrights Prüfungen aus und macht überhaupt keine Eingabe. Ein Feld mit maximaler Länge oder Eingabemaske (ein Ablaufdatum, eine Telefonnummer) wird einmal getippt, nie geleert und neu getippt, und Datums- und Zeitfelder werden mit demselben Tastentiming wie Text getippt. Fehler sind die von Playwright, genauso formuliert.
In Python, Node und .NET (.NET seit 0.58.0) kann ein Koordinaten-Klick (mouse.click(x, y)) von der Browser-Engine selbst abgefahren und gedrückt werden; auf Engines bis 154 r39 kommt dieser Druck etwa 10 ms nach dem Eintreffen des Zeigers, ohne die Pause. CLEARCOTE_HUMANIZE_ENGINE_CLICKS=off hält jeden Klick auf dem Pfad des SDK, und =all (Opt-in) schickt auch Selektor-Klicks an die Engine.
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()Drücken und halten
Manche Bedienelemente reagieren nur, solange die Taste gedrückt bleibt: ein Bestätigen-durch-Halten-Button, ein Menü auf langen Druck, ein Halten-Button, der sich erst füllt, bevor er annimmt. press_and_hold / pressAndHold / PressAndHoldAsync führt einen langen, menschenähnlichen Druck auf ein Element aus. Mit humanize steht es auf der Page (page.press_and_hold(selector)) und auf jedem Locator (locator.press_and_hold()) bereit, Frame-Locators eingeschlossen; die Modulfunktion press_and_hold(locator) funktioniert auf jeder Page. Die Async-API (clearcote.async_api) hat dieselben Namen, mit await.
Die Methode wartet, bis das Element sichtbar ist, und holt es ins Bild (mit dem menschenähnlichen Mausrad-Scrollen), führt den Zeiger zu einem von der Identität geprägten Punkt nahe der Mitte (oder zu position, relativ zur linken oberen Ecke des Elements wie in Playwright), hält kurz inne und drückt. Die Taste bleibt duration Millisekunden unten, standardmäßig jedes Mal neu 2,8 bis 3,8 s, oder bis until true zurückgibt: Das wird alle 100 ms abgefragt, duration ist dann die längste erlaubte Haltezeit (15 s, wenn nicht angegeben), und losgelassen wird nach einer menschlichen Reaktionszeit von 160 bis 350 ms, nicht im selben Moment, in dem sich die Bedingung ändert.
Solange die Taste gedrückt ist, bewegt eine ruhende Hand die Maus trotzdem ab und zu: ein spärliches Driften in ganzen Pixeln, nie mehr als 2 px vom Druckpunkt entfernt, jede Bewegung vertrauenswürdig und mit gemeldeter gedrückter Taste. tremor=False / tremor: false hält den Zeiger still. button wählt links, rechts oder Mitte, und timeout gibt an, wie lange auf die Sichtbarkeit des Elements gewartet wird. Der Aufruf gibt true zurück, wenn das Halten die volle Zeit lief oder until true wurde, und false, wenn until nie true wurde. Die Taste wird immer losgelassen, auch wenn until eine Ausnahme wirft; in der Async-API darf until eine async-Funktion sein, und auch ein Abbrechen des Aufrufs lässt die Taste los.
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()