docs: added printing information description

Author: coder-hxl

README.md

@@ -57,6 +57,7 @@ x-crawl is an open source project under the MIT license, completely free to use.
   - [Rotate Proxy](#rotate-proxy)
   - [Custom Device Fingerprint](#custom-device-fingerprint)
   - [Priority Queue](#priority-queue)
+  - [Print information](#print-information)
   - [About Results](#about-results)
   - [TypeScript](#typescript)
 - [API](#api)
@@ -198,7 +199,7 @@ myXCrawl.startPolling({ d: 1 }, async (count, stopPolling) => {
 running result:
 
 <div align="center">
-  <img src="https://raw.githubusercontent.com/coder-hxl/x-crawl/main/assets/run-example-gif.gif" />
+  <img src="https://raw.githubusercontent.com/coder-hxl/x-crawl/main/assets/run-example.gif" />
 </div>
 
 **Note:** Please do not crawl randomly, you can check the **robots.txt** protocol before crawling. The class name of the website may change, this is just to demonstrate how to use x-crawl.
@@ -788,6 +789,34 @@ myXCrawl
 
 The larger the value of the priority attribute, the higher the priority in the current crawling queue.
 
+### Print information
+
+The crawled print information consists of start (displaying mode and total number), process (displaying number and how long to wait), and result (displaying success and failure information). There will be something like **1-page-2** in front of each piece of information. The first 1 represents the first crawler instance, the middle page represents the API type, and the following 2 represents the second page of the first crawler instance. Do this The purpose is to better distinguish which API the information comes from.
+
+When you do not want to display the crawled information in the terminal, you can control the display or hiding through the options.
+
+```js
+import xCrawl from 'x-crawl'
+
+// Only hide the process, start and result display
+const myXCrawl = xCrawl({ log: { process: false } })
+
+// Hide all information
+const myXCrawl = xCrawl({ log: false })
+```
+
+The log option accepts an object or boolean type:
+
+- Boolean
+
+  - true: show all
+  - false: hide all
+
+- object
+  - start: control the start information
+  - process: control of process information
+  - result: control of result information
+
 ### About Results
 
 Each crawl target will generate a detail object, which will contain the following properties:
@@ -1491,6 +1520,13 @@ export interface XCrawlConfig extends CrawlCommonConfig {
   enableRandomFingerprint?: boolean
   baseUrl?: string
   intervalTime?: IntervalTime
+  log?:
+    | {
+        start?: boolean
+        process?: boolean
+        result?: boolean
+      }
+    | boolean
   crawlPage?: {
     puppeteerLaunch?: PuppeteerLaunchOptions // puppeteer
   }
@@ -1503,6 +1539,7 @@ export interface XCrawlConfig extends CrawlCommonConfig {
 - enableRandomFingerprint: true
 - baseUrl: undefined
 - intervalTime: undefined
+- log: { start: true, process: true, result: true }
 - crawlPage: undefined
 
 #### Detail target config

assets/run-example-gif.gif

@@ -57,6 +57,7 @@ x-crawl 是采用 MIT 许可的开源项目，使用完全免费。如果你在
   - [轮换代理](#轮换代理)
   - [自定义设备指纹](#自定义设备指纹)
   - [优先队列](#优先队列)
+  - [打印信息](#打印信息)
   - [关于结果](#关于结果)
   - [TypeScript](#TypeScript)
 - [API](#API)
@@ -195,9 +196,8 @@ myXCrawl.startPolling({ d: 1 }, async (count, stopPolling) => {
 运行效果:
 
 <div align="center">
-  <img src="https://raw.githubusercontent.com/coder-hxl/x-crawl/main/assets/run-example-gif.gif" />
+  <img src="https://raw.githubusercontent.com/coder-hxl/x-crawl/main/assets/run-example.gif" />
 </div>
-
 **注意:** 请勿随意爬取，爬取前可查看 **robots.txt** 协议。网站的类名可能会有变更，这里只是为了演示如何使用 x-crawl 。
 
 ## 核心概念
@@ -782,6 +782,34 @@ myXCrawl
 
 priority 属性的值越大就在当前爬取队列中越优先。
 
+### 打印信息
+
+爬取的打印信息由开始（显示模式和总数）、过程（显示数量和等待多久）、结果（显示成功和失败信息）组成。每段信息前面都会有如 **1-page-2** ，前面的 1 代表第 1 个爬虫实例，中间的 page 代表 API 类型，后面的 2 代表第 1 个爬虫实例的第 2 个 page ，这样做的目的是为了更好区分信息来自哪个 API 。
+
+当您不希望在终端显示爬取信息时，可以通过选项自己控制显示或隐藏。
+
+```js
+import xCrawl from 'x-crawl'
+
+// 只隐藏过程，开始和结果显示
+const myXCrawl = xCrawl({ log: { process: false } })
+
+// 隐藏全部信息
+const myXCrawl = xCrawl({ log: false })
+```
+
+log 选项接收对象或布尔类型：
+
+- 布尔
+
+  - true: 全部显示
+  - false：全部隐藏
+
+- 对象
+  - start：对开始信息控制
+  - process：对过程信息控制
+  - result：对结果信息控制
+
 ### 关于结果
 
 每个爬取目标都会产生一个详情对象，该详情对象会包含以下属性：
@@ -1479,6 +1507,13 @@ export interface XCrawlConfig extends CrawlCommonConfig {
   enableRandomFingerprint?: boolean
   baseUrl?: string
   intervalTime?: IntervalTime
+  log?:
+    | {
+        start?: boolean
+        process?: boolean
+        result?: boolean
+      }
+    | boolean
   crawlPage?: {
     puppeteerLaunch?: PuppeteerLaunchOptions // puppeteer
   }
@@ -1491,6 +1526,7 @@ export interface XCrawlConfig extends CrawlCommonConfig {
 - enableRandomFingerprint: true
 - baseUrl: undefined
 - intervalTime: undefined
+- log: { start: true, process: true, result: true }
 - crawlPage: undefined
 
 #### Detail Target Config