blob: 436f9ef70a1277b732f4a534d2768e33d2fab550 [file] [log] [blame]
Quddus Chong489218c2015-02-26 16:38:46 -08001<!DOCTYPE html>
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
Quddus Chong900831f2015-04-17 15:01:16 -070098
Quddus Chong489218c2015-02-26 16:38:46 -080099<html>
100<head>
101
102
103<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
104<meta name="viewport" content="width=device-width" />
105
106<link rel="shortcut icon" type="image/x-icon" href="../../../../../favicon.ico" />
107<title>Espresso | Android Developers</title>
108
109<!-- STYLESHEETS -->
110<link rel="stylesheet"
111href="http://fonts.googleapis.com/css?family=Roboto+Condensed">
112<link rel="stylesheet" href="http://fonts.googleapis.com/css?family=Roboto:light,regular,medium,thin,italic,mediumitalic,bold"
113 title="roboto">
Quddus Chong900831f2015-04-17 15:01:16 -0700114<link href="../../../../../assets/css/default.css?v=5" rel="stylesheet" type="text/css">
Quddus Chong489218c2015-02-26 16:38:46 -0800115
116
117<!-- FULLSCREEN STYLESHEET -->
118<link href="../../../../../assets/css/fullscreen.css" rel="stylesheet" class="fullscreen"
119type="text/css">
120
121
122<!-- JAVASCRIPT -->
123<script src="http://www.google.com/jsapi" type="text/javascript"></script>
124<script src="../../../../../assets/js/android_3p-bundle.js" type="text/javascript"></script>
125<script type="text/javascript">
126 var toRoot = "../../../../../";
127 var metaTags = [];
128 var devsite = false;
129</script>
Quddus Chong900831f2015-04-17 15:01:16 -0700130<script src="../../../../../assets/js/docs.js?v=3" type="text/javascript"></script>
131
132
Quddus Chong489218c2015-02-26 16:38:46 -0800133
134<script>
135 (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
136 (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
137 m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
138 })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
139
140 ga('create', 'UA-5831155-1', 'android.com');
141 ga('create', 'UA-49880327-2', 'android.com', {'name': 'universal'}); // New tracker);
142 ga('send', 'pageview');
143 ga('universal.send', 'pageview'); // Send page view for new tracker.
144</script>
145
146</head>
147
148<body class="gc-documentation
149 develop reference" itemscope itemtype="http://schema.org/Article">
150 <div id="doc-api-level" class="" style="display:none"></div>
151 <a name="top"></a>
152
153
154<a name="top"></a>
155
Quddus Chong900831f2015-04-17 15:01:16 -0700156<!-- dialog to prompt lang pref change when loaded from hardcoded URL
157<div id="langMessage" style="display:none">
158 <div>
159 <div class="lang en">
160 <p>You requested a page in English, would you like to proceed with this language setting?</p>
161 </div>
162 <div class="lang es">
163 <p>You requested a page in Spanish (Español), would you like to proceed with this language setting?</p>
164 </div>
165 <div class="lang ja">
166 <p>You requested a page in Japanese (日本語), would you like to proceed with this language setting?</p>
167 </div>
168 <div class="lang ko">
169 <p>You requested a page in Korean (한국어), would you like to proceed with this language setting?</p>
170 </div>
171 <div class="lang ru">
172 <p>You requested a page in Russian (Русский), would you like to proceed with this language setting?</p>
173 </div>
174 <div class="lang zh-cn">
175 <p>You requested a page in Simplified Chinese (简体中文), would you like to proceed with this language setting?</p>
176 </div>
177 <div class="lang zh-tw">
178 <p>You requested a page in Traditional Chinese (繁體中文), would you like to proceed with this language setting?</p>
179 </div>
180 <a href="#" class="button yes" onclick="return false;">
181 <span class="lang en">Yes</span>
182 <span class="lang es">Sí</span>
183 <span class="lang ja">Yes</span>
184 <span class="lang ko">Yes</span>
185 <span class="lang ru">Yes</span>
186 <span class="lang zh-cn">是的</span>
187 <span class="lang zh-tw">没有</span>
188 </a>
189 <a href="#" class="button" onclick="$('#langMessage').hide();return false;">
190 <span class="lang en">No</span>
191 <span class="lang es">No</span>
192 <span class="lang ja">No</span>
193 <span class="lang ko">No</span>
194 <span class="lang ru">No</span>
195 <span class="lang zh-cn">没有</span>
196 <span class="lang zh-tw">没有</span>
197 </a>
198 </div>
199</div> -->
200
201
Quddus Chong489218c2015-02-26 16:38:46 -0800202 <!-- Header -->
203 <div id="header-wrapper">
204 <div id="header">
205
206
207
208
209 <div class="wrap" id="header-wrap">
210 <div class="col-3 logo">
211 <a href="../../../../../index.html">
212 <img src="../../../../../assets/images/dac_logo.png"
213 srcset="../../../../../assets/images/dac_logo@2x.png 2x"
214 width="123" height="25" alt="Android Developers" />
215 </a>
216 <div class="btn-quicknav" id="btn-quicknav">
217 <a href="#" class="arrow-inactive">Quicknav</a>
218 <a href="#" class="arrow-active">Quicknav</a>
219 </div>
220 </div>
221 <ul class="nav-x col-9">
222 <li class="design">
223 <a href="../../../../../design/index.html"
224 zh-tw-lang="設計"
225 zh-cn-lang="设计"
226 ru-lang="Проектирование"
227 ko-lang="디자인"
228 ja-lang="設計"
229 es-lang="Diseñar"
230 >Design</a></li>
231 <li class="develop"><a href="../../../../../develop/index.html"
232 zh-tw-lang="開發"
233 zh-cn-lang="开发"
234 ru-lang="Разработка"
235 ko-lang="개발"
236 ja-lang="開発"
237 es-lang="Desarrollar"
238 >Develop</a></li>
239 <li class="distribute last"><a href="../../../../../distribute/index.html"
240 zh-tw-lang="發佈"
241 zh-cn-lang="分发"
242 ru-lang="Распространение"
243 ko-lang="배포"
244 ja-lang="配布"
245 es-lang="Distribuir"
246 >Distribute</a></li>
247 </ul>
248
249
250
251
252<div class="menu-container">
253 <div class="moremenu">
254 <div id="more-btn"></div>
255 </div>
256 <div class="morehover" id="moremenu">
257 <div class="top"></div>
258 <div class="mid">
259 <div class="header">Links</div>
260 <ul>
261 <li><a href="https://play.google.com/apps/publish/" target="_googleplay">Google Play Developer Console</a></li>
262 <li><a href="http://android-developers.blogspot.com/">Android Developers Blog</a></li>
263 <li><a href="../../../../../about/index.html">About Android</a></li>
264 </ul>
265 <div class="header">Android Sites</div>
266 <ul>
267 <li><a href="http://www.android.com">Android.com</a></li>
268 <li class="active"><a>Android Developers</a></li>
269 <li><a href="http://source.android.com">Android Open Source Project</a></li>
270 </ul>
271
272
273
274
275 <br class="clearfix" />
276 </div><!-- end 'mid' -->
277 <div class="bottom"></div>
278 </div><!-- end 'moremenu' -->
279
280 <div class="search" id="search-container">
281 <div class="search-inner">
282 <div id="search-btn"></div>
283 <div class="left"></div>
284 <form onsubmit="return submit_search()">
285 <input id="search_autocomplete" type="text" value="" autocomplete="off" name="q"
286 onfocus="search_focus_changed(this, true)" onblur="search_focus_changed(this, false)"
287 onkeydown="return search_changed(event, true, '../../../../../')"
288 onkeyup="return search_changed(event, false, '../../../../../')" />
289 </form>
290 <div class="right"></div>
291 <a class="close hide">close</a>
292 <div class="left"></div>
293 <div class="right"></div>
294 </div><!-- end search-inner -->
295 </div><!-- end search-container -->
296
297 <div class="search_filtered_wrapper reference">
298 <div class="suggest-card reference no-display">
299 <ul class="search_filtered">
300 </ul>
301 </div>
302 </div>
303
304 <div class="search_filtered_wrapper docs">
305 <div class="suggest-card dummy no-display">&nbsp;</div>
306 <div class="suggest-card develop no-display">
307 <ul class="search_filtered">
308 </ul>
309 <div class="child-card guides no-display">
310 </div>
311 <div class="child-card training no-display">
312 </div>
313 <div class="child-card samples no-display">
314 </div>
315 </div>
316 <div class="suggest-card design no-display">
317 <ul class="search_filtered">
318 </ul>
319 </div>
320 <div class="suggest-card distribute no-display">
321 <ul class="search_filtered">
322 </ul>
323 </div>
324 </div>
325</div><!-- end menu-container (search and menu widget) -->
326
327
328
329 <!-- Expanded quicknav -->
330 <div id="quicknav" class="col-13">
331 <ul>
332 <li class="about">
333 <ul>
334 <li><a href="../../../../../about/index.html">About</a></li>
335 <li><a href="../../../../../wear/index.html">Wear</a></li>
336 <li><a href="../../../../../tv/index.html">TV</a></li>
337 <li><a href="../../../../../auto/index.html">Auto</a></li>
338 </ul>
339 </li>
340 <li class="design">
341 <ul>
342 <li><a href="../../../../../design/index.html">Get Started</a></li>
343 <li><a href="../../../../../design/devices.html">Devices</a></li>
344 <li><a href="../../../../../design/style/index.html">Style</a></li>
345 <li><a href="../../../../../design/patterns/index.html">Patterns</a></li>
346 <li><a href="../../../../../design/building-blocks/index.html">Building Blocks</a></li>
347 <li><a href="../../../../../design/downloads/index.html">Downloads</a></li>
348 <li><a href="../../../../../design/videos/index.html">Videos</a></li>
349 </ul>
350 </li>
351 <li class="develop">
352 <ul>
353 <li><a href="../../../../../training/index.html"
354 zh-tw-lang="訓練課程"
355 zh-cn-lang="培训"
356 ru-lang="Курсы"
357 ko-lang="교육"
358 ja-lang="トレーニング"
359 es-lang="Capacitación"
360 >Training</a></li>
361 <li><a href="../../../../../guide/index.html"
362 zh-tw-lang="API 指南"
363 zh-cn-lang="API 指南"
364 ru-lang="Руководства по API"
365 ko-lang="API 가이드"
366 ja-lang="API ガイド"
367 es-lang="Guías de la API"
368 >API Guides</a></li>
369 <li><a href="../../../../../reference/packages.html"
370 zh-tw-lang="參考資源"
371 zh-cn-lang="参考"
372 ru-lang="Справочник"
373 ko-lang="참조문서"
374 ja-lang="リファレンス"
375 es-lang="Referencia"
376 >Reference</a></li>
377 <li><a href="../../../../../sdk/index.html"
378 zh-tw-lang="相關工具"
379 zh-cn-lang="工具"
380 ru-lang="Инструменты"
381 ko-lang="도구"
382 ja-lang="ツール"
383 es-lang="Herramientas"
384 >Tools</a>
385 </li>
386 <li><a href="../../../../../google/index.html">Google Services</a>
387 </li>
388
389 </ul>
390 </li>
391 <li class="distribute last">
392 <ul>
393 <li><a href="../../../../../distribute/googleplay/index.html">Google Play</a></li>
394 <li><a href="../../../../../distribute/essentials/index.html">Essentials</a></li>
395 <li><a href="../../../../../distribute/users/index.html">Get Users</a></li>
396 <li><a href="../../../../../distribute/engage/index.html">Engage &amp; Retain</a></li>
397 <li><a href="../../../../../distribute/monetize/index.html">Monetize</a></li>
Quddus Chong900831f2015-04-17 15:01:16 -0700398 <li><a href="../../../../../distribute/analyze/index.html">Analyze</a></li>
Quddus Chong489218c2015-02-26 16:38:46 -0800399 <li><a href="../../../../../distribute/tools/index.html">Tools &amp; Reference</a></li>
400 <li><a href="../../../../../distribute/stories/index.html">Developer Stories</a></li>
401 </ul>
402 </li>
403 </ul>
404 </div><!-- /Expanded quicknav -->
405 </div><!-- end header-wrap.wrap -->
406 </div><!-- end header -->
407
408
409 <!-- Secondary x-nav -->
410 <div id="nav-x">
411 <div class="wrap" style="position:relative;z-index:1">
412
413
Quddus Chong489218c2015-02-26 16:38:46 -0800414
Quddus Chong489218c2015-02-26 16:38:46 -0800415
416
417 <ul class="nav-x col-9 develop" style="width:100%">
418 <li class="training"><a href="../../../../../training/index.html"
419 zh-tw-lang="訓練課程"
420 zh-cn-lang="培训"
421 ru-lang="Курсы"
422 ko-lang="교육"
423 ja-lang="トレーニング"
424 es-lang="Capacitación"
425 >Training</a></li>
426 <li class="guide"><a href="../../../../../guide/index.html"
427 zh-tw-lang="API 指南"
428 zh-cn-lang="API 指南"
429 ru-lang="Руководства по API"
430 ko-lang="API 가이드"
431 ja-lang="API ガイド"
432 es-lang="Guías de la API"
433 >API Guides</a></li>
434 <li class="reference"><a href="../../../../../reference/packages.html"
435 zh-tw-lang="參考資源"
436 zh-cn-lang="参考"
437 ru-lang="Справочник"
438 ko-lang="참조문서"
439 ja-lang="リファレンス"
440 es-lang="Referencia"
441 >Reference</a></li>
442 <li class="tools"><a href="../../../../../sdk/index.html"
443 zh-tw-lang="相關工具"
444 zh-cn-lang="工具"
445 ru-lang="Инструменты"
446 ko-lang="도구"
447 ja-lang="ツール"
448 es-lang="Herramientas"
449 >Tools</a></li>
450 <li class="google"><a href="../../../../../google/index.html"
451 >Google Services</a>
452 </li>
453
454 </ul>
455 </div>
456 </div>
457 <!-- /Sendondary x-nav DEVELOP -->
458
459
460
461 <div id="searchResults" class="wrap" style="display:none;">
462 <h2 id="searchTitle">Results</h2>
463 <div id="leftSearchControl" class="search-control">Loading...</div>
464 </div>
465 </div> <!--end header-wrapper -->
466
467 <div id="sticky-header">
468 <div>
469 <a class="logo" href="#top"></a>
470 <a class="top" href="#top"></a>
471 <ul class="breadcrumb">
472
473 <li class="current">Espresso</li>
474 </ul>
475 </div>
476 </div>
477
478
479
480
481
482 <div class="wrap clearfix" id="body-content">
483 <div class="col-4" id="side-nav" itemscope itemtype="http://schema.org/SiteNavigationElement">
484 <div id="devdoc-nav">
485 <div id="api-nav-header">
486 <div id="api-level-toggle">
487 <label for="apiLevelCheckbox" class="disabled"
488 title="Select your target API level to dim unavailable APIs">API level: </label>
489 <div class="select-wrapper">
490 <select id="apiLevelSelector">
491 <!-- option elements added by buildApiLevelSelector() -->
492 </select>
493 </div>
494 </div><!-- end toggle -->
495 <div id="api-nav-title">Android APIs</div>
496 </div><!-- end nav header -->
497 <script>
498 var SINCE_DATA = [ ];
499 buildApiLevelSelector();
500 </script>
501
502 <div id="swapper">
503 <div id="nav-panels">
504 <div id="resize-packages-nav">
505 <div id="packages-nav" class="scroll-pane">
506
507 <ul>
508
509 <li class="api apilevel-">
510 <a href="../../../../../reference/android/support/test/package-summary.html">android.support.test</a></li>
Quddus Chong900831f2015-04-17 15:01:16 -0700511 <li class="api apilevel-">
512 <a href="../../../../../reference/android/support/test/annotation/package-summary.html">android.support.test.annotation</a></li>
Quddus Chong489218c2015-02-26 16:38:46 -0800513 <li class="selected api apilevel-">
514 <a href="../../../../../reference/android/support/test/espresso/package-summary.html">android.support.test.espresso</a></li>
515 <li class="api apilevel-">
516 <a href="../../../../../reference/android/support/test/espresso/action/package-summary.html">android.support.test.espresso.action</a></li>
517 <li class="api apilevel-">
518 <a href="../../../../../reference/android/support/test/espresso/assertion/package-summary.html">android.support.test.espresso.assertion</a></li>
519 <li class="api apilevel-">
520 <a href="../../../../../reference/android/support/test/espresso/base/package-summary.html">android.support.test.espresso.base</a></li>
521 <li class="api apilevel-">
522 <a href="../../../../../reference/android/support/test/espresso/contrib/package-summary.html">android.support.test.espresso.contrib</a></li>
523 <li class="api apilevel-">
Quddus Chong900831f2015-04-17 15:01:16 -0700524 <a href="../../../../../reference/android/support/test/espresso/intent/package-summary.html">android.support.test.espresso.intent</a></li>
525 <li class="api apilevel-">
526 <a href="../../../../../reference/android/support/test/espresso/intent/matcher/package-summary.html">android.support.test.espresso.intent.matcher</a></li>
527 <li class="api apilevel-">
528 <a href="../../../../../reference/android/support/test/espresso/intent/rule/package-summary.html">android.support.test.espresso.intent.rule</a></li>
529 <li class="api apilevel-">
Quddus Chong489218c2015-02-26 16:38:46 -0800530 <a href="../../../../../reference/android/support/test/espresso/matcher/package-summary.html">android.support.test.espresso.matcher</a></li>
531 <li class="api apilevel-">
532 <a href="../../../../../reference/android/support/test/espresso/util/package-summary.html">android.support.test.espresso.util</a></li>
533 <li class="api apilevel-">
534 <a href="../../../../../reference/android/support/test/filters/package-summary.html">android.support.test.filters</a></li>
535 <li class="api apilevel-">
Quddus Chong900831f2015-04-17 15:01:16 -0700536 <a href="../../../../../reference/android/support/test/rule/package-summary.html">android.support.test.rule</a></li>
537 <li class="api apilevel-">
Quddus Chong489218c2015-02-26 16:38:46 -0800538 <a href="../../../../../reference/android/support/test/runner/package-summary.html">android.support.test.runner</a></li>
539 <li class="api apilevel-">
Quddus Chong900831f2015-04-17 15:01:16 -0700540 <a href="../../../../../reference/android/support/test/runner/intent/package-summary.html">android.support.test.runner.intent</a></li>
541 <li class="api apilevel-">
Quddus Chong489218c2015-02-26 16:38:46 -0800542 <a href="../../../../../reference/android/support/test/runner/lifecycle/package-summary.html">android.support.test.runner.lifecycle</a></li>
543 <li class="api apilevel-">
544 <a href="../../../../../reference/android/support/test/uiautomator/package-summary.html">android.support.test.uiautomator</a></li>
545 </ul><br/>
546
547 </div> <!-- end packages-nav -->
548 </div> <!-- end resize-packages -->
549 <div id="classes-nav" class="scroll-pane">
550
551
552
553 <ul>
554
555
556 <li><h2>Interfaces</h2>
557 <ul>
558 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/EspressoException.html">EspressoException</a></li>
559 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/FailureHandler.html">FailureHandler</a></li>
560 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></li>
561 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/IdlingResource.ResourceCallback.html">IdlingResource.ResourceCallback</a></li>
562 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/UiController.html">UiController</a></li>
563 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/ViewAction.html">ViewAction</a></li>
564 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/ViewAssertion.html">ViewAssertion</a></li>
565 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/ViewFinder.html">ViewFinder</a></li>
566 </ul>
567 </li>
568
569 <li><h2>Classes</h2>
570 <ul>
571 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/AmbiguousViewMatcherException.Builder.html">AmbiguousViewMatcherException.Builder</a></li>
572 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></li>
573 <li class="selected api apilevel-"><a href="../../../../../reference/android/support/test/espresso/Espresso.html">Espresso</a></li>
574 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/GraphHolder.html">GraphHolder</a></li>
575 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/IdlingPolicies.html">IdlingPolicies</a></li>
576 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/IdlingPolicy.html">IdlingPolicy</a></li>
577 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/NoMatchingViewException.Builder.html">NoMatchingViewException.Builder</a></li>
578 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/PerformException.Builder.html">PerformException.Builder</a></li>
579 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/Root.html">Root</a></li>
580 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/Root.Builder.html">Root.Builder</a></li>
581 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></li>
582 </ul>
583 </li>
584
585
586 <li><h2>Exceptions</h2>
587 <ul>
588 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/AmbiguousViewMatcherException.html">AmbiguousViewMatcherException</a></li>
589 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/AppNotIdleException.html">AppNotIdleException</a></li>
590 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/IdlingResourceTimeoutException.html">IdlingResourceTimeoutException</a></li>
591 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/InjectEventSecurityException.html">InjectEventSecurityException</a></li>
592 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/NoActivityResumedException.html">NoActivityResumedException</a></li>
593 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/NoMatchingRootException.html">NoMatchingRootException</a></li>
594 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/NoMatchingViewException.html">NoMatchingViewException</a></li>
595 <li class="api apilevel-"><a href="../../../../../reference/android/support/test/espresso/PerformException.html">PerformException</a></li>
596 </ul>
597 </li>
598
599 </ul><br/>
600
601
602 </div><!-- end classes -->
603 </div><!-- end nav-panels -->
604 <div id="nav-tree" style="display:none" class="scroll-pane">
605 <div id="tree-list"></div>
606 </div><!-- end nav-tree -->
607 </div><!-- end swapper -->
608 <div id="nav-swap">
609 <a class="fullscreen">fullscreen</a>
610 <a href='#' onclick='swapNav();return false;'><span id='tree-link'>Use Tree Navigation</span><span id='panel-link' style='display:none'>Use Panel Navigation</span></a>
611 </div>
612 </div> <!-- end devdoc-nav -->
613 </div> <!-- end side-nav -->
614 <script type="text/javascript">
615 // init fullscreen based on user pref
616 var fullscreen = readCookie("fullscreen");
617 if (fullscreen != 0) {
618 if (fullscreen == "false") {
619 toggleFullscreen(false);
620 } else {
621 toggleFullscreen(true);
622 }
623 }
624 // init nav version for mobile
625 if (isMobile) {
626 swapNav(); // tree view should be used on mobile
627 $('#nav-swap').hide();
628 } else {
629 chooseDefaultNav();
630 if ($("#nav-tree").is(':visible')) {
631 init_default_navtree("../../../../../");
632 }
633 }
634 // scroll the selected page into view
635 $(document).ready(function() {
636 scrollIntoView("packages-nav");
637 scrollIntoView("classes-nav");
638 });
639 </script>
640
641
642
643
644
645<div class="col-12" id="doc-col">
646
647<div id="api-info-block">
648
649
650
651
652
653
654
655
656
657
658
659<div class="sum-details-links">
660
661Summary:
662
663
664
665
666
667
668
669
670
671
672
673 <a href="#pubmethods">Methods</a>
674
675
676
677
678 &#124; <a href="#inhmethods">Inherited Methods</a>
679
680&#124; <a href="#" onclick="return toggleAllClassInherited()" id="toggleAllClassInherited">[Expand All]</a>
681
682</div><!-- end sum-details-links -->
683<div class="api-level">
684
685
686
687
688</div>
689</div><!-- end api-info-block -->
690
691
692<!-- ======== START OF CLASS DATA ======== -->
693
694<div id="jd-header">
695 public
696
697 final
698
699 class
700<h1 itemprop="name">Espresso</h1>
701
702
703
704
705 extends Object<br/>
706
707
708
709
710
711
712
713
714
715
716
717
718</div><!-- end header -->
719
720<div id="naMessage"></div>
721
722<div id="jd-content" class="api apilevel-">
723<table class="jd-inheritance-table">
724
725
726 <tr>
727
728 <td colspan="2" class="jd-inheritance-class-cell">java.lang.Object</td>
729 </tr>
730
731
732 <tr>
733
734 <td class="jd-inheritance-space">&nbsp;&nbsp;&nbsp;&#x21b3;</td>
735
736 <td colspan="1" class="jd-inheritance-class-cell">android.support.test.espresso.Espresso</td>
737 </tr>
738
739
740</table>
741
742
743
744
745
746
747
748<div class="jd-descr">
749
750
751<h2>Class Overview</h2>
752<p itemprop="articleBody">Entry point to the Espresso framework. Test authors can initiate testing by using one of the on*
753 methods (e.g. onView) or perform top-level user actions (e.g. pressBack).
754</p>
755
756
757
758
759
760</div><!-- jd-descr -->
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777<div class="jd-descr">
778
779
780<h2>Summary</h2>
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808<!-- ========== METHOD SUMMARY =========== -->
809<table id="pubmethods" class="jd-sumtable"><tr><th colspan="12">Public Methods</th></tr>
810
811
812
813
814 <tr class="alt-color api apilevel-" >
815 <td class="jd-typecol"><nobr>
816
817
818
819 static
820
821 void</nobr>
822 </td>
823 <td class="jd-linkcol" width="100%"><nobr>
824 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#closeSoftKeyboard()">closeSoftKeyboard</a></span>()</nobr>
825
826 <div class="jd-descrdiv">
827 Closes soft keyboard if open.
828
829
830
831 </div>
832
833 </td></tr>
834
835
836
837 <tr class=" api apilevel-" >
838 <td class="jd-typecol"><nobr>
839
840
841
842 static
843
844 List&lt;<a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a>&gt;</nobr>
845 </td>
846 <td class="jd-linkcol" width="100%"><nobr>
847 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#getIdlingResources()">getIdlingResources</a></span>()</nobr>
848
849 <div class="jd-descrdiv">
850 Returns a list of all currently registered <code><a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></code>s.
851
852
853
854 </div>
855
856 </td></tr>
857
858
859
860 <tr class="alt-color api apilevel-" >
861 <td class="jd-typecol"><nobr>
862
863
864
865 static
866
867 <a href="../../../../../reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></nobr>
868 </td>
869 <td class="jd-linkcol" width="100%"><nobr>
870 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#onData(org.hamcrest.Matcher<java.lang.Object>)">onData</a></span>(Matcher&lt;Object&gt; dataMatcher)</nobr>
871
872 <div class="jd-descrdiv">
873 Creates an <code><a href="../../../../../reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code> for a data object displayed by the application.
874
875
876
877 </div>
878
879 </td></tr>
880
881
882
883 <tr class=" api apilevel-" >
884 <td class="jd-typecol"><nobr>
885
886
887
888 static
889
890 <a href="../../../../../reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></nobr>
891 </td>
892 <td class="jd-linkcol" width="100%"><nobr>
893 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#onView(org.hamcrest.Matcher<android.view.View>)">onView</a></span>(Matcher&lt;View&gt; viewMatcher)</nobr>
894
895 <div class="jd-descrdiv">
896 Creates a <code><a href="../../../../../reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code> for a given view.
897
898
899
900 </div>
901
902 </td></tr>
903
904
905
906 <tr class="alt-color api apilevel-" >
907 <td class="jd-typecol"><nobr>
908
909
910
911 static
912
913 void</nobr>
914 </td>
915 <td class="jd-linkcol" width="100%"><nobr>
916 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#openActionBarOverflowOrOptionsMenu(android.content.Context)">openActionBarOverflowOrOptionsMenu</a></span>(Context context)</nobr>
917
918 <div class="jd-descrdiv">
919 Opens the overflow menu displayed within an ActionBar.
920
921
922
923 </div>
924
925 </td></tr>
926
927
928
929 <tr class=" api apilevel-" >
930 <td class="jd-typecol"><nobr>
931
932
933
934 static
935
936 void</nobr>
937 </td>
938 <td class="jd-linkcol" width="100%"><nobr>
939 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#openContextualActionModeOverflowMenu()">openContextualActionModeOverflowMenu</a></span>()</nobr>
940
941 <div class="jd-descrdiv">
942 Opens the overflow menu displayed in the contextual options of an ActionMode.
943
944
945
946 </div>
947
948 </td></tr>
949
950
951
952 <tr class="alt-color api apilevel-" >
953 <td class="jd-typecol"><nobr>
954
955
956
957 static
958
959 void</nobr>
960 </td>
961 <td class="jd-linkcol" width="100%"><nobr>
962 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#pressBack()">pressBack</a></span>()</nobr>
963
964 <div class="jd-descrdiv">
965 Press on the back button.
966
967
968
969 </div>
970
971 </td></tr>
972
973
974
975 <tr class=" api apilevel-" >
976 <td class="jd-typecol"><nobr>
977
978
979
980 static
981
982 boolean</nobr>
983 </td>
984 <td class="jd-linkcol" width="100%"><nobr>
985 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#registerIdlingResources(android.support.test.espresso.IdlingResource...)">registerIdlingResources</a></span>(<a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource...</a> resources)</nobr>
986
987 <div class="jd-descrdiv">
988 Registers one or more <code><a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></code>s with the framework.
989
990
991
992 </div>
993
994 </td></tr>
995
996
997
998 <tr class="alt-color api apilevel-" >
999 <td class="jd-typecol"><nobr>
1000
1001
1002
1003 static
1004
1005 void</nobr>
1006 </td>
1007 <td class="jd-linkcol" width="100%"><nobr>
1008 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#registerLooperAsIdlingResource(android.os.Looper, boolean)">registerLooperAsIdlingResource</a></span>(Looper looper, boolean considerWaitIdle)</nobr>
1009
1010 <div class="jd-descrdiv">
1011 Registers a Looper for idle checking with the framework.
1012
1013
1014
1015 </div>
1016
1017 </td></tr>
1018
1019
1020
1021 <tr class=" api apilevel-" >
1022 <td class="jd-typecol"><nobr>
1023
1024
1025
1026 static
1027
1028 void</nobr>
1029 </td>
1030 <td class="jd-linkcol" width="100%"><nobr>
1031 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#registerLooperAsIdlingResource(android.os.Looper)">registerLooperAsIdlingResource</a></span>(Looper looper)</nobr>
1032
1033 <div class="jd-descrdiv">
1034 Registers a Looper for idle checking with the framework.
1035
1036
1037
1038 </div>
1039
1040 </td></tr>
1041
1042
1043
1044 <tr class="alt-color api apilevel-" >
1045 <td class="jd-typecol"><nobr>
1046
1047
1048
1049 static
1050
1051 void</nobr>
1052 </td>
1053 <td class="jd-linkcol" width="100%"><nobr>
1054 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#setFailureHandler(android.support.test.espresso.FailureHandler)">setFailureHandler</a></span>(<a href="../../../../../reference/android/support/test/espresso/FailureHandler.html">FailureHandler</a> failureHandler)</nobr>
1055
1056 <div class="jd-descrdiv">
1057 Changes the default <code><a href="../../../../../reference/android/support/test/espresso/FailureHandler.html">FailureHandler</a></code> to the given one.
1058
1059
1060
1061 </div>
1062
1063 </td></tr>
1064
1065
1066
1067 <tr class=" api apilevel-" >
1068 <td class="jd-typecol"><nobr>
1069
1070
1071
1072 static
1073
1074 boolean</nobr>
1075 </td>
1076 <td class="jd-linkcol" width="100%"><nobr>
1077 <span class="sympad"><a href="../../../../../reference/android/support/test/espresso/Espresso.html#unregisterIdlingResources(android.support.test.espresso.IdlingResource...)">unregisterIdlingResources</a></span>(<a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource...</a> resources)</nobr>
1078
1079 <div class="jd-descrdiv">
1080 Unregisters one or more <code><a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></code>s.
1081
1082
1083
1084 </div>
1085
1086 </td></tr>
1087
1088
1089
1090</table>
1091
1092
1093
1094
1095
1096
1097
1098<!-- ========== METHOD SUMMARY =========== -->
1099<table id="inhmethods" class="jd-sumtable"><tr><th>
1100 <a href="#" class="toggle-all" onclick="return toggleAllInherited(this, null)">[Expand]</a>
1101 <div style="clear:left;">Inherited Methods</div></th></tr>
1102
1103
1104<tr class="api apilevel-" >
1105<td colspan="12">
1106 <a href="#" onclick="return toggleInherited(this, null)" id="inherited-methods-java.lang.Object" class="jd-expando-trigger closed"
1107 ><img id="inherited-methods-java.lang.Object-trigger"
1108 src="../../../../../assets/images/triangle-closed.png"
1109 class="jd-expando-trigger-img" /></a>
1110From class
1111
1112 java.lang.Object
1113
1114<div id="inherited-methods-java.lang.Object">
1115 <div id="inherited-methods-java.lang.Object-list"
1116 class="jd-inheritedlinks">
1117 </div>
1118 <div id="inherited-methods-java.lang.Object-summary" style="display: none;">
1119 <table class="jd-sumtable-expando">
1120
1121
1122
1123
1124 <tr class="alt-color api apilevel-" >
1125 <td class="jd-typecol"><nobr>
1126
1127
1128
1129
1130
1131 Object</nobr>
1132 </td>
1133 <td class="jd-linkcol" width="100%"><nobr>
1134 <span class="sympad">clone</span>()</nobr>
1135
1136 </td></tr>
1137
1138
1139
1140 <tr class=" api apilevel-" >
1141 <td class="jd-typecol"><nobr>
1142
1143
1144
1145
1146
1147 boolean</nobr>
1148 </td>
1149 <td class="jd-linkcol" width="100%"><nobr>
1150 <span class="sympad">equals</span>(Object arg0)</nobr>
1151
1152 </td></tr>
1153
1154
1155
1156 <tr class="alt-color api apilevel-" >
1157 <td class="jd-typecol"><nobr>
1158
1159
1160
1161
1162
1163 void</nobr>
1164 </td>
1165 <td class="jd-linkcol" width="100%"><nobr>
1166 <span class="sympad">finalize</span>()</nobr>
1167
1168 </td></tr>
1169
1170
1171
1172 <tr class=" api apilevel-" >
1173 <td class="jd-typecol"><nobr>
1174
1175
1176 final
1177
1178
1179 Class&lt;?&gt;</nobr>
1180 </td>
1181 <td class="jd-linkcol" width="100%"><nobr>
1182 <span class="sympad">getClass</span>()</nobr>
1183
1184 </td></tr>
1185
1186
1187
1188 <tr class="alt-color api apilevel-" >
1189 <td class="jd-typecol"><nobr>
1190
1191
1192
1193
1194
1195 int</nobr>
1196 </td>
1197 <td class="jd-linkcol" width="100%"><nobr>
1198 <span class="sympad">hashCode</span>()</nobr>
1199
1200 </td></tr>
1201
1202
1203
1204 <tr class=" api apilevel-" >
1205 <td class="jd-typecol"><nobr>
1206
1207
1208 final
1209
1210
1211 void</nobr>
1212 </td>
1213 <td class="jd-linkcol" width="100%"><nobr>
1214 <span class="sympad">notify</span>()</nobr>
1215
1216 </td></tr>
1217
1218
1219
1220 <tr class="alt-color api apilevel-" >
1221 <td class="jd-typecol"><nobr>
1222
1223
1224 final
1225
1226
1227 void</nobr>
1228 </td>
1229 <td class="jd-linkcol" width="100%"><nobr>
1230 <span class="sympad">notifyAll</span>()</nobr>
1231
1232 </td></tr>
1233
1234
1235
1236 <tr class=" api apilevel-" >
1237 <td class="jd-typecol"><nobr>
1238
1239
1240
1241
1242
1243 String</nobr>
1244 </td>
1245 <td class="jd-linkcol" width="100%"><nobr>
1246 <span class="sympad">toString</span>()</nobr>
1247
1248 </td></tr>
1249
1250
1251
1252 <tr class="alt-color api apilevel-" >
1253 <td class="jd-typecol"><nobr>
1254
1255
1256 final
1257
1258
1259 void</nobr>
1260 </td>
1261 <td class="jd-linkcol" width="100%"><nobr>
1262 <span class="sympad">wait</span>()</nobr>
1263
1264 </td></tr>
1265
1266
1267
1268 <tr class=" api apilevel-" >
1269 <td class="jd-typecol"><nobr>
1270
1271
1272 final
1273
1274
1275 void</nobr>
1276 </td>
1277 <td class="jd-linkcol" width="100%"><nobr>
1278 <span class="sympad">wait</span>(long arg0, int arg1)</nobr>
1279
1280 </td></tr>
1281
1282
1283
1284 <tr class="alt-color api apilevel-" >
1285 <td class="jd-typecol"><nobr>
1286
1287
1288 final
1289
1290
1291 void</nobr>
1292 </td>
1293 <td class="jd-linkcol" width="100%"><nobr>
1294 <span class="sympad">wait</span>(long arg0)</nobr>
1295
1296 </td></tr>
1297
1298
1299</table>
1300 </div>
1301</div>
1302</td></tr>
1303
1304
1305</table>
1306
1307
1308</div><!-- jd-descr (summary) -->
1309
1310<!-- Details -->
1311
1312
1313
1314
1315
1316
1317
1318
1319<!-- XML Attributes -->
1320
1321
1322<!-- Enum Values -->
1323
1324
1325<!-- Constants -->
1326
1327
1328<!-- Fields -->
1329
1330
1331<!-- Public ctors -->
1332
1333
1334
1335<!-- ========= CONSTRUCTOR DETAIL ======== -->
1336<!-- Protected ctors -->
1337
1338
1339
1340<!-- ========= METHOD DETAIL ======== -->
1341<!-- Public methdos -->
1342
1343<h2>Public Methods</h2>
1344
1345
1346
1347<A NAME="closeSoftKeyboard()"></A>
1348
1349<div class="jd-details api apilevel-">
1350 <h4 class="jd-details-title">
1351 <span class="normal">
1352 public
1353 static
1354
1355
1356
1357 void
1358 </span>
1359 <span class="sympad">closeSoftKeyboard</span>
1360 <span class="normal">()</span>
1361 </h4>
1362 <div class="api-level">
1363 <div></div>
1364
1365
1366
1367 </div>
1368 <div class="jd-details-descr">
1369
1370
1371
1372
1373 <div class="jd-tagdata jd-tagdescr"><p>Closes soft keyboard if open.
1374</p></div>
1375
1376 </div>
1377</div>
1378
1379
1380<A NAME="getIdlingResources()"></A>
1381
1382<div class="jd-details api apilevel-">
1383 <h4 class="jd-details-title">
1384 <span class="normal">
1385 public
1386 static
1387
1388
1389
1390 List&lt;<a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a>&gt;
1391 </span>
1392 <span class="sympad">getIdlingResources</span>
1393 <span class="normal">()</span>
1394 </h4>
1395 <div class="api-level">
1396 <div></div>
1397
1398
1399
1400 </div>
1401 <div class="jd-details-descr">
1402
1403
1404
1405
1406 <div class="jd-tagdata jd-tagdescr"><p>Returns a list of all currently registered <code><a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></code>s.
1407</p></div>
1408
1409 </div>
1410</div>
1411
1412
1413<A NAME="onData(org.hamcrest.Matcher<java.lang.Object>)"></A>
1414
1415<div class="jd-details api apilevel-">
1416 <h4 class="jd-details-title">
1417 <span class="normal">
1418 public
1419 static
1420
1421
1422
1423 <a href="../../../../../reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a>
1424 </span>
1425 <span class="sympad">onData</span>
1426 <span class="normal">(Matcher&lt;Object&gt; dataMatcher)</span>
1427 </h4>
1428 <div class="api-level">
1429 <div></div>
1430
1431
1432
1433 </div>
1434 <div class="jd-details-descr">
1435
1436
1437
1438
1439 <div class="jd-tagdata jd-tagdescr"><p>Creates an <code><a href="../../../../../reference/android/support/test/espresso/DataInteraction.html">DataInteraction</a></code> for a data object displayed by the application. Use this
1440 method to load (into the view hierarchy) items from AdapterView widgets (e.g. ListView).</p></div>
1441 <div class="jd-tagdata">
1442 <h5 class="jd-tagtitle">Parameters</h5>
1443 <table class="jd-tagtable">
1444 <tr>
1445 <th>dataMatcher</td>
1446 <td>a matcher used to find the data object.
1447</td>
1448 </tr>
1449 </table>
1450 </div>
1451
1452 </div>
1453</div>
1454
1455
1456<A NAME="onView(org.hamcrest.Matcher<android.view.View>)"></A>
1457
1458<div class="jd-details api apilevel-">
1459 <h4 class="jd-details-title">
1460 <span class="normal">
1461 public
1462 static
1463
1464
1465
1466 <a href="../../../../../reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a>
1467 </span>
1468 <span class="sympad">onView</span>
1469 <span class="normal">(Matcher&lt;View&gt; viewMatcher)</span>
1470 </h4>
1471 <div class="api-level">
1472 <div></div>
1473
1474
1475
1476 </div>
1477 <div class="jd-details-descr">
1478
1479
1480
1481
1482 <div class="jd-tagdata jd-tagdescr"><p>Creates a <code><a href="../../../../../reference/android/support/test/espresso/ViewInteraction.html">ViewInteraction</a></code> for a given view. Note: the view has
1483 to be part of the view hierarchy. This may not be the case if it is rendered as part of
1484 an AdapterView (e.g. ListView). If this is the case, use Espresso.onData to load the view
1485 first.</p></div>
1486 <div class="jd-tagdata">
1487 <h5 class="jd-tagtitle">Parameters</h5>
1488 <table class="jd-tagtable">
1489 <tr>
1490 <th>viewMatcher</td>
1491 <td>used to select the view.</td>
1492 </tr>
1493 </table>
1494 </div>
1495 <div class="jd-tagdata">
1496 <h5 class="jd-tagtitle">See Also</h5>
1497 <ul class="nolist"><li><code><a href="../../../../../reference/android/support/test/espresso/Espresso.html#onData(org.hamcrest.Matcher<java.lang.Object>)">onData(org.hamcrest.Matcher)</a></code></li>
1498 </ul>
1499 </div>
1500
1501 </div>
1502</div>
1503
1504
1505<A NAME="openActionBarOverflowOrOptionsMenu(android.content.Context)"></A>
1506
1507<div class="jd-details api apilevel-">
1508 <h4 class="jd-details-title">
1509 <span class="normal">
1510 public
1511 static
1512
1513
1514
1515 void
1516 </span>
1517 <span class="sympad">openActionBarOverflowOrOptionsMenu</span>
1518 <span class="normal">(Context context)</span>
1519 </h4>
1520 <div class="api-level">
1521 <div></div>
1522
1523
1524
1525 </div>
1526 <div class="jd-details-descr">
1527
1528
1529
1530
1531 <div class="jd-tagdata jd-tagdescr"><p>Opens the overflow menu displayed within an ActionBar.
1532
1533 <p>This works with both native and SherlockActionBar ActionBars.
1534
1535 <p>Note the significant differences of UX between ActionMode and ActionBars with respect to
1536 overflows. If a hardware menu key is present, the overflow icon is never displayed in
1537 ActionBars and can only be interacted with via menu key presses.
1538</p></div>
1539
1540 </div>
1541</div>
1542
1543
1544<A NAME="openContextualActionModeOverflowMenu()"></A>
1545
1546<div class="jd-details api apilevel-">
1547 <h4 class="jd-details-title">
1548 <span class="normal">
1549 public
1550 static
1551
1552
1553
1554 void
1555 </span>
1556 <span class="sympad">openContextualActionModeOverflowMenu</span>
1557 <span class="normal">()</span>
1558 </h4>
1559 <div class="api-level">
1560 <div></div>
1561
1562
1563
1564 </div>
1565 <div class="jd-details-descr">
1566
1567
1568
1569
1570 <div class="jd-tagdata jd-tagdescr"><p>Opens the overflow menu displayed in the contextual options of an ActionMode.
1571
1572 <p>This works with both native and SherlockActionBar action modes.
1573
1574 <p>Note the significant difference in UX between ActionMode and ActionBar overflows -
1575 ActionMode will always present an overflow icon and that icon only responds to clicks.
1576 The menu button (if present) has no impact on it.
1577</p></div>
1578
1579 </div>
1580</div>
1581
1582
1583<A NAME="pressBack()"></A>
1584
1585<div class="jd-details api apilevel-">
1586 <h4 class="jd-details-title">
1587 <span class="normal">
1588 public
1589 static
1590
1591
1592
1593 void
1594 </span>
1595 <span class="sympad">pressBack</span>
1596 <span class="normal">()</span>
1597 </h4>
1598 <div class="api-level">
1599 <div></div>
1600
1601
1602
1603 </div>
1604 <div class="jd-details-descr">
1605
1606
1607
1608
1609 <div class="jd-tagdata jd-tagdescr"><p>Press on the back button.</p></div>
1610 <div class="jd-tagdata">
1611 <h5 class="jd-tagtitle">Throws</h5>
1612 <table class="jd-tagtable">
1613 <tr>
1614 <th><a href="../../../../../reference/android/support/test/espresso/PerformException.html">PerformException</a></td>
1615 <td>if currently displayed activity is root activity, since pressing back
1616 button would result in application closing.
1617</td>
1618 </tr>
1619 </table>
1620 </div>
1621
1622 </div>
1623</div>
1624
1625
1626<A NAME="registerIdlingResources(android.support.test.espresso.IdlingResource...)"></A>
1627
1628<div class="jd-details api apilevel-">
1629 <h4 class="jd-details-title">
1630 <span class="normal">
1631 public
1632 static
1633
1634
1635
1636 boolean
1637 </span>
1638 <span class="sympad">registerIdlingResources</span>
1639 <span class="normal">(<a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource...</a> resources)</span>
1640 </h4>
1641 <div class="api-level">
1642 <div></div>
1643
1644
1645
1646 </div>
1647 <div class="jd-details-descr">
1648
1649
1650
1651
1652 <div class="jd-tagdata jd-tagdescr"><p>Registers one or more <code><a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></code>s with the framework. It is expected, although not
1653 strictly required, that this method will be called at test setup time prior to any interaction
1654 with the application under test. When registering more than one resource, ensure that each has
1655 a unique name. If any of the given resources is already registered, a warning is logged.</p></div>
Quddus Chong900831f2015-04-17 15:01:16 -07001656 <div class="jd-tagdata">
1657 <h5 class="jd-tagtitle">Returns</h5>
1658 <ul class="nolist"><li><code>true</code> if all resources were successfully registered
1659</li></ul>
1660 </div>
Quddus Chong489218c2015-02-26 16:38:46 -08001661
1662 </div>
1663</div>
1664
1665
1666<A NAME="registerLooperAsIdlingResource(android.os.Looper, boolean)"></A>
1667
1668<div class="jd-details api apilevel-">
1669 <h4 class="jd-details-title">
1670 <span class="normal">
1671 public
1672 static
1673
1674
1675
1676 void
1677 </span>
1678 <span class="sympad">registerLooperAsIdlingResource</span>
1679 <span class="normal">(Looper looper, boolean considerWaitIdle)</span>
1680 </h4>
1681 <div class="api-level">
1682 <div></div>
1683
1684
1685
1686 </div>
1687 <div class="jd-details-descr">
1688
1689
1690
1691
1692 <div class="jd-tagdata jd-tagdescr"><p>Registers a Looper for idle checking with the framework. This is intended for use with
1693 non-UI thread loopers.
1694
1695 <p>This method allows the caller to consider Thread.State.WAIT to be 'idle'.
1696
1697 <p>This is useful in the case where a looper is sending a message to the UI thread
1698 synchronously through a wait/notify mechanism.</p></div>
1699 <div class="jd-tagdata">
1700 <h5 class="jd-tagtitle">Throws</h5>
1701 <table class="jd-tagtable">
1702 <tr>
1703 <th>IllegalArgumentException</td>
1704 <td>if looper is the main looper.
1705</td>
1706 </tr>
1707 </table>
1708 </div>
1709
1710 </div>
1711</div>
1712
1713
1714<A NAME="registerLooperAsIdlingResource(android.os.Looper)"></A>
1715
1716<div class="jd-details api apilevel-">
1717 <h4 class="jd-details-title">
1718 <span class="normal">
1719 public
1720 static
1721
1722
1723
1724 void
1725 </span>
1726 <span class="sympad">registerLooperAsIdlingResource</span>
1727 <span class="normal">(Looper looper)</span>
1728 </h4>
1729 <div class="api-level">
1730 <div></div>
1731
1732
1733
1734 </div>
1735 <div class="jd-details-descr">
1736
1737
1738
1739
1740 <div class="jd-tagdata jd-tagdescr"><p>Registers a Looper for idle checking with the framework. This is intended for use with
1741 non-UI thread loopers.</p></div>
1742 <div class="jd-tagdata">
1743 <h5 class="jd-tagtitle">Throws</h5>
1744 <table class="jd-tagtable">
1745 <tr>
1746 <th>IllegalArgumentException</td>
1747 <td>if looper is the main looper.
1748</td>
1749 </tr>
1750 </table>
1751 </div>
1752
1753 </div>
1754</div>
1755
1756
1757<A NAME="setFailureHandler(android.support.test.espresso.FailureHandler)"></A>
1758
1759<div class="jd-details api apilevel-">
1760 <h4 class="jd-details-title">
1761 <span class="normal">
1762 public
1763 static
1764
1765
1766
1767 void
1768 </span>
1769 <span class="sympad">setFailureHandler</span>
1770 <span class="normal">(<a href="../../../../../reference/android/support/test/espresso/FailureHandler.html">FailureHandler</a> failureHandler)</span>
1771 </h4>
1772 <div class="api-level">
1773 <div></div>
1774
1775
1776
1777 </div>
1778 <div class="jd-details-descr">
1779
1780
1781
1782
1783 <div class="jd-tagdata jd-tagdescr"><p>Changes the default <code><a href="../../../../../reference/android/support/test/espresso/FailureHandler.html">FailureHandler</a></code> to the given one.
1784</p></div>
1785
1786 </div>
1787</div>
1788
1789
1790<A NAME="unregisterIdlingResources(android.support.test.espresso.IdlingResource...)"></A>
1791
1792<div class="jd-details api apilevel-">
1793 <h4 class="jd-details-title">
1794 <span class="normal">
1795 public
1796 static
1797
1798
1799
1800 boolean
1801 </span>
1802 <span class="sympad">unregisterIdlingResources</span>
1803 <span class="normal">(<a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource...</a> resources)</span>
1804 </h4>
1805 <div class="api-level">
1806 <div></div>
1807
1808
1809
1810 </div>
1811 <div class="jd-details-descr">
1812
1813
1814
1815
1816 <div class="jd-tagdata jd-tagdescr"><p>Unregisters one or more <code><a href="../../../../../reference/android/support/test/espresso/IdlingResource.html">IdlingResource</a></code>s. If any of the given resources are not already
1817 registered, a warning is logged.</p></div>
Quddus Chong900831f2015-04-17 15:01:16 -07001818 <div class="jd-tagdata">
1819 <h5 class="jd-tagtitle">Returns</h5>
1820 <ul class="nolist"><li><code>true</code> if all resources were successfully unregistered
1821</li></ul>
1822 </div>
Quddus Chong489218c2015-02-26 16:38:46 -08001823
1824 </div>
1825</div>
1826
1827
1828
1829
1830
1831<!-- ========= METHOD DETAIL ======== -->
1832
1833
1834
1835<!-- ========= END OF CLASS DATA ========= -->
1836<A NAME="navbar_top"></A>
1837
1838<div id="footer" class="wrap" >
1839
1840
1841 <div id="copyright">
1842
1843 Except as noted, this content is licensed under <a
1844 href="http://www.apache.org/licenses/LICENSE-2.0">Apache 2.0</a>.
1845 For details and restrictions, see the <a href="../../../../../license.html">
1846 Content License</a>.
1847 </div>
1848 <div id="build_info">
1849
1850 Android &nbsp;r &mdash;
1851<script src="../../../../../timestamp.js" type="text/javascript"></script>
1852<script>document.write(BUILD_TIMESTAMP)</script>
1853
1854 </div>
1855
1856
1857 <div id="footerlinks">
1858
1859 <p>
1860 <a href="../../../../../about/index.html">About Android</a>&nbsp;&nbsp;|&nbsp;
1861 <a href="../../../../../legal.html">Legal</a>&nbsp;&nbsp;|&nbsp;
1862 <a href="../../../../../support.html">Support</a>
1863 </p>
1864 </div>
1865
1866</div> <!-- end footer -->
1867</div> <!-- jd-content -->
1868
1869</div><!-- end doc-content -->
1870
1871</div> <!-- end body-content -->
1872
1873
1874
1875
1876
1877
1878</body>
1879</html>