Page类是pyppeteer的核心，其价值就犹如selenium的driver，具体的页面操作都在Page类上；Page与driver比较最具优势的是和js的交互，可以修改本地js、css，也可以给页面添加js函数，甚至添加自定义函数到浏览器的windows属性中，也有js拦截相关的设置，更有终端模拟设置，这些功能是比driver更为强大的功能，但是也有一些劣势如页面超时方面比driver弱、选择器不简洁等问题。
页面类：Page 基类:pyee.EventEmitter
此类提供了与单个chrome选项卡进行交互的方法。一个 Browser对象可能有多个Page对象。
选择器
Page类选择器相关方法有5个，并且这五个都有别名，分别是：
J()别名querySelector()
JJ()别名querySelectorAll()
JJeval()别名querySelectorAllEval()
Jeval()别名querySelectorEval()
Jx()别名xpath()
协程函数 querySelector(selector:str)
获取匹配的元素的selector
参数:搜索元素的选择器字符串。
返回[ElementHandle]或者None。
协程函数 querySelectorAll(selector:str)
获取匹配的所有元素selector作为列表。
参数:搜索元素的选择器
返回列表或返回空列表。
协程函数 querySelectorAllEval(selector:str，pageFunction:str，*args)
对所有匹配元素执行js
参数:
selector(str)-选择器。
pageFunction(str)-要在浏览器上运行的JavaScript函数的字符串，此函数将匹配元素的数组作为第一个参数。
args(Any)-传递给pageFunction的其他参数。
协程函数 querySelectorEval(selector:str，pageFunction:str，*args)
对匹配的元素执行js函数
参数:
selector(str)-定位的选择器字符串。
pageFunction(str)-要在浏览器上计算的JavaScript函数的字符串，此函数采用与选择器匹配的元素作为第一个参数。
args(Any)-传递给pageFunction的参数。
如果没有元素匹配，则此方法会引发错误selector
协程函数 addScriptTag(options: Dict[KT, VT] = None,**kwargs)
将脚本标记添加到此页面
其中需要一个必须参数url，path或content
url （字符串）：要添加的脚本的URL。
path （字符串）：要添加的本地JavaScript文件的路径。
content （字符串）：要添加的JavaScript字符串。
type（字符串）：脚本类型，使用module以加载一个JavaScript ES6模块。
返回ElementHandle对象
协程函数 addStyleTag(options: Dict[KT, VT] = None, **kwargs)
将样式或链接标记添加到此页面
需要一个必须参数url，path或content
url （字符串）：要添加的链接标记的URL。
path （字符串）：要添加的本地CSS文件的路径。
content （字符串）：要添加的CSS字符串。
返回添加标签后的ElementHandle
协程函数 authenticate(credentials: Dict[str, str])
提供http身份验证的凭据
credentials为None或dict含有有username和 password的字段字典
协程函数 bringToFront()
将页面置于前面（激活选项卡）
browser
获取该页面所属的浏览器对象
协程函数 click(selector: str, options: dict = None, **kwargs)
单击匹配selector的元素
将先获取selector元素，在视图底部，将滚动到视图中，然后使用mouse单击元素的中心，如果没有匹配selector，则该方法会引发 PageError
可用选项包括：
button（STR）：，left，right或middle，默认为 left。
clickCount （int）：默认为1。
delay（int | float）：等待时间mousedown和 mouseup以毫秒为单位默认为0。
注意
如果此方法触发元素并且存在其他的的点击事件，则容易产生混乱的判断，单击并等待的正确模式如下：
await asyncio.gather(
page.waitForNavigation(waitOptions),
page.click(selector, clickOptions),
)
协程函数 close(options: Dict[KT, VT] = None, **kwargs)
作用是关闭此页面。
可用选项：
runBeforeUnload（bool）：默认为False，是否运行页面的处理函数
注意
如果runBeforeUnload传递为True，则beforeunload 可以执行弹出对话框，可以通过页面的dialog事件手动处理 。
协程函数 content()
获取页面的完整HTML源码
协程函数 cookies（* urls ）
获取cookie，如果未指定URL，则此方法返回当前页面URL的cookie，如果指定了URL，则仅返回这些URL的cookie。
返回的cookie是包含以下字段的字典列表：
name （STR）
value （STR）
url （STR）
domain （STR）
path （STR）
expires （数字）：Unix时间，以秒为单位
httpOnly （布尔）
secure （布尔）
session （布尔）
sameSite（str）：'Strict'或'Lax'
coverage
返回Coverage
协程函数 deleteCookie（* cookies ）
删除cookie，cookies 应该是包含这些字段的字典：
name（str）：必填
url （STR）
domain （STR）
path （STR）
secure （布尔）
协程函数 emulate（options: dict = None, **kwargs）
模拟给定的设备信息和用户代理，此方法是调用两个方法的快捷方式：
setUserAgent()
setViewport()
options 是包含以下字段的字典：
viewport(dict)含下列字段
width （int）：页面宽度（以像素为单位）。
height （int）：页面宽度（以像素为单位）。
deviceScaleFactor（float）：指定设备比例（可以认为是dpr），默认为1。
isMobile（bool）：是否考虑标签。默认为。meta viewportFalse
hasTouch（bool）：指定viewport是否支持触摸事件。默认为False。
isLandscape（bool）：指定视口是否处于横向模式。默认为False。
userAgent （str）：用户代理字符串
协程函数 emulateMedia（mediaType: str = None）
模拟页面的css媒体类型。
参数：
mediaType（str） - 更改页面的CSS媒体类型，允许值'screen'，'print'和 None，传入None禁用模拟媒体
协程函数 evaluate(pageFunction：str，* args，force_expr：bool = False )
在浏览器上执行js-function或js-expression并获取结果。
参数：
pageFunction（str） - 要在浏览器上执行的js-function / expression的字符串
force_expr（bool） - 如果为True，则计算pageFunction为表达式。如果为False（默认值），请尝试自动检测函数或表达式。
注意：force_exproption是仅关键字参数。
协程函数 evaluateHandle（pageFunction：str，* args ）
执行此页面上的功能
evaluateHandle()和evaluate()之间的区别是 evaluateHandle返回JSHandle对象（不是值）。
参数：
pageFunction（str） - 要执行的JavaScript函数。
协程函数 evaluateOnNewDocument（pageFunction：str，* args ）
在文档中添加JavaScript函数。
将在以下情况发生时调用此函数：
每当页面被导航时
每当子框架被附加或导航时。在这种情况下，在新附加的帧的上下文中调用该函数。
协程函数 exposeFunction（name：str，pyppeteerFunction：Callable [[...]，Any] ）
将python函数添加到浏览器的window对象中，可以从chrome进程调用已注册的函数。
参数：
name（string） - 窗口对象上函数的名称。
pyppeteerFunction（Callable） - 将在python进程上调用的函数。此函数不应该是异步函数。
协程函数 focus（selector：str )
聚焦匹配的元素,如果没有元素匹配selector，抛出PageError
frames
获取此页面的所有frame
协程函数 goBack(options: dict = None, **kwargs)
导航到历史记录中的上一页,如果不能回去，返回None。
协程函数 goForward(options: dict = None, **kwargs)
导航到历史记录中的下一页，可用选项与goto()方法相同，如果不能前进，返回None。
协程函数 goto（url：str，options：dict = None，** kwargs ）
打开url地址
参数：
url（str） - 将页面导航到的URL，网址应包括类型https://。
可用选项包括：
timeout（int）：最大导航时间（以毫秒为单位），默认为30秒，传递0给禁用超时。可以使用该setDefaultNavigationTimeout()方法更改默认值。
waitUntil（str | List [str]）：何时考虑导航成功，默认为load。给定事件字符串列表，在所有事件被触发后，导航被认为是成功的。活动可以是：
load：当load事件被触发时。
domcontentloaded：当DOMContentLoaded事件被触发时。
networkidle0：当网络连接数不超过0时，至少500毫秒。
networkidle2：当网络连接不超过2个，至少500毫秒。
该Page.goto会引发错误：
存在SSL错误（例如，在自签名证书的情况下）
目标网址无效
在timeout导航期间超过
然后主资源无法加载
注意
goto()要么引发错误，要么返回主要资源响应。唯一的例外是导航到about:blank或导航到具有不同散列的相同URL，这将成功并返回None。
无头模式不支持导航到PDF文档。
协程函数 hover（selector：str ）
鼠标悬停在匹配元素上，如果没有元素则抛出PageError。
协程函数 injectFile（filePath：str ）
[已弃用]将文件注入此页面，不推荐使用此方法，请addScriptTag()改用。
isClosed（）
判断页面是否关闭
keyboard
获取Keyboard对象
mainFrame
获取此页面Frame的主要内容
协程函数 metrics（）
获取页面属性，返回包含指标作为键/值对的字典：
Timestamp （number）：获取度量标准样本的时间戳。
Documents （int）：页面中的文档数。
Frames （int）：页面中的帧数。
JSEventListeners （int）：页面中的事件数。
Nodes （int）：页面中DOM节点的数量。
LayoutCount （int）：完整部分页面布局的总数。
RecalcStyleCount （int）：页面样式重新计算的总数。
LayoutDuration （int）：页面持续时间的组合持续时间。
RecalcStyleDuration （int）：所有页面样式重新计算的组合持续时间。
ScriptDuration （int）：JavaScript执行的组合持续时间。
TaskDuration （int）：浏览器执行的所有任务的组合持续时间。
JSHeapUsedSize （float）：使用的JavaScript堆大小。
JSHeapTotalSize （float）：JavaScript堆总大小。
mouse
获取Mouse对象
协程函数 pdf（options: dict = None, **kwargs）
生成页面的pdf
选项：
path （str）：保存PDF的文件路径。
scale（float）：网页渲染的比例，默认为1。
displayHeaderFooter（bool）：显示页眉和页脚。默认为False。
headerTemplate（str）：打印标题的HTML模板。应该是有效的HTML标记与以下类。
date：格式化的打印日期
title：文件名
url：文件位置
pageNumber：当前页码
totalPages：文档中的总页数
footerTemplate（str）：打印页脚的HTML模板。应该使用相同的模板headerTemplate。
printBackground（bool）：打印背景图形。默认为 False。
landscape（bool）：纸张方向。默认为False。
pageRanges（字符串）：要打印的纸张范围，例如“1-5,8,11-13”。默认为空字符串，表示所有页面。
format（str）：纸张格式。如果设置，优先于 width或height。默认为Letter。
width （str）：纸张宽度，接受标有单位的值。
height （str）：纸张高度，接受标有单位的值。
margin（字典）：纸张边距，默认为None。
top （str）：上边距，接受标有单位的值。
right （str）：右边距，接受标有单位的值。
bottom （str）：底部边距，接受标有单位的值。
left （str）：左边距，接受标有单位的值。
返回： 返回生成的PDF bytes对象。
注意
目前仅在无头模式下支持生成pdf。
pdf()使用printcss media 生成页面的pdf，要生成带screen媒体的pdf ，请设置page.emulateMedia('screen')。
默认情况下，pdf()生成带有修改颜色的pdf以进行打印。使用该--webkit-print-color-adjust属性强制渲染精确颜色。
await page.emulateMedia('screen')await page.pdf({'path': 'page.pdf'})的width，height和margin选项接受标记单位值，未标记的值被视为像素。
几个例子：
page.pdf({'width': 100})：打印宽度设置为100像素。
page.pdf({'width': '100px'})：打印宽度设置为100像素。
page.pdf({'width': '10cm'})：打印宽度设置为100厘米。
所有可用的单位是：
px：像素
in：英寸
cm：厘米
mm：毫米
格式选项包括：
Letter：8.5英寸x 11英寸
Legal：8.5英寸x 14英寸
Tabloid：11英寸x 17英寸
Ledger：17英寸x 11英寸
A0：33.1英寸x 46.8英寸
A1：23.4英寸x 33.1英寸
A2：16.5英寸x 23.4英寸
A3：11.7英寸x 16.5英寸
A4：8.27英寸x 11.7英寸
A5：5.83英寸x 8.27英寸
A6：4.13英寸x 5.83英寸
注意
headerTemplate和footerTemplate标记有以下限制：
不在模板内的脚本标记。
页面样式在模板中不可见。
协程函数 plainText（）
[已弃用]以纯文本格式获取页面内容。
协程函数queryObjects（prototypeHandle：pyppeteer.execution_context.JSHandle ）
迭代js堆并查找具有句柄的所有对象。
参数：
prototypeHandle（JSHandle） - 原型对象的JSHandle。
协程函数 reload（）
刷新本页
协程函数 screenshot（options: dict = None, **kwargs）
屏幕截屏
可以使用以下选项：
path（str）：保存图像的文件路径。屏幕截图类型将从文件扩展名中推断出来。
type（str）：指定屏幕截图类型，可以是jpeg或 png。默认为png。
quality（int）：图像的质量，在0-100之间。不适用于png图像。
fullPage（bool）：如果为true，请截取完整的可滚动页面。默认为False。
clip（字典）：指定页面剪切区域的对象。此选项应包含以下字段：
x （int）：剪辑区域左上角的x坐标。
y （int）：剪辑区域左上角的y坐标。
width （int）：剪切区域的宽度。
height （int）：剪切区域的高度。
omitBackground （bool）：隐藏默认的白色背景并允许捕获具有透明度的屏幕截图。
encoding（str）：图像的编码可以是 'base64'或'binary'。默认为'binary'。
协程函数 select（selector：str，* values ）
选择选项并返回所选值，如果没有元素匹配selector，请加注ElementHandleError。
协程函数 setBypassCSP（enabled：bool ）
切换绕过页面的Content-Security-Policy。
注意
CSP绕过在CSP初始化而不是评估时发生，通常这意味着page.setBypassCSP 应该在导航到域之前调用它。
协程函数 setCacheEnabled（enabled：bool = True ）
为每个请求启用/禁用缓存，默认情况下，启用缓存
协程函数 setContent（html：str ）
将内容设置为此页面
参数：
html（str） - 要分配给页面的HTML标记。
协程函数 setCookie（* cookies ）
设置cookie
cookies 应该是包含这些字段的字典：
name（str）：必填
value（str）：必填
url （STR）
domain （STR）
path （STR）
expires （数字）：Unix时间，以秒为单位
httpOnly （布尔）
secure （布尔）
sameSite（str）：'Strict'或'Lax'
setDefaultNavigationTimeout（timeout：int ）
更改默认的最大导航超时，此方法更改以下方法的默认超时30秒：
goto()
goBack()
goForward()
reload()
waitForNavigation()
参数：
timeout（int） - 最大导航时间（以毫秒为单位），设置为零0 禁用超时。
协程函数 setExtraHTTPHeaders（title：Dict [str，str] )
设置额外的HTTP标头,将在页面启动的每个请求中发送额外的HTTP标头
注意
page.setExtraHTTPHeaders 不保证传出请求中的标头顺序。
参数：
headers（Dict） - 包含要与每个请求一起发送的其他http标头的字典。所有标头值必须是字符串。
本篇文章整理了三分之二还有三分之一明天继续，来不及了。
重要：因为同步公号的文章格式很难保证，所以后面文章选择性在其他平台同步，欢迎移步公众号（Python之战）,每日更新原汁原味！
网友评论