DrissionPage，即 driver 和 session 組合而成的 page。是個基于 python 的 Web 自動化操作集成工具。

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

背景

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

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

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

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

特性和亮點

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

特性

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

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

3、極簡單但強大的元素定位語法，支持鏈式操作，代碼極其簡潔。

4、兩種模式提供一致的 API，使用體驗一致。

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

亮點功能

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

2、使用 ini 文件保存常用配置，自動調(diào)用，也提供便捷的設置 API，遠離繁雜的配置項。

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

4、強大的下載工具，操作瀏覽器時也能享受快捷可靠的下載功能。

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

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

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

8、鏈接參數(shù)默認自動生成Host和Referer屬性。

9、可隨時直接隱藏或顯示瀏覽器進程窗口，非 headless 或最小化。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 當前版本

更新內(nèi)容

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

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

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

運行速度更快

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

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

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

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

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

其它更新：

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

新增與WebPage配合的動作鏈接ActionChains

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

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

用存根文件取代類型注解

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

更新內(nèi)容

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