docs/html/tools/help/uiautomator/UiWatcher.jd

   1 page.title=UiWatcher
   2 parent.title=uiautomator
   3 parent.link=index.html
   4 @jd:body
   5 <style>
   6     h4.jd-details-title {background-color: #DEE8F1;}
   7 </style>
   8
   9 <p>Represents a conditional watcher on the target device. To learn how to register a conditional
  10  watcher, see <code><a href="UiDevice.html#registerWatcher(java.lang.String, com.android.uiautomator.core.UiWatcher)">UiDevice.registerWatcher()</a></code>.
  11 </p>
  12 <h2>Summary</h2>
  13
  14 <!-- ========== METHOD SUMMARY =========== -->
  15 <table id="pubmethods" class="jd-sumtable"><tr><th colspan="12">Public Methods</th></tr>
  16
  17
  18
  19
  20     <tr class="api" >
  21         <td class="jd-typecol">
  22             abstract
  23
  24
  25
  26
  27             boolean
  28         </td>
  29         <td class="jd-linkcol" width="100%">
  30         <span class="sympad"><a href="#checkForCondition()">checkForCondition</a></span>()
  31
  32         <div class="jd-descrdiv">The testing framework calls this handler method automatically when the framework
  33         is unable to find a match using the <code><a href="UiSelector.html">UiSelector</a></code>.</div>
  34
  35   </td></tr>
  36
  37 </table>
  38
  39 </div><!-- jd-descr (summary) -->
  40
  41
  42 <!-- ========= METHOD DETAIL ======== -->
  43 <!-- Public methdos -->
  44
  45 <h2>Public Methods</h2>
  46
  47 <a id="checkForCondition()"></a>
  48
  49 <div class="jd-details api ">
  50     <h4 class="jd-details-title">
  51       <span class="normal">
  52         public
  53
  54
  55         abstract
  56
  57         boolean
  58       </span>
  59       <span class="sympad">checkForCondition</span>
  60       <span class="normal">()</span>
  61     </h4>
  62       <div class="api-level">
  63
  64       </div>
  65     <div class="jd-details-descr">
  66
  67   <div class="jd-tagdata jd-tagdescr"><p>The testing framework calls this handler method automatically when the framework is unable to find a match using the <code><a href="UiSelector.html">UiSelector</a></code>. When a match is not found after a predetermined time has elapsed, the framework calls the checkForCondition() method of all registered watchers on the device. You can use this method to handle known blocking issues that are preventing the test from proceeding. For example, you can check if a dialog appeared that is blocking the the test, then close the dialog or perform some other appropriate action to allow the test to continue.</p></div>
  68   <div class="jd-tagdata">
  69       <h5 class="jd-tagtitle">Returns</h5>
  70       <ul class="nolist"><li>true to indicate a matched condition, or false if no matching condition is found
  71 </li></ul>
  72   </div>
  73
  74     </div>