## 元素查找插件 從1.9.2版本開始，Appium支持使用插件來輔助查找元素，通過使用 `-custom` 定位策略。 目前此功能為實驗性功能。 ### 用法 1. 安裝基于 Appium 元素查找插件標準開發的第三方元素查找插件 (參見下文)。 (必須是Node模塊，通過NPM安裝或者本地安裝)。插件可以安裝在你系統上的任意位置，不過主要有三種方式： * 獨立于Appium的目錄 (通過在任意文件夾運行 `npm install <plugin>`) * 在Appium依賴樹下 (通過在Appium根目錄下運行`npm install <plugin>`) * 在系統上全局安裝 (通過運行 `npm install -g <plugin>`) (當然，插件本身可能有安裝和部署說明，在插件的文檔中會有詳細說明。) 2. 在你的測試中添加一個新的capability：`customFindModules`。 這個capability必須是一個對象，至少有一個鍵和一個值。鍵名為 "插件快捷鍵"，值為"插件引用"。 例如： ``` { "customFindModules": { "plug": "my-element-finding-plugin" } } ``` "plug"是快捷方式，而"my-element-finding-plugin"是引用。在你的測試代碼中只需要使用快捷方式，可以是滿足JSON鍵名條件的任意字符串。引用必須是插件的Node模塊引用，而且Appium可以通過Node的[模塊獲取方法](https://medium.freecodecamp.org/requiring-modules-in-node-js-everything-you-need-to-know-e7fbd119be8)來[獲取](https://nodejs.org/api/modules.html#modules_require)。 一旦使用上述capability來啟動一個session，可以說插件（或者多個插件---多插件當然是支持的）已經被注冊上了。你可以通過下面的步驟來使用已注冊的插件查找元素： 1. 使用`-custom` 定位策略 2. 在你的選擇器前加上`<快捷方式(shortcut)>:` 因此，對于上面例子中的插件，如果你想使用"foo"選擇器來查找元素，可以這樣寫（在客戶端代碼中）： ```js driver.findElement('-custom', 'plug:foo'); ``` 換句話說，使用`-custom`定位策略，并發送`foo`作為選擇器，從而確保Appium知道應該使用`plug`插件來處理查找元素請求。 如果只有一個插件注冊了，可以在選擇器中省略插件快捷方式（因為Appium不會混淆你想使用哪個插件）： ```js driver.findElement('-custom', 'foo'); ``` 目前并非所有的Appium客戶端都很好地支持了`-custom`定位策略；查看客戶端文檔獲取此策略的正確調用方式。 ### 開發插件 任何人都可以開發Appium元素查找插件。只需符合下列規則： * 插件必須是一個Node模塊，且有一個名為`find`的導出(export) * 當被調用的時候返回元素對象列表（可以為空） 當Appium調用你的`find`方法時，它會傳遞下列參數： * 一個`driver`對象實例，代表當前session（比如`XCUITestDriver`實例） * 一個日志對象，可以寫入Appium日志 * 選擇器（字符串），用戶傳入用于查找元素 * 一個布爾值：是否查找多個元素（true）或（false）。注意你必須返回一個數組，不管用戶是否要查找多個元素。傳遞這個標志位是為了針對不需要返回多個元素的查詢進行優化。 這就是目前的全部內容! 具體示例可查看以下已知插件列表。 ### 已知插件列表 * [Test.ai Classifier](https://github.com/testdotai/appium-classifier-plugin)