Skip to content

从 Selenium 和 Playwright 迁移

如果你已经在做浏览器自动化，你所掌握的大部分内容都可以沿用。本页把你每天使用的操作对应到它们的 Pydoll 等价写法，并指出 Pydoll 在哪些地方工作方式不同。

无论你从哪个工具而来，有三件事都会改变：

  • 没有 webdriver 或捆绑的浏览器。 Pydoll 通过 DevTools Protocol 驱动你机器上已有的 Chrome 或 Edge。没有需要安装或版本匹配的 chromedriver。
  • 没有显式等待。 find() 和 query() 自己等待元素，所以 WebDriverWait 和 expected_conditions 那一套繁琐操作就没有了。
  • 同步或异步，由你选择。 从 pydoll.sync 导入即可使用阻塞调用，或从 pydoll 导入同一套 API 并 await 它。下面的表格展示的是异步形式；同步形式只需去掉 await，并用 with 代替 async with。第一次接触异步？见 实践中的异步 Python。

从 Selenium 迁移

任务 Selenium Pydoll
启动 driver = webdriver.Chrome() async with Chrome() as browser: tab = await browser.start()
打开一个 URL driver.get(url) await tab.go_to(url)
按 id 查找 driver.find_element(By.ID, 'q') await tab.find(id='q')
按 CSS 查找 driver.find_element(By.CSS_SELECTOR, '.item') await tab.query('.item')
按 XPath 查找 driver.find_element(By.XPATH, '//a') await tab.query('//a')
按文本查找 driver.find_element(By.XPATH, "//*[text()='Login']") await tab.find(text='Login')
查找多个 driver.find_elements(By.CSS_SELECTOR, '.item') await tab.query('.item', find_all=True)
等待某个元素 WebDriverWait(driver, 10).until(EC.presence_of_element_located(...)) await tab.find(id='q', timeout=10)
点击 el.click() await el.click()
输入 el.send_keys('text') await el.type_text('text')
按一个键 el.send_keys(Keys.ENTER) await tab.keyboard.press(Key.ENTER)
读取文本 el.text await el.text()
读取一个属性 el.get_attribute('href') el.get_attribute('href')
截图 driver.save_screenshot('s.png') await tab.take_screenshot('s.png')
运行 JavaScript driver.execute_script('return document.title') await tab.execute_script('return document.title')
退出 driver.quit() 离开 async with 代码块，或 await browser.stop()

一个 Selenium 登录流程及其 Pydoll 版本：

# Selenium
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

driver = webdriver.Chrome()
driver.get('https://quotes.toscrape.com/login')
driver.find_element(By.ID, 'username').send_keys('tester')
driver.find_element(By.ID, 'password').send_keys('secret')
driver.find_element(By.CSS_SELECTOR, "input[type='submit']").click()
WebDriverWait(driver, 5).until(EC.presence_of_element_located((By.LINK_TEXT, 'Logout')))
driver.quit()

# Pydoll

from pydoll.sync import Chrome

def main():
    with Chrome() as browser:
        tab = browser.start()
        tab.go_to('https://quotes.toscrape.com/login')

        tab.find(id='username').type_text('tester')
        tab.find(id='password').type_text('secret')
        tab.find(tag_name='input', type='submit').click()

        tab.find(text='Logout', timeout=5)

main()

# Pydoll
import asyncio

from pydoll import Chrome


async def main():
    async with Chrome() as browser:
        tab = await browser.start()
        await tab.go_to('https://quotes.toscrape.com/login')

        await (await tab.find(id='username')).type_text('tester')
        await (await tab.find(id='password')).type_text('secret')
        await (await tab.find(tag_name='input', type='submit')).click()

        await tab.find(text='Logout', timeout=5)

asyncio.run(main())

get_attribute 是同步的

与 Selenium 不同（在 Selenium 中，元素上的一切都是一次网络往返），Pydoll 从它已经定位到的元素上读取属性，所以 get_attribute() 是一个普通方法，无需 await。文本仍然需要 await（await el.text()）。

从 Playwright 迁移

有两条路可走，第一条今天就能走，第二条随时都行：

  • 保留你的代码。 改一行导入，脚本就跑在 Pydoll 的 CDP 连接上，Playwright 的定位器、自动等待、路由和事件原样保留。参见带上你的 Playwright 脚本；Playwright API 页面列出了哪些完整、部分和缺失。
  • 改写成 Pydoll 自己的 API。 下表对应了各个操作。只有 Pydoll 才有的功能都在这里：类型化提取、Turnstile 处理、指纹配置、拟人化输入、CDP 事件。
任务 Playwright Pydoll
启动 browser = await p.chromium.launch(); page = await browser.new_page() async with Chrome() as browser: tab = await browser.start()
打开一个 URL await page.goto(url) await tab.go_to(url)
按 CSS 查找 page.locator('.item') await tab.query('.item')
按文本查找 page.get_by_text('Login') await tab.find(text='Login')
按 role/label 查找 page.get_by_role('button') await tab.find(tag_name='button')
查找多个 page.locator('.item').all() await tab.query('.item', find_all=True)
点击 await page.locator('.btn').click() await (await tab.find(class_name='btn')).click()
填写一个输入框 await page.fill('#q', 'text') await (await tab.find(id='q')).type_text('text')
读取文本 await page.locator('.title').text_content() await (await tab.find(class_name='title')).text()
读取一个属性 await loc.get_attribute('href') el.get_attribute('href')
新建标签页 await context.new_page() await browser.new_tab()
截图 await page.screenshot(path='s.png') await tab.take_screenshot('s.png')
关闭 await browser.close() 离开 async with 代码块，或 await browser.stop()

两者都是异步的，也都会自动等待，所以迁移大多只是重命名。主要的概念差异在于一次查找返回的是什么：

  • Playwright 的 locator 是惰性的：每次你对它进行操作时，它都会重新解析元素。
  • Pydoll 的 find() / query() 返回一个当场解析一次的 WebElement。如果页面替换了该元素，就再次调用 find()。
# Playwright
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto('https://quotes.toscrape.com')
    quote = page.locator('.quote .text').first.text_content()
    print(quote)
    browser.close()

# Playwright
from playwright.async_api import async_playwright

async with async_playwright() as p:
    browser = await p.chromium.launch()
    page = await browser.new_page()
    await page.goto('https://quotes.toscrape.com')
    quote = await page.locator('.quote .text').first.text_content()
    print(quote)
    await browser.close()

# Pydoll

from pydoll.sync import Chrome

def main():
    with Chrome() as browser:
        tab = browser.start()
        tab.go_to('https://quotes.toscrape.com')

        quote = tab.query('.quote .text')
        print(quote.text())

main()

# Pydoll
import asyncio

from pydoll import Chrome


async def main():
    async with Chrome() as browser:
        tab = await browser.start()
        await tab.go_to('https://quotes.toscrape.com')

        quote = await tab.query('.quote .text')
        print(await quote.text())

asyncio.run(main())

你从 Playwright 保留的行为，以及新获得的一个

自动等待和异步会直接沿用过来。Pydoll 新增的是点击和打字上的 humanize=True，它让光标沿着弯曲的轨迹移动，并以可变的节奏打字。见 拟人化交互。

下一步