Chuyển đến nội dung

Nhập liệu giống người

Với humanize, SDK chạy thao tác di chuột, click, cuộn trang và gõ phím theo đường đi và nhịp độ giống người thật. showCursor vẽ con trỏ để bạn quan sát.

Nhập liệu giống người (humanize & showCursor)

Truyền humanize và mọi thao tác nhập liệu — di chuyển chuột, click, kéo, cuộn và gõ phím — đều chạy theo cùng một chuẩn mô phỏng người thật, ở cả cấp page (page.click / hover / type / fill / mouse.* / keyboard.type) lẫn cấp locator (locator.click / type / fill / pressSequentially / dragTo / …). Chuột di chuyển theo một đường cubic-bézier hơi cong, xuất phát từ vị trí con trỏ cuối cùng, và được đi theo mô hình min-jerk sum-of-sub-movements (một chuyển động chính dạng ballistic + một chuyển động hiệu chỉnh — vận tốc nhiều đỉnh như khi người thật với tay tới mục tiêu, chứ không phải một hình chuông đối xứng duy nhất), và mọi thứ được phát đi dưới dạng sự kiện thật, trusted (isTrusted === true, và navigator.webdriver vẫn là false). Trên Pro, các cú click theo tọa độ (mouse.click(x, y)) đi theo chuyển động được ghi lại từ người thật; mọi thao tác khác, cùng mọi cú click trên bản build mở và gói Miễn phí với GitHub, đều dùng quỹ đạo được sinh ra. Thêm showCursor để vẽ một chấm chạy theo chuyển động, giúp bạn quan sát.

Vì chuyển động dùng input native, một nút được nhấn bằng mouse.down() sẽ được giữ nguyên trong suốt quá trình di chuyển — nên down → move → up là một thao tác kéo có giữ nút thật sự (các control kéo để chọn vị trí như slider sẽ nhận được một thao tác kéo có nhấn giữ thật), và locator.dragTo cũng được humanize. Gõ phím diễn ra từng phím một, với khoảng cách giữa các phím ngẫu nhiên + các khoảng dừng ở ranh giới từ, thỉnh thoảng gõ nhầm rồi sửa lại, và key rollover: với một số cặp phím gõ nhanh, phím sau được nhấn xuống trước khi phím trước được nhả ra, với tần suất cố định theo từng danh tính (SDK 0.41.1). fill nhấp vào trường nhập rồi gõ nội dung ra (giá trị dài hơn 200 ký tự được nhấp vào trước rồi chèn một lần, để việc điền dữ liệu lớn không bị chậm).

Cuộn trang di chuyển theo từng nấc con lăn chuột trọn vẹn, thành những cú lướt ngắn và thỉnh thoảng dừng lại như đang đọc, đồng thời đưa con trỏ lên trên nội dung trước nếu nó chưa ở đó. Trình duyệt báo mỗi sự kiện wheel là một nấc đầy đủ, và một nấc thật di chuyển 100 px trên Windows, 120 trên Linux và 40 trên macOS, nên nấc cuộn đi theo nền tảng mà trang báo, và khoảng cách được yêu cầu sẽ được làm tròn tới nấc gần nhất, tối thiểu là một nấc: mouse.wheel(0, 800) cuộn 800 px trên một danh tính Windows và 840 trên một danh tính Linux (SDK 0.41.1).

Biểu mẫu (SDK 0.48.0)

fill làm theo loại trường. Văn bản được gõ, trước đó chỉ xóa bằng phím giữ khi trường đã có giá trị, và kết quả được kiểm tra; thanh trượt range được kéo tới đúng giá trị; trường ngày, giờ, tháng, tuần hoặc ngày-giờ được gõ từng phần theo thứ tự trình duyệt hiển thị. Giá trị mà trường không chứa được sẽ gây ra lỗi của chính Playwright, như trước.

selectOption mở danh sách thả xuống bằng một cú nhấp, gõ phần đầu nhãn của tùy chọn (kể cả dấu cách) và xác nhận bằng Enter, nên trang chỉ thấy một thay đổi tin cậy, không phải mỗi hàng một lần; các hàng không thể gõ tới được tiếp cận bằng một phím mũi tên được giữ. Hộp danh sách được cuộn bằng bánh xe và chọn bằng cách nhấp vào hàng, giữ Ctrl cho các hàng thêm của lựa chọn nhiều mục. check / uncheck chỉ nhấp khi trạng thái cần thay đổi.

Lỗi gõ không bao giờ xảy ra trong trường mật khẩu, e-mail, số, điện thoại, URL hoặc mã dùng một lần, hay trong trường nằm trong frame, và chỉ phần thực sự đã vào trường mới được sửa. CLEARCOTE_HUMANIZE_TYPO_RATE đặt tỉ lệ trên mỗi phím (mặc định 0.02; 0 tắt lỗi gõ). Mọi tùy chọn nhấp đều được tôn trọng (nút, số lần nhấp, giữ, phím bổ trợ, vị trí, force, trial), mọi locator của Playwright đều dùng được, và việc kiểm tra điểm nhấp có bị che hay không dùng chính phép thử va chạm (hit test) của trình duyệt, nên con trỏ không bao giờ di chuyển trước đường đi của nó và không có gì bị nhấn sớm.

Nhịp độ và độ chính xác (SDK 0.49.0)

Đường đi chuột, thao tác kéo và ambient_motion / ambientMotion giữ đúng thời lượng đã lên kế hoạch, kể cả trên máy đang bận. Một số đường đi vượt qua mục tiêu rồi quay lại, với tần suất cố định theo danh tính, và thao tác kéo khi giữ nút luôn nằm trong vài pixel quanh đường thẳng của nó, nên tay nắm thanh trượt vẫn ở trên rãnh. Mỗi lần nhấn do chính SDK thực hiện đến sau một khoảng dừng ngắn khi con trỏ đã tới nơi (40 đến 250 ms, độ dài điển hình cố định theo danh tính).

Một điều khiển nằm dưới một lớp cho phép cú nhấp xuyên qua (một dải màu, một biểu tượng, một nhãn nổi) được nhấp như mọi điều khiển khác. trial chạy các kiểm tra của Playwright và hoàn toàn không thực hiện thao tác nhập nào. Trường có độ dài tối đa hoặc mặt nạ nhập (ngày hết hạn, số điện thoại) chỉ được gõ một lần, không bao giờ xóa rồi gõ lại, và trường ngày giờ được gõ với cùng nhịp phím như văn bản. Lỗi là lỗi của chính Playwright, với cùng cách diễn đạt.

Trong Python, Node và .NET (.NET từ 0.58.0), một cú nhấp theo tọa độ (mouse.click(x, y)) có thể được chính engine trình duyệt di chuyển tới và nhấn; trên engine tới 154 r39, lần nhấn đó đến khoảng 10 ms sau khi con trỏ tới nơi, không có khoảng dừng. CLEARCOTE_HUMANIZE_ENGINE_CLICKS=off giữ mọi cú nhấp trên đường đi của SDK, và =all (tùy chọn) cũng gửi các cú nhấp theo selector tới 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()

Nhấn và giữ

Một số điều khiển chỉ phản hồi khi nút chuột còn được giữ: nút giữ để xác nhận, menu nhấn giữ lâu, nút nhấn và giữ phải đầy lên rồi mới chấp nhận. press_and_hold / pressAndHold / PressAndHoldAsync thực hiện một lần nhấn dài, giống người trên một phần tử. Với humanize, nó có trên page (page.press_and_hold(selector)) và trên mọi locator (locator.press_and_hold()), kể cả frame locator; hàm cấp module press_and_hold(locator) dùng được trên mọi page. API async (clearcote.async_api) có cùng tên, dùng với await.

Nó chờ phần tử hiển thị và đưa phần tử vào khung nhìn (bằng cách cuộn bánh xe giống người), lướt con trỏ tới một điểm gần tâm mang hình dạng của danh tính (hoặc tới position, tính từ góc trên bên trái của phần tử như trong Playwright), dừng một chút rồi nhấn. Nút được giữ trong duration mili giây, mặc định là một giá trị mới từ 2,8 đến 3,8 s, hoặc cho tới khi until trả về true: hàm này được hỏi mỗi 100 ms, khi đó duration là thời gian giữ tối đa (15 s nếu không truyền), và nút được nhả sau một độ trễ phản xạ của người từ 160 đến 350 ms, không phải ngay trong khoảnh khắc điều kiện thay đổi.

Trong khi nút đang được giữ, một bàn tay đang nghỉ vẫn thỉnh thoảng làm chuột xê dịch: một độ trôi thưa, theo từng pixel nguyên, không bao giờ cách điểm nhấn quá 2 px, mỗi lần di chuyển đều là sự kiện tin cậy với nút được báo là đang giữ. tremor=False / tremor: false giữ con trỏ đứng yên. button chọn nút trái, phải hoặc giữa, và timeout là thời gian chờ phần tử hiển thị. Lệnh gọi trả về true khi lần giữ chạy đủ thời gian hoặc until trở thành true, và false khi until không bao giờ thành true. Nút luôn được nhả, kể cả khi until ném lỗi; trong API async, until có thể là hàm async, và hủy lệnh gọi cũng nhả nút.

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()