pyppeteer最为核心类Page的接口方法(下)

重要:因为同步公号的文章格式很难保证,所以后面文章选择性在其他平台同步,欢迎移步公众号(Python之战),每日更新原汁原味!

在上一篇《pyppeteer最为核心类Page的接口方法》讲了大部分pyppeteer的Page类的接口,与selenium相比增强了与页面js的交互功能,同时增加了设备的伪装和模拟能力,一方是因为pyppeteer库是源于puppeteer,而puppeteer是Google提供了一个js库,本身和js的交互性强,所以在页面交互上更深入。

也正是因为更深的js交互,所以可以任意修改任何网站在源码中的爬虫检测方式,并且毫不费劲,关于淘宝登陆有一种实现方式是使用中间代理修改检测的js文件,使用pyppeteer之后就不用这么麻烦,可以直接将js代码写入网站加载的js文件中。

继续Page类的剩下一下方法:

协程方法 setJavaScriptEnabled(enabled:bool )**

设置JavaScript启用/禁用。

协程方法 setOfflineMode(enabled:bool )**

设置离线模式启用/禁用。

协程方法 setRequestInterception(value:bool )

启用/禁用请求拦截,激活请求拦截允许 Request类的 abort(), continue_()和 response()方法,这提供了修改页面发出的网络请求的功能。

协程方法 setUserAgent(userAgent:str )

设置要在此页面中使用的用户代理。

参数:

userAgent(str) - 要在此页面中使用的特定用户代理

协程方法 setViewport(viewport:dict )

设置视图,可用选项包括:

width (int):以像素为单位的页面宽度。

height (int):以像素为单位的页面高度。

deviceScaleFactor (float):默认为1.0。

isMobile(bool):默认为False。

hasTouch(bool):默认为False。

isLandscape(bool):默认为False。

协程方法 tap(select:str )

点击与之匹配的元素,类似手机上的触摸功能

参数:

selector(str) - 搜索要触摸的元素的选择器。

target

返回此页面创建的目标。

协程方法 title()

获取页面标题

touchscreen

获取Touchscreen对象

tracing

获取跟踪对象

协程方法 type(selector:str,text:str,options:dict = None, kwargs )**

在selector选择器处输入text,类似selenium的keys,如果没有元素匹配selector,报错PageError

url

获取此页面的URL

viewport

返回视图字典,返回与setViewport()相同的字典字段

waitFor(selectorOrFunctionOrTimeout:Union[str,int,float],options:dict = None, args,* kwargs )**

等待页面上匹配元素出现,注意第一个位置参数:

如果selectorOrFunctionOrTimeout是number(int或float),则将其视为超时(以毫秒为单位),这将返回将在超时后执行的future。

如果selectorOrFunctionOrTimeout是一个JavaScript函数字符串,则此方法是一个快捷方式waitForFunction()。

如果selectorOrFunctionOrTimeout是选择器字符串或xpath字符串,则此方法是waitForSelector()或 的快捷方式waitForXPath()。如果字符串以字符串开头//,则将字符串视为xpath。

Pyppeteer尝试自动检测功能或选择器,但有时会错过检测。如果不按预期工作,请使用waitForFunction()或waitForSelector()直接使用 。

参数:

selectorOrFunctionOrTimeout:xpath或函数字符串或timeout(毫秒)

args(Any) - 传递函数的参数。

可用选项:请参阅waitForFunction()或 waitForSelector()

返回:

返回等待的对象,该对象解析为成功值的JSHandle。

waitForFunction(pageFunction:str, options:dict = None, * args, ** kwargs )

等到函数执行完成并返回一个truthy值。

参数:

args(Any) - 传递给的参数pageFunction。

返回:

返回等待pageFunction返回真值时解析的等待对象 。它解决了一个 JSHandle真正的价值。

此方法接受以下选项:

polling(str | number):pageFunction 执行的间隔,默认为raf。如果polling是数字,则将其视为执行函数的间隔(以毫秒为单位)。如果polling是字符串,则它可以是以下值之一:

raf:不断执行pageFunction的 requestAnimationFrame回调。这是最紧密的轮询模式,适合观察样式变化。

mutation:执行pageFunction每个DOM突变。

timeout(int | float):等待的最长时间(以毫秒为单位)。默认为30000(30秒),通过0禁用超时。

协程方法 waitForNavigation(options:dict =None,** kwargs )**

等待导航,可用选项与goto()方法相同,这将返回Response当页面导航到一个新的URL或重载。当您运行将间接导致页面导航的代码时,它非常有用。如果由于使用History API而导航到其他锚点或导航 ,则导航将返回None。

navigationPromise = async.ensure_future(page.waitForNavigation())
await page.click('a.my-link')  # indirectly cause a navigation
await navigationPromise  # wait until navigation finishes
或者
await asyncio.wait([
    page.click('a.my-link'),
    page.waitForNavigation(),
])

注意:使用History API更改URL被视为导航。

协程方法 waitForRequest(urlOrPredicate:Union [str,Callable [[pyppeteer.network_manager.Request],bool]],options:Dict [KT,VT] = None, kwargs)**

等待请求

参数:urlOrPredicate - 要等待的URL或函数。

此方法接受以下选项:timeout(int | float):最长等待时间(以毫秒为单位),默认为30秒,传递0以禁用超时。

firstRequest = await page.waitForRequest('http://example.com/resource')
finalRequest = await page.waitForRequest(lambda req: req.url == 'http://example.com' and req.method == 'GET')
return firstRequest.url

协程方法 waitForResponse(urlOrPredicate:Union [str,Callable [[pyppeteer.network_manager.Response],bool]],options:Dict [KT,VT] = None, kwargs)**

等待响应

参数:urlOrPredicate - 要等待的URL或函数。

此方法接受以下选项:timeout(int | float):最长等待时间(以毫秒为单位),默认为30秒,传递0以禁用超时。

firstResponse = await page.waitForResponse('http://example.com/resource')
finalResponse = await page.waitForResponse(lambda res: res.url == 'http://example.com' and res.status == 200)
return finalResponse.ok

waitForSelector(selector:str, options:dict = None, ** kwargs )

等待页面上出现匹配的元素,如果在调用方法selector已经存在,该方法将立即返回。如果在timeout等待的毫秒之后没有出现,则该函数将引发错误。

参数:selector(str) - 要等待的元素的选择器。

返回:返回等待的对象,该对象在将选择器字符串指定的元素添加到DOM时解析。

选项:

visible(bool):等待元素存在于DOM中并且可见; 即没有或 CSS属性。默认为。display: nonevisibility: hiddenFalse

hidden(bool):等待在DOM中找不到元素或隐藏元素,即具有或CSS属性。默认为。display: nonevisibility: hiddenFalse

timeout(int | float):等待的最长时间(以毫秒为单位)。默认为30000(30秒),为0禁用超时。

waitForXPath(xpath:str,options:dict = None, kwargs )**

等到xpath页面上出现匹配的元素,如果调用方法的时刻xpath已经存在,则该方法将立即返回;如果在timeout等待毫秒后没有出现xpath ,则该函数将引发异常。

参数:xpath(str) - 要等待的元素的[xpath]。

返回:返回等待由xpath字符串指定的元素添加到DOM时解析的等待对象。

选项:

visible(布尔):等待元素存在于DOM并是可见的,即,没有或 CSS属性。默认为。display: nonevisibility: hiddenFalse

hidden(bool):等待在DOM中找不到元素或隐藏元素,即具有或CSS属性。默认为。display: nonevisibility: hiddenFalse

timeout(int | float):等待的最长时间(以毫秒为单位)。默认为30000(30秒),为0禁用超时。

workers

获取此页面的所有执行线程,web workers概念是解决客户端JavaScript无法多线程的问题,其定义的worker是指代码的并行线程,不过web worker处于一个自包含的环境中,无法访问主线程的window对象和document对象。

image
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,233评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,013评论 1 291
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,030评论 0 241
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,827评论 0 204
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,221评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,542评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,814评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,513评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,225评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,497评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,998评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,342评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,986评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,055评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,812评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,560评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,461评论 2 266

推荐阅读更多精彩内容