{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"等待元素出现"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"等待元素出现","__idx":0},"children":["等待元素出现"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["节点类型 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["browser_waitForSelector"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"功能说明","__idx":1},"children":["功能说明"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["等待选择器匹配元素，再执行下一步。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"客户端配置界面","__idx":2},"children":["客户端配置界面"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/wait-for-selector.42db1d2e61eee2e5170332868af7a57b74fe38a986b548d1fd8588cb4a7f5b9c.0538f3a9.webp","alt":"等待元素出现节点的客户端配置界面"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"输入字段","__idx":3},"children":["输入字段"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下字段位于 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.browserUi.inputs"]},"。"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"类型或取值"},"children":["类型或取值"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Schema 必填"},"children":["Schema 必填"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"执行默认值"},"children":["执行默认值"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"说明与边界"},"children":["说明与边界"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selectorRadio"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"CSS\""]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"XPath\""]},"（支持变量引用）"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"CSS\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["定位方式 编辑器初值 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"CSS\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["string"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["选择器"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serial"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WorkflowNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["元素序号; integer; minimum after resolution: 1 编辑器初值 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isShow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boolean"]},"（支持变量引用）"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["要求元素可见 编辑器初值 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxWaitMs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WorkflowNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["否"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10000"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["最长等待时间（毫秒）; minimum after resolution: 1 编辑器初值 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10000"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"条件与边界","__idx":4},"children":["条件与边界"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["必填 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selector"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["selector 非空；maxWaitMs 是等待上限；超时失败，不返回 found:false。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["校验错误码 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RPA_NODE_INPUT_INVALID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["selector 必填；isShow=true 还要求可见，false 只要求存在；maxWaitMs 为查找上限。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["校验错误码 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RPA_NODE_INPUT_INVALID"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"输入引用","__idx":5},"children":["输入引用"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"字段"},"children":["字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"允许的形式"},"children":["允许的形式"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selectorRadio"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["literal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["template"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["literal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["template"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serial"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["literal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numericExpression"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isShow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["literal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["template"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxWaitMs"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["literal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numericExpression"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"输出字段","__idx":6},"children":["输出字段"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"输出字段"},"children":["输出字段"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"类型或取值"},"children":["类型或取值"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["found"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["element"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ElementRef"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matchedCount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["按契约用 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${nodeId.data.field}"]}," 引用公开字段。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"json-示例","__idx":7},"children":["JSON 示例"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["可放入流程 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nodes"]}," 数组或其他节点 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blocks"]}," 中的完整节点对象。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"wait_results\",\n  \"type\": \"browser_waitForSelector\",\n  \"data\": {\n    \"title\": \"等待结果列表出现\",\n    \"browserAction\": \"waitForSelector\",\n    \"browserUi\": {\n      \"inputs\": {\n        \"selectorRadio\": \"CSS\",\n        \"selector\": \"#results\",\n        \"isShow\": true,\n        \"maxWaitMs\": 10000\n      },\n      \"exception\": {\n        \"timeout\": 30000,\n        \"policy\": \"interrupt\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/zh/browser-rpa/nodes"},"children":["返回节点目录"]}]}]},"headings":[{"value":"等待元素出现","id":"等待元素出现","depth":1},{"value":"功能说明","id":"功能说明","depth":2},{"value":"客户端配置界面","id":"客户端配置界面","depth":2},{"value":"输入字段","id":"输入字段","depth":2},{"value":"条件与边界","id":"条件与边界","depth":2},{"value":"输入引用","id":"输入引用","depth":2},{"value":"输出字段","id":"输出字段","depth":2},{"value":"JSON 示例","id":"json-示例","depth":2}],"frontmatter":{"seo":{"title":"等待元素出现"}},"lastModified":"2026-11-20T14:40:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh/browser-rpa/nodes/interaction/wait-for-selector","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}