diff --git a/DrissionPage/tools.py b/DrissionPage/tools.py index f8dfbab..6731109 100644 --- a/DrissionPage/tools.py +++ b/DrissionPage/tools.py @@ -169,14 +169,14 @@ class Listener(object): self._a_response_loaded = True - def steps(self, response_num: int = 1) -> Iterable: - """用于单步操作,可实现没收到若干个数据包执行一步操作(如翻页) \n + def steps(self, gap: int = 1) -> Iterable: + """用于单步操作,可实现没收到若干个数据包执行一步操作(如翻页) \n 于是可以根据数据包是否加载完成来决定是否翻页,无须从页面dom去判断是否加载完成 \n - 大大简化代码,提高可靠性 \n - eg: for i in listener.steps(2): \n - btn.click() \n - :param response_num: 每接收到多少个数据包触发 - :return: None + 大大简化代码,提高可靠性 \n + eg: for i in listener.steps(2): \n + btn.click() \n + :param gap: 每接收到多少个数据包触发 + :return: 用于在接收到监听目标时触发动作的可迭代对象 """ count = 0 while True: @@ -186,7 +186,7 @@ class Listener(object): if self._a_response_loaded: self._a_response_loaded = False count += 1 - if count % response_num == 0: + if count % gap == 0: yield def _response_received(self, **kwargs) -> None: diff --git a/docs/_sidebar.md b/docs/_sidebar.md index d2e5256..d71f6d6 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -24,6 +24,7 @@ * [🔧 Session 启动配置](使用方法\启动配置\Session启动配置.md) * [🔧 使用配置文件](使用方法\启动配置\使用配置文件.md) * [🔨 下载文件](使用方法\下载文件.md) + * [🔨 监听浏览器网络数据包](使用方法\监听浏览器网络数据包.md) * [🔨 cookies 的使用](使用方法\cookies的使用.md) * [🔨 Drission 对象](使用方法\Drission对象.md) * [🔨 对接 selenium 及 requests 代码](使用方法\对接selenium及requests代码.md) diff --git a/docs/入门指南/快速上手.md b/docs/入门指南/快速上手.md index 6ba06d8..e10b716 100644 --- a/docs/入门指南/快速上手.md +++ b/docs/入门指南/快速上手.md @@ -72,15 +72,17 @@ set_paths(driver_path=r"D:\chrome\chromedriver.exe", 网址:https://www.outbreak.my/zh/world 此示例爬取全球新冠情况排行榜。该网站是纯 html 页面,特别适合 s 模式爬取和解析。 +该网址为外网网址,连接可能稍慢。 + ![](https://gitee.com/g1879/DrissionPage-demos/raw/master/pics/%E5%BE%AE%E4%BF%A1%E6%88%AA%E5%9B%BE_20211231225026.jpg) ```python from DrissionPage import MixPage # 用 s 模式创建页面对象 -page = MixPage('s') +page = MixPage('s') # 访问数据网页 -page.get('https://www.outbreak.my/zh/world') +page.get('https://www.outbreak.my/zh/world') # 获取表头元素 thead = page('tag:thead')