检查节点存在性
<h1>检查节点存在性</h1>
<h2>功能描述</h2>
<p>本功能用于检测指定的节点是否存在于当前屏幕或指定区域中。</p>
<h2>输入参数</h2>
<table>
<thead>
<tr>
<th>参数名</th>
<th>类型</th>
<th>必填</th>
<th>默认值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>ID</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>节点resource-id</td>
</tr>
<tr>
<td>文本</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>支持模糊匹配（如<code>登录</code>匹配包含“登录”的文本，无需输入正则符号）</td>
</tr>
<tr>
<td>类名</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>节点className</td>
</tr>
<tr>
<td>包名</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>应用packageName</td>
</tr>
<tr>
<td>描述</td>
<td>字符串</td>
<td>否</td>
<td>空</td>
<td>支持模糊匹配（如<code>未读</code>匹配包含“未读”的文本）</td>
</tr>
<tr>
<td>查找范围</td>
<td>字符串</td>
<td>否</td>
<td>全屏</td>
<td>格式"x,y,width,height"</td>
</tr>
<tr>
<td>节点数量</td>
<td>数字</td>
<td>否</td>
<td>0</td>
<td>要求的最小节点数</td>
</tr>
<tr>
<td>节点存在返回</td>
<td>布尔</td>
<td>否</td>
<td>true</td>
<td>存在时返回true/false</td>
</tr>
</tbody>
</table>
<h2>使用示例</h2>
<h3>基础检查</h3>
<pre><code class="language-javascript">// 检查登录按钮是否存在
ID = &quot;com.example:id/login_btn&quot;
类名 = &quot;android.widget.Button&quot;</code></pre>
<h3>模糊匹配</h3>
<pre><code class="language-javascript">// 检查包含“未读”字样的文本
文本 = &quot;未读&quot;</code></pre>
<h3>数量阈值</h3>
<pre><code class="language-javascript">// 检查至少3个消息红点
类名 = &quot;android.widget.ImageView&quot;
描述 = &quot;未读消息&quot;
节点数量 = 3</code></pre>
<h3>反向逻辑</h3>
<pre><code class="language-javascript">// 当广告弹窗存在时返回false
ID = &quot;com.ad:id/close_btn&quot;
节点存在返回 = false</code></pre>
<h2>返回值</h2>
<ul>
<li><code>true</code>：满足条件时返回（受<code>节点存在返回</code>参数影响）</li>
<li><code>false</code>：不满足条件时返回</li>
</ul>
<h2>日志输出</h2>
<ul>
<li>✔ 找到节点时输出节点信息</li>
<li>✘ 未找到节点时输出条件详情</li>
<li>➤ 调试模式下显示完整查找条件</li>
</ul>
<h2>注意事项</h2>
<ol>
<li>多个条件为AND关系。</li>
<li>模糊匹配支持简单文本（如<code>登录</code>），复杂匹配（如正则表达式）由代码自动处理。</li>
<li>范围参数为空时搜索全屏。</li>
<li>性能建议：优先使用ID定位。</li>
</ol>