w-ipproxy 1.0.18 → 1.0.19

package/docs/WIpProxy.html

@@ -80,7 +80,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="WIpProxy.mjs.html">WIpProxy.mjs</a>, <a href="WIpProxy.mjs.html#line65">line 65</a>
+        <a href="WIpProxy.mjs.html">WIpProxy.mjs</a>, <a href="WIpProxy.mjs.html#line78">line 78</a>
     </li></ul></dd>
     
 
@@ -127,7 +127,30 @@
 
     <h5 class="h5-examples">Example</h5>
     
-    <pre class="prettyprint"><code>import _ from 'lodash-es'
    // tar: `https://www.google.com`,
    withServer: true,
    serverPort: 9000,
    serverCorsOrigins: ['*'],
    console.log(`已抓取公開代理共 ${_.size(prxsRaw)} 個...`)
    // console.log('新加入代理', { host: p.host, port: p.port }, _.map(proxies, 'proxy'))
    // console.log('刪除代理', { host: p.host, port: p.port }, _.map(proxies, 'proxy'))
    // console.log(`有效代理`, _.map(proxies, 'proxy'))
    console.log(`已檢測有效代理共 ${_.size(proxies)} 個...`)
+    <pre class="prettyprint"><code>import _ from 'lodash-es'
+import wip from './src/WIpProxy.mjs'
+
+let wo = wip({
+    // tar: `https://www.google.com`,
+    withServer: true,
+    serverPort: 9000,
+    serverCorsOrigins: ['*'],
+})
+wo.on('getRawProxies', (prxsRaw) => {
+    console.log(`已抓取公開代理共 ${_.size(prxsRaw)} 個...`)
+})
+wo.on('add', (p, proxies) => {
+    // console.log('新加入代理', { host: p.host, port: p.port }, _.map(proxies, 'proxy'))
+})
+wo.on('delete', (p, proxies) => {
+    // console.log('刪除代理', { host: p.host, port: p.port }, _.map(proxies, 'proxy'))
+})
+wo.on('change', (proxies) => {
+    // console.log(`有效代理`, _.map(proxies, 'proxy'))
+    console.log(`已檢測有效代理共 ${_.size(proxies)} 個...`)
+})
+
+//browser view: http://localhost:9000/getProxies</code></pre>
 
 
 
@@ -417,7 +440,7 @@
                 </td>
             
 
-            <td class="description last"><p>輸入是否對代理做匿名性檢測布林值，開啟時會先打https://httpbin.org/ip驗證代理不會將本機真實IP透過X-Forwarded-For等方式洩漏給目標端，預設true</p></td>
+            <td class="description last"><p>輸入是否對代理做匿名性檢測布林值，開啟時會先查詢本機真實公網IP(依序嘗試httpbin.org、ipify、checkip.amazonaws.com、icanhazip.com)，再透過代理打https://httpbin.org/get驗證目標端所見之origin與X-Forwarded-For、X-Real-IP、Forwarded等標頭皆不含本機真實IP，且不帶Via、Proxy-Connection等暴露代理存在之標頭；若本機真實IP查詢全部失敗則視為無法驗證，該回合所有代理皆不放行(fail-closed)，預設true</p></td>
         </tr>
 
     
@@ -452,12 +475,52 @@
             
                 <td class="default">
                 
-                    <code>2</code>
+                    <code>5</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>輸入匿名性檢測重複次數整數，各次以獨立連線送出並於時間上分散(間隔anonymityCheckInterval)，用以偵測負載平衡型代理呈時間窗之機率性洩漏，任一次洩漏即判定失敗，預設5</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>anonymityCheckInterval</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">Integer</span>
+
+
+
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>2000</code>
                 
                 </td>
             
 
-            <td class="description last"><p>輸入匿名性檢測重複次數整數，用以偵測負載平衡型代理的機率性洩漏，任一次洩漏即判定失敗，預設2</p></td>
+            <td class="description last"><p>輸入匿名性檢測各次之間隔時間整數，單位ms，預設2000</p></td>
         </tr>
 
     
@@ -650,7 +713,7 @@
 
         
 <div class="param-desc">
-    <p>回傳事件物件，提供函數getProxies，可監聽事件getRawProxies、add、delete、change</p>
+    <p>回傳事件物件，提供函數getProxies(等待至有有效代理)與getProxiesOnce(抓取並檢測一回合後回傳當前有效代理，可能為空陣列)，可監聽事件getRawProxies、add、delete、change</p>
 </div>
 
 
@@ -709,7 +772,7 @@
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Wed Sep 02 2026 18:06:41 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.5</a> on Sat Sep 05 2026 21:24:32 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>