DrissionPage，即 driver 和 session 組合而成的 page。是個(gè)基于 python 的 Web 自動(dòng)化操作集成工具。

它用 POM 模式封裝了頁面和元素常用的方法，自帶一套簡潔直觀優(yōu)雅的元素定位語法，實(shí)現(xiàn)了瀏覽器和 requests 之間的無縫切換，可兼顧瀏覽器自動(dòng)化的便利性和 requests 的高效率，更棒的是，它的使用方式非常簡潔和人性化，代碼量少，對新手友好。

背景

用 requests 做數(shù)據(jù)采集面對要登錄的網(wǎng)站時(shí)，要分析數(shù)據(jù)包、JS 源碼，構(gòu)造復(fù)雜的請求，往往還要應(yīng)付驗(yàn)證碼、JS 混淆、簽名參數(shù)等反爬手段，門檻較高。若數(shù)據(jù)是由 JS 計(jì)算生成的，還須重現(xiàn)計(jì)算過程，體驗(yàn)不好，開發(fā)效率不高。

使用瀏覽器，可以很大程度上繞過這些坑，但瀏覽器運(yùn)行效率不高。因此，這個(gè)庫將它們合而為一，不同須要時(shí)切換相應(yīng)模式，并提供一種人性化的使用方法，提高開發(fā)和運(yùn)行效率。

除了合并兩者，本庫還以網(wǎng)頁為單位封裝了常用功能，提供非常簡便的操作和語句，在用于網(wǎng)頁自動(dòng)化操作時(shí)，減少考慮細(xì)節(jié)，專注功能實(shí)現(xiàn)，使用更方便。

一切從簡，盡量提供簡單直接的使用方法，對新手更友好。

特性和亮點(diǎn)

作者踩過無數(shù)坑，總結(jié)出的經(jīng)驗(yàn)全寫到這個(gè)庫里了。內(nèi)置了 N 多實(shí)用功能，對常用功能作了整合和優(yōu)化。

特性

1、代碼高度集成，以簡潔的代碼為第一追求。

2、頁面對象可在瀏覽器和 requests 間任意切換，保留登錄狀態(tài)。

3、極簡單但強(qiáng)大的元素定位語法，支持鏈?zhǔn)讲僮?，代碼極其簡潔。

4、兩種模式提供一致的 API，使用體驗(yàn)一致。

5、人性化設(shè)計(jì)，集成眾多實(shí)用功能，大大降低開發(fā)工作量。

亮點(diǎn)功能

1、每次運(yùn)行程序可以反復(fù)使用已經(jīng)打開的瀏覽器。如手動(dòng)設(shè)置網(wǎng)頁到某個(gè)狀態(tài)，再用程序接管，或手動(dòng)處理登錄，再用程序爬內(nèi)容。無須每次運(yùn)行從頭啟動(dòng)瀏覽器，超級方便。

2、使用 ini 文件保存常用配置，自動(dòng)調(diào)用，也提供便捷的設(shè)置 API，遠(yuǎn)離繁雜的配置項(xiàng)。

3、極致簡明的定位語法，支持直接按文本定位元素，支持直接獲取前后兄弟元素和父元素等。

4、強(qiáng)大的下載工具，操作瀏覽器時(shí)也能享受快捷可靠的下載功能。

5、下載工具支持多種方式處理文件名沖突、自動(dòng)創(chuàng)建目標(biāo)路徑、斷鏈重試等。

6、訪問網(wǎng)址帶自動(dòng)重試功能，可設(shè)置間隔和超時(shí)時(shí)間。

7、訪問網(wǎng)頁能自動(dòng)識別編碼，無須手動(dòng)設(shè)置。

8、鏈接參數(shù)默認(rèn)自動(dòng)生成Host和Referer屬性。

9、可隨時(shí)直接隱藏或顯示瀏覽器進(jìn)程窗口，非 headless 或最小化。

10、可自動(dòng)下載合適版本的 chromedriver，免去麻煩的配置。

11、d 模式查找元素內(nèi)置等待，可任意設(shè)置全局等待時(shí)間或單次查找等待時(shí)間。

12、點(diǎn)擊元素集成 js 點(diǎn)擊方式，一個(gè)參數(shù)即可切換點(diǎn)擊方式。

13、點(diǎn)擊支持失敗重試，可用于保證點(diǎn)擊成功、判讀網(wǎng)頁遮罩層是否消失等。

14、輸入文本能自動(dòng)判斷是否成功并重試，避免某些情況下輸入或清空失效的情況。

15、d 模式下支持全功能的 xpath，可直接獲取元素的某個(gè)屬性，selenium 原生無此功能。

16、支持直接獲取shadow-root，和普通元素一樣操作其下的元素。

17、支持直接獲取after和before偽元素的內(nèi)容。

18、可以在元素下直接使用 > 以 css selector 方式獲取當(dāng)前元素直接子元素。原生不支持這種寫法。

19、可簡單地使用 lxml 來解析 d 模式的頁面或元素，爬取復(fù)雜頁面數(shù)據(jù)時(shí)速度大幅提高。

20、輸出的數(shù)據(jù)均已轉(zhuǎn)碼及處理基本排版，減少重復(fù)勞動(dòng)。

21、可方便地與 selenium 或 requests 原生代碼對接，便于項(xiàng)目遷移。

22、使用 POM 模式封裝，可直接用于測試，便于擴(kuò)展。

23、d 模式配置可同時(shí)兼容debugger_address和其它參數(shù)，原生不能兼容。

24、還有很多這里不一一列舉…………

 當(dāng)前版本

更新內(nèi)容

推出WebPage，重新開發(fā)底層邏輯，擺脫對 selenium 的依賴，增強(qiáng)了功能，提升了運(yùn)行效率。支持 chromium 內(nèi)核的瀏覽器（如 chrome 和 edge）。比MixPage有以下優(yōu)點(diǎn)：

無 webdriver 特征，不會被網(wǎng)站識別

無需為不同版本的瀏覽器下載不同的驅(qū)動(dòng)

運(yùn)行速度更快

可以跨 iframe 查找元素，無需切入切出

把 iframe 看作普通元素，獲取后可直接在其中查找元素，邏輯更清晰

可以同時(shí)操作瀏覽器中的多個(gè)標(biāo)簽頁，即使標(biāo)簽頁為非激活狀態(tài)

可以直接讀取瀏覽器緩存來保持圖片，無需用 GUI 點(diǎn)擊保存

可以對整個(gè)網(wǎng)頁截圖，包括視口外的部分（90以上版本瀏覽器支持）

其它更新：

增加ChromiumTab和ChromiumFrame類用于處理 tab 和 frame 元素

新增與WebPage配合的動(dòng)作鏈接ActionChains

瀏覽器啟動(dòng)配置實(shí)現(xiàn)對插件的支持

瀏覽器啟動(dòng)配置實(shí)現(xiàn)對experimental_options的prefs屬性支持

用存根文件取代類型注解

其它優(yōu)化和問題修復(fù)

更新內(nèi)容

在3.2基礎(chǔ)上加入大量功能，重構(gòu)底層。