steps()的response_num参数改名为gap；更新文档

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:

docs/_sidebar.md

@@ -24,6 +24,7 @@
         * [🔧 Session 启动配置](使用方法\启动配置\Session启动配置.md)
         * [🔧 使用配置文件](使用方法\启动配置\使用配置文件.md)
   * [🔨 下载文件](使用方法\下载文件.md)
+  * [🔨 监听浏览器网络数据包](使用方法\监听浏览器网络数据包.md)
   * [🔨 cookies 的使用](使用方法\cookies的使用.md)
   * [🔨 Drission 对象](使用方法\Drission对象.md)
   * [🔨 对接 selenium 及 requests 代码](使用方法\对接selenium及requests代码.md)

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')