pyppeteer的Browser類及其BrowserContext類

在昨天的文章中《Python中與selenium齊名的pyppeteer庫》我們對pyppeteer做了一個(gè)大致的介紹火鼻,后面將pyppeteer作為一個(gè)系列來講,大致按照文檔的思路來陶因,再配合一些實(shí)踐代碼,來達(dá)到深入理解的目的病毡。

啟動(dòng)器

import asyncio
from pyppeteer import launch

async def main():
browser = await launch()
page = await browser.newPage()
await page.goto('http://example.com')
await page.screenshot({'path': 'example.png'})
await browser.close()

asyncio.get_event_loop().run_until_complete(main())

其中l(wèi)aunch是啟動(dòng)器祭务,用來啟動(dòng)瀏覽器并返回browser類,launch是屬于launcher類丁溅,該類還有另一種啟動(dòng)方式connect唤蔗,connect用于連接一個(gè)已經(jīng)打開的瀏覽器,可以在奔潰后重連窟赏,這個(gè)比selenium進(jìn)步很多妓柜。
pyppeteer.launcher.connect(options: dict = None, **kwargs) → pyppeteer.browser.Browser

連接到現(xiàn)有的chrome,browserWSEndpoint選項(xiàng)是連接到chrome的必要條件饰序。格式是ws://{host}:{port}/devtools/browser/<id>领虹,這個(gè)值可以得到wsEndpoint。

可用選項(xiàng)包括:

browserWSEndpoint(str):要連接的瀏覽器websocket端點(diǎn)求豫。(必填)
ignoreHTTPSErrors(bool):是否忽略HTTPS錯(cuò)誤塌衰。默認(rèn)為 False。
slowMo (int | float):按指定的毫秒數(shù)減慢pyppeteer的速度蝠嘉。
logLevel(int | str):用于打印日志的日志級別最疆。默認(rèn)值與根記錄器相同。
loop(asyncio.AbstractEventLoop):事件循環(huán)(實(shí)驗(yàn))蚤告。

connect方法需要一個(gè)必須參數(shù)browserWSEndpoint努酸,這個(gè)參數(shù)通過browser的wsEndpoint屬性獲得:
brwoser.wsEndpoint
'ws://127.0.0.1:3533/devtools/browser/6687308b-2c43-4ccb-9464-1d2c1fec7eb5'

至于啟動(dòng)器launcher的launch配置參數(shù)在《Python中與selenium齊名的pyppeteer庫》中已經(jīng)詳細(xì)說明。
另一個(gè)launcher的方法是launcher.executablePath()杜恰,可執(zhí)行瀏覽器的默認(rèn)路徑获诈。
from pyppeteer import launcher
launcher.executablePath()
'C:\Users\Administrator\AppData\Local\pyppeteer\pyppeteer\local-chromium\575458\chrome-win32\chrome.exe'

Browser類

通過啟動(dòng)器我們可以創(chuàng)建一個(gè)瀏覽器類Browser,比selenium復(fù)雜的地方是多了Browser類心褐,具體的頁面操作是在Browser的newPage方法上的舔涎,但是Browser也提供了一些優(yōu)勢,與瀏覽器進(jìn)程的交互逗爹、多個(gè)頁面對象的上文管理亡嫌、模擬瀏覽器的基礎(chǔ)設(shè)置、創(chuàng)建隱身瀏覽器掘而;Browser就相當(dāng)于一個(gè)管家挟冠,管理具體工作的頁面,這也是pyppeteer的優(yōu)勢袍睡。
它具有下列一些方法和屬性:

browserContexts
返回所有打開的瀏覽器上下文的列表知染。在新創(chuàng)建的瀏覽器中,這將返回單個(gè)實(shí)例 [BrowserContext]

close()
關(guān)閉連接并終止瀏覽器進(jìn)程斑胜。

createIncogniteBrowserContext()
[已棄用]舊方法控淡。
改用createIncognitoBrowserContext()方法色瘩。
創(chuàng)建一個(gè)新的隱身瀏覽器上下文,不會(huì)與其他瀏覽器上下文共享cookie /緩存逸寓。
browser = await launch()

Create a new incognito browser context.

context = await browser.createIncognitoBrowserContext()

Create a new page in a pristine context.

page = await context.newPage()

Do stuff

await page.goto('https://example.com')
...

image

disconnect()
斷開瀏覽器,斷開不等于關(guān)閉居兆,斷開后還可以通過connect連接

newPage()
在此瀏覽器上創(chuàng)建新頁面并返回其對象。

pages()
獲取此瀏覽器的所有頁面竹伸。此處不會(huì)列出不可見的頁面泥栖,例如
background_page,可以通過pyppeteer.target.Target.page()查看勋篓。

process
返回此瀏覽器的進(jìn)程吧享。
如果創(chuàng)建瀏覽器的是實(shí)例pyppeteer.launcher.connect(),則返回None譬嚣。
brwoser.process
<subprocess.Popen object at 0x02E03190>

targets()
獲取瀏覽器中所有活動(dòng)的頁面列表钢颂。在多個(gè)瀏覽器上下文的情況下,該方法將返回包含所有瀏覽器上下文中的所有目標(biāo)的列表拜银。

userAgent()
返回瀏覽器的原始用戶代理殊鞭。注意頁面類可以設(shè)置代理setUserAgent()。

version()
獲取瀏覽器的版本尼桶。

wsEndpoint
返回websocket端點(diǎn)url操灿。
brwoser.wsEndpoint
'ws://127.0.0.1:4636/devtools/browser/ccb4bd48-4572-468d-8549-1f4f27da8737'

BrowserContext 類

基類:pyee.EventEmitter
BrowserContext用于創(chuàng)建多個(gè)獨(dú)立的瀏覽器會(huì)話,啟動(dòng)瀏覽器時(shí)泵督,它默認(rèn)使用一個(gè)BrowserContext趾盐。browser.newPage()在默認(rèn)瀏覽器上下文中創(chuàng)建頁面,如果頁面打開另一個(gè)頁面小腊,例如通過window.open調(diào)用救鲤,則彈出窗口也屬于初始化創(chuàng)建的瀏覽器上下文。
可以通過browser.createIncognitoBrowserContext()再創(chuàng)建一個(gè)隱身瀏覽器進(jìn)程秩冈,“隱身”瀏覽器上下文不會(huì)將任何數(shù)據(jù)寫入磁盤本缠。

Create new incognito browser context

context = await browser.createIncognitoBrowserContext()

Create a new page inside context

page = await context.newPage()

... do stuff with page ...

await page.goto('https://example.com')

Dispose context once it's no longer needed

await context.close()

該類具備下列方法:

close()
關(guān)閉瀏覽器上下文,將關(guān)閉屬于瀏覽器上下文的所有頁面。

isIncognite()
[已棄用]改用isIncognito()方法漩仙。

isIncognito()
返回BrowserContext是否隱身搓茬。

newPage()
在瀏覽器上下文中創(chuàng)建新頁面犹赖。

targets()
返回瀏覽器上下文中所有活動(dòng)目標(biāo)的列表队他。

BrowserContext 和Browser都是用于創(chuàng)建一個(gè)瀏覽器對象,前者是創(chuàng)建一個(gè)隱身瀏覽器峻村,創(chuàng)建瀏覽器對象之后進(jìn)而創(chuàng)建Page對象麸折,頁面的所有操作都在Page對象上,下一節(jié)將講Page對象粘昨。

重要:因?yàn)橥焦柕奈恼赂袷胶茈y保證垢啼,所以后面文章選擇性在其他平臺同步窜锯,歡迎移步公眾號(Python之戰(zhàn)),每日更新原汁原味!

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末芭析,一起剝皮案震驚了整個(gè)濱河市锚扎,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌馁启,老刑警劉巖驾孔,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異惯疙,居然都是意外死亡翠勉,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進(jìn)店門霉颠,熙熙樓的掌柜王于貴愁眉苦臉地迎上來对碌,“玉大人,你說我怎么就攤上這事蒿偎⌒嗝牵” “怎么了?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵诉位,是天一觀的道長华坦。 經(jīng)常有香客問我,道長不从,這世上最難降的妖魔是什么惜姐? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮椿息,結(jié)果婚禮上歹袁,老公的妹妹穿的比我還像新娘。我一直安慰自己寝优,他們只是感情好条舔,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著乏矾,像睡著了一般孟抗。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上钻心,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天凄硼,我揣著相機(jī)與錄音,去河邊找鬼捷沸。 笑死摊沉,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的痒给。 我是一名探鬼主播说墨,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼骏全,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了尼斧?” 一聲冷哼從身側(cè)響起姜贡,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎棺棵,沒想到半個(gè)月后鲁豪,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡律秃,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年爬橡,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片棒动。...
    茶點(diǎn)故事閱讀 39,690評論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡糙申,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出船惨,到底是詐尸還是另有隱情柜裸,我是刑警寧澤,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布粱锐,位于F島的核電站疙挺,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏怜浅。R本人自食惡果不足惜铐然,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望恶座。 院中可真熱鬧搀暑,春花似錦、人聲如沸跨琳。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽脉让。三九已至桂敛,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間溅潜,已是汗流浹背术唬。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留伟恶,地道東北人碴开。 一個(gè)月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓毅该,卻偏偏與公主長得像博秫,于是被迫代替她去往敵國和親潦牛。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內(nèi)容

  • 問答題47 /72 常見瀏覽器兼容性問題與解決方案挡育? 參考答案 (1)瀏覽器兼容問題一:不同瀏覽器的標(biāo)簽?zāi)J(rèn)的外補(bǔ)...
    _Yfling閱讀 13,748評論 1 92
  • puppeteer進(jìn)階之12306買票 開始準(zhǔn)備工作 安裝 cnpm i puppeteer 因?yàn)橐褂玫絘syn...
    Winterdog閱讀 6,550評論 0 5
  • 第一部分 HTML&CSS整理答案 1. 什么是HTML5巴碗? 答:HTML5是最新的HTML標(biāo)準(zhǔn)。 注意:講述HT...
    kismetajun閱讀 27,474評論 1 45
  • 近三年來,隨著經(jīng)濟(jì)持續(xù)下行和經(jīng)濟(jì)結(jié)構(gòu)深度調(diào)整母赵,大量的中小企業(yè)倒閉逸爵,銀行不良貸款規(guī)模急劇攀升,作為為中小企業(yè)提供...
    老羅雜貨鋪閱讀 2,749評論 0 0
  • 自從城先生搬了校區(qū)以后凹嘲,遠(yuǎn)離了小南莊师倔,住進(jìn)了城里,我們也就開始了“異地戀”周蹭。大概是城里生活好趋艘,把他養(yǎng)得太好...
    阿念和阿書閱讀 291評論 5 4