selenium-webdriver 2.43.5 → 2.44.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/CHANGES.md +20 -0
  2. package/README.md +8 -13
  3. package/builder.js +4 -3
  4. package/docs/class_webdriver_Alert.html +6 -6
  5. package/docs/class_webdriver_AlertPromise.html +6 -6
  6. package/docs/class_webdriver_UnhandledAlertError.html +4 -4
  7. package/docs/class_webdriver_WebDriver.html +39 -37
  8. package/docs/class_webdriver_WebDriver_Logs.html +3 -3
  9. package/docs/class_webdriver_WebDriver_Navigation.html +5 -5
  10. package/docs/class_webdriver_WebDriver_Options.html +9 -9
  11. package/docs/class_webdriver_WebDriver_TargetLocator.html +6 -6
  12. package/docs/class_webdriver_WebDriver_Timeouts.html +4 -4
  13. package/docs/class_webdriver_WebDriver_Window.html +6 -6
  14. package/docs/class_webdriver_WebElement.html +23 -23
  15. package/docs/class_webdriver_WebElementPromise.html +22 -22
  16. package/docs/class_webdriver_promise_CancellationError.html +3 -0
  17. package/docs/class_webdriver_promise_ControlFlow.html +32 -32
  18. package/docs/class_webdriver_promise_Deferred.html +7 -8
  19. package/docs/class_webdriver_promise_Frame_.html +14 -30
  20. package/docs/class_webdriver_promise_Promise.html +2 -2
  21. package/docs/class_webdriver_promise_Task_.html +12 -12
  22. package/docs/class_webdriver_until_Condition.html +3 -0
  23. package/docs/enum_webdriver_Key.html +1 -1
  24. package/docs/enum_webdriver_promise_ControlFlow_EventType.html +1 -1
  25. package/docs/enum_webdriver_promise_Deferred_State_.html +1 -1
  26. package/docs/index.html +8 -13
  27. package/docs/interface_webdriver_promise_Thenable.html +8 -10
  28. package/docs/license.html +1 -1
  29. package/docs/module_selenium-webdriver.html +2 -2
  30. package/docs/module_selenium-webdriver__base.html +1 -1
  31. package/docs/module_selenium-webdriver__base_class_Context.html +1 -1
  32. package/docs/module_selenium-webdriver_builder.html +1 -1
  33. package/docs/module_selenium-webdriver_builder_class_Builder.html +1 -1
  34. package/docs/module_selenium-webdriver_chrome.html +1 -1
  35. package/docs/module_selenium-webdriver_chrome_class_Driver.html +2 -2
  36. package/docs/module_selenium-webdriver_chrome_class_Options.html +2 -2
  37. package/docs/module_selenium-webdriver_chrome_class_ServiceBuilder.html +1 -1
  38. package/docs/module_selenium-webdriver_error.html +1 -1
  39. package/docs/module_selenium-webdriver_executors.html +1 -1
  40. package/docs/module_selenium-webdriver_firefox.html +1 -1
  41. package/docs/module_selenium-webdriver_firefox_binary.html +1 -1
  42. package/docs/module_selenium-webdriver_firefox_binary_class_Binary.html +1 -1
  43. package/docs/module_selenium-webdriver_firefox_class_Driver.html +2 -2
  44. package/docs/module_selenium-webdriver_firefox_class_Options.html +1 -1
  45. package/docs/module_selenium-webdriver_firefox_extension.html +1 -1
  46. package/docs/module_selenium-webdriver_firefox_profile.html +1 -1
  47. package/docs/module_selenium-webdriver_firefox_profile_class_Profile.html +1 -1
  48. package/docs/module_selenium-webdriver_http.html +1 -1
  49. package/docs/module_selenium-webdriver_http_class_HttpClient.html +1 -1
  50. package/docs/module_selenium-webdriver_http_util.html +1 -1
  51. package/docs/module_selenium-webdriver_io.html +1 -1
  52. package/docs/module_selenium-webdriver_io_exec.html +1 -1
  53. package/docs/module_selenium-webdriver_net.html +1 -1
  54. package/docs/module_selenium-webdriver_net_portprober.html +1 -1
  55. package/docs/module_selenium-webdriver_phantomjs.html +1 -1
  56. package/docs/module_selenium-webdriver_phantomjs_class_Driver.html +2 -2
  57. package/docs/module_selenium-webdriver_proxy.html +1 -1
  58. package/docs/module_selenium-webdriver_remote.html +1 -1
  59. package/docs/module_selenium-webdriver_remote_class_DriverService.html +2 -2
  60. package/docs/module_selenium-webdriver_remote_class_SeleniumServer.html +2 -2
  61. package/docs/module_selenium-webdriver_testing.html +16 -29
  62. package/docs/module_selenium-webdriver_testing_assert.html +1 -1
  63. package/docs/namespace_webdriver_promise.html +18 -20
  64. package/docs/namespace_webdriver_stacktrace.html +15 -15
  65. package/docs/namespace_webdriver_until.html +32 -0
  66. package/docs/source/_base.js.src.html +1 -1
  67. package/docs/source/builder.js.src.html +1 -1
  68. package/docs/source/chrome.js.src.html +1 -1
  69. package/docs/source/error.js.src.html +1 -1
  70. package/docs/source/executors.js.src.html +1 -1
  71. package/docs/source/firefox/binary.js.src.html +1 -1
  72. package/docs/source/firefox/extension.js.src.html +1 -1
  73. package/docs/source/firefox/index.js.src.html +1 -1
  74. package/docs/source/firefox/profile.js.src.html +1 -1
  75. package/docs/source/http/index.js.src.html +1 -1
  76. package/docs/source/http/util.js.src.html +1 -1
  77. package/docs/source/index.js.src.html +1 -1
  78. package/docs/source/io/exec.js.src.html +1 -1
  79. package/docs/source/io/index.js.src.html +1 -1
  80. package/docs/source/lib/atoms/error.js.src.html +1 -1
  81. package/docs/source/lib/atoms/json.js.src.html +1 -1
  82. package/docs/source/lib/atoms/response.js.src.html +1 -1
  83. package/docs/source/lib/atoms/userAgent.js.src.html +1 -1
  84. package/docs/source/lib/goog/array/array.js.src.html +1 -1
  85. package/docs/source/lib/goog/asserts/asserts.js.src.html +1 -1
  86. package/docs/source/lib/goog/async/nexttick.js.src.html +1 -1
  87. package/docs/source/lib/goog/async/run.js.src.html +1 -1
  88. package/docs/source/lib/goog/base.js.src.html +1 -1
  89. package/docs/source/lib/goog/debug/debug.js.src.html +1 -1
  90. package/docs/source/lib/goog/debug/entrypointregistry.js.src.html +1 -1
  91. package/docs/source/lib/goog/debug/error.js.src.html +1 -1
  92. package/docs/source/lib/goog/debug/logbuffer.js.src.html +1 -1
  93. package/docs/source/lib/goog/debug/logger.js.src.html +1 -1
  94. package/docs/source/lib/goog/debug/logrecord.js.src.html +1 -1
  95. package/docs/source/lib/goog/deps.js.src.html +1 -1
  96. package/docs/source/lib/goog/disposable/disposable.js.src.html +1 -1
  97. package/docs/source/lib/goog/disposable/idisposable.js.src.html +1 -1
  98. package/docs/source/lib/goog/dom/browserfeature.js.src.html +1 -1
  99. package/docs/source/lib/goog/dom/dom.js.src.html +1 -1
  100. package/docs/source/lib/goog/dom/nodetype.js.src.html +1 -1
  101. package/docs/source/lib/goog/dom/tagname.js.src.html +1 -1
  102. package/docs/source/lib/goog/dom/vendor.js.src.html +1 -1
  103. package/docs/source/lib/goog/events/browserevent.js.src.html +1 -1
  104. package/docs/source/lib/goog/events/browserfeature.js.src.html +1 -1
  105. package/docs/source/lib/goog/events/event.js.src.html +1 -1
  106. package/docs/source/lib/goog/events/eventid.js.src.html +1 -1
  107. package/docs/source/lib/goog/events/events.js.src.html +1 -1
  108. package/docs/source/lib/goog/events/eventtarget.js.src.html +1 -1
  109. package/docs/source/lib/goog/events/eventtype.js.src.html +1 -1
  110. package/docs/source/lib/goog/events/keycodes.js.src.html +1 -1
  111. package/docs/source/lib/goog/events/listenable.js.src.html +1 -1
  112. package/docs/source/lib/goog/events/listener.js.src.html +1 -1
  113. package/docs/source/lib/goog/events/listenermap.js.src.html +1 -1
  114. package/docs/source/lib/goog/functions/functions.js.src.html +1 -1
  115. package/docs/source/lib/goog/iter/iter.js.src.html +1 -1
  116. package/docs/source/lib/goog/json/json.js.src.html +1 -1
  117. package/docs/source/lib/goog/labs/testing/assertthat.js.src.html +1 -1
  118. package/docs/source/lib/goog/labs/testing/logicmatcher.js.src.html +1 -1
  119. package/docs/source/lib/goog/labs/testing/matcher.js.src.html +1 -1
  120. package/docs/source/lib/goog/labs/testing/numbermatcher.js.src.html +1 -1
  121. package/docs/source/lib/goog/labs/testing/objectmatcher.js.src.html +1 -1
  122. package/docs/source/lib/goog/labs/testing/stringmatcher.js.src.html +1 -1
  123. package/docs/source/lib/goog/labs/useragent/browser.js.src.html +1 -1
  124. package/docs/source/lib/goog/labs/useragent/engine.js.src.html +1 -1
  125. package/docs/source/lib/goog/labs/useragent/util.js.src.html +1 -1
  126. package/docs/source/lib/goog/math/box.js.src.html +1 -1
  127. package/docs/source/lib/goog/math/coordinate.js.src.html +1 -1
  128. package/docs/source/lib/goog/math/math.js.src.html +1 -1
  129. package/docs/source/lib/goog/math/rect.js.src.html +1 -1
  130. package/docs/source/lib/goog/math/size.js.src.html +1 -1
  131. package/docs/source/lib/goog/net/wrapperxmlhttpfactory.js.src.html +1 -1
  132. package/docs/source/lib/goog/net/xhrlike.js.src.html +1 -1
  133. package/docs/source/lib/goog/net/xmlhttp.js.src.html +1 -1
  134. package/docs/source/lib/goog/net/xmlhttpfactory.js.src.html +1 -1
  135. package/docs/source/lib/goog/object/object.js.src.html +1 -1
  136. package/docs/source/lib/goog/reflect/reflect.js.src.html +1 -1
  137. package/docs/source/lib/goog/string/string.js.src.html +1 -1
  138. package/docs/source/lib/goog/structs/collection.js.src.html +1 -1
  139. package/docs/source/lib/goog/structs/map.js.src.html +1 -1
  140. package/docs/source/lib/goog/structs/set.js.src.html +1 -1
  141. package/docs/source/lib/goog/structs/structs.js.src.html +1 -1
  142. package/docs/source/lib/goog/style/style.js.src.html +1 -1
  143. package/docs/source/lib/goog/testing/asserts.js.src.html +1 -1
  144. package/docs/source/lib/goog/testing/asynctestcase.js.src.html +1 -1
  145. package/docs/source/lib/goog/testing/events/events.js.src.html +1 -1
  146. package/docs/source/lib/goog/testing/functionmock.js.src.html +1 -1
  147. package/docs/source/lib/goog/testing/jsunit.js.src.html +1 -1
  148. package/docs/source/lib/goog/testing/loosemock.js.src.html +1 -1
  149. package/docs/source/lib/goog/testing/mock.js.src.html +1 -1
  150. package/docs/source/lib/goog/testing/mockclock.js.src.html +1 -1
  151. package/docs/source/lib/goog/testing/mockcontrol.js.src.html +1 -1
  152. package/docs/source/lib/goog/testing/mockinterface.js.src.html +1 -1
  153. package/docs/source/lib/goog/testing/mockmatchers.js.src.html +1 -1
  154. package/docs/source/lib/goog/testing/objectpropertystring.js.src.html +1 -1
  155. package/docs/source/lib/goog/testing/propertyreplacer.js.src.html +1 -1
  156. package/docs/source/lib/goog/testing/recordfunction.js.src.html +1 -1
  157. package/docs/source/lib/goog/testing/stacktrace.js.src.html +1 -1
  158. package/docs/source/lib/goog/testing/strictmock.js.src.html +1 -1
  159. package/docs/source/lib/goog/testing/testcase.js.src.html +1 -1
  160. package/docs/source/lib/goog/testing/testrunner.js.src.html +1 -1
  161. package/docs/source/lib/goog/testing/watchers.js.src.html +1 -1
  162. package/docs/source/lib/goog/uri/uri.js.src.html +1 -1
  163. package/docs/source/lib/goog/uri/utils.js.src.html +1 -1
  164. package/docs/source/lib/goog/useragent/product.js.src.html +1 -1
  165. package/docs/source/lib/goog/useragent/product_isversion.js.src.html +1 -1
  166. package/docs/source/lib/goog/useragent/useragent.js.src.html +1 -1
  167. package/docs/source/lib/webdriver/abstractbuilder.js.src.html +1 -1
  168. package/docs/source/lib/webdriver/actionsequence.js.src.html +1 -1
  169. package/docs/source/lib/webdriver/builder.js.src.html +1 -1
  170. package/docs/source/lib/webdriver/button.js.src.html +1 -1
  171. package/docs/source/lib/webdriver/capabilities.js.src.html +1 -1
  172. package/docs/source/lib/webdriver/command.js.src.html +1 -1
  173. package/docs/source/lib/webdriver/events.js.src.html +1 -1
  174. package/docs/source/lib/webdriver/firefoxdomexecutor.js.src.html +1 -1
  175. package/docs/source/lib/webdriver/http/corsclient.js.src.html +1 -1
  176. package/docs/source/lib/webdriver/http/http.js.src.html +1 -1
  177. package/docs/source/lib/webdriver/http/xhrclient.js.src.html +1 -1
  178. package/docs/source/lib/webdriver/key.js.src.html +1 -1
  179. package/docs/source/lib/webdriver/locators.js.src.html +1 -1
  180. package/docs/source/lib/webdriver/logging.js.src.html +1 -1
  181. package/docs/source/lib/webdriver/process.js.src.html +1 -1
  182. package/docs/source/lib/webdriver/promise.js.src.html +1 -1
  183. package/docs/source/lib/webdriver/session.js.src.html +1 -1
  184. package/docs/source/lib/webdriver/stacktrace.js.src.html +1 -1
  185. package/docs/source/lib/webdriver/testing/asserts.js.src.html +1 -1
  186. package/docs/source/lib/webdriver/testing/testcase.js.src.html +1 -1
  187. package/docs/source/lib/webdriver/until.js.src.html +1 -0
  188. package/docs/source/lib/webdriver/webdriver.js.src.html +1 -1
  189. package/docs/source/net/index.js.src.html +1 -1
  190. package/docs/source/net/portprober.js.src.html +1 -1
  191. package/docs/source/phantomjs.js.src.html +1 -1
  192. package/docs/source/proxy.js.src.html +1 -1
  193. package/docs/source/remote/index.js.src.html +1 -1
  194. package/docs/source/testing/assert.js.src.html +1 -1
  195. package/docs/source/testing/index.js.src.html +1 -1
  196. package/docs/types.js +1 -1
  197. package/example/google_search.js +9 -17
  198. package/example/google_search_generator.js +6 -7
  199. package/example/google_search_test.js +10 -18
  200. package/example/parallel_flows.js +4 -7
  201. package/index.js +6 -0
  202. package/lib/firefox/webdriver.xpi +0 -0
  203. package/lib/goog/deps.js +7 -5
  204. package/lib/test/index.js +0 -8
  205. package/lib/webdriver/promise.js +263 -251
  206. package/lib/webdriver/stacktrace.js +15 -1
  207. package/lib/webdriver/test/promise_flow_test.js +82 -76
  208. package/lib/webdriver/test/promise_test.js +22 -62
  209. package/lib/webdriver/test/stacktrace_test.js +18 -0
  210. package/lib/webdriver/test/until_test.js +388 -0
  211. package/lib/webdriver/test/webdriver_test.js +41 -0
  212. package/lib/webdriver/until.js +408 -0
  213. package/lib/webdriver/webdriver.js +91 -29
  214. package/package.json +2 -2
  215. package/test/element_finding_test.js +6 -6
  216. package/test/http/util_test.js +4 -5
  217. package/test/page_loading_test.js +7 -7
  218. package/test/stale_element_test.js +2 -10
  219. package/testing/index.js +9 -22
package/docs/source/lib/goog/useragent/useragent.js.src.html CHANGED
@@ -1 +1 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>useragent.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/useragent/useragent.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Rendering engine detection.<tr><td><a name="l17" href="#l17">17</a><td> * @see &lt;a href=&quot;http://www.useragentstring.com/&quot;&gt;User agent strings&lt;/a&gt;<tr><td><a name="l18" href="#l18">18</a><td> * For information on the browser brand (such as Safari versus Chrome), see<tr><td><a name="l19" href="#l19">19</a><td> * goog.userAgent.product.<tr><td><a name="l20" href="#l20">20</a><td> * @see ../demos/useragent.html<tr><td><a name="l21" href="#l21">21</a><td> */<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.userAgent&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.labs.userAgent.browser&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.labs.userAgent.engine&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.labs.userAgent.util&#39;);<tr><td><a name="l28" href="#l28">28</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>/**<tr><td><a name="l32" href="#l32">32</a><td> * @define {boolean} Whether we know at compile-time that the browser is IE.<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>goog.define(&#39;goog.userAgent.ASSUME_IE&#39;, false);<tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>/**<tr><td><a name="l38" href="#l38">38</a><td> * @define {boolean} Whether we know at compile-time that the browser is GECKO.<tr><td><a name="l39" href="#l39">39</a><td> */<tr><td><a name="l40" href="#l40">40</a><td>goog.define(&#39;goog.userAgent.ASSUME_GECKO&#39;, false);<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>/**<tr><td><a name="l44" href="#l44">44</a><td> * @define {boolean} Whether we know at compile-time that the browser is WEBKIT.<tr><td><a name="l45" href="#l45">45</a><td> */<tr><td><a name="l46" href="#l46">46</a><td>goog.define(&#39;goog.userAgent.ASSUME_WEBKIT&#39;, false);<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>/**<tr><td><a name="l50" href="#l50">50</a><td> * @define {boolean} Whether we know at compile-time that the browser is a<tr><td><a name="l51" href="#l51">51</a><td> * mobile device running WebKit e.g. iPhone or Android.<tr><td><a name="l52" href="#l52">52</a><td> */<tr><td><a name="l53" href="#l53">53</a><td>goog.define(&#39;goog.userAgent.ASSUME_MOBILE_WEBKIT&#39;, false);<tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td>/**<tr><td><a name="l57" href="#l57">57</a><td> * @define {boolean} Whether we know at compile-time that the browser is OPERA.<tr><td><a name="l58" href="#l58">58</a><td> */<tr><td><a name="l59" href="#l59">59</a><td>goog.define(&#39;goog.userAgent.ASSUME_OPERA&#39;, false);<tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>/**<tr><td><a name="l63" href="#l63">63</a><td> * @define {boolean} Whether the<tr><td><a name="l64" href="#l64">64</a><td> * {@code goog.userAgent.isVersionOrHigher}<tr><td><a name="l65" href="#l65">65</a><td> * function will return true for any version.<tr><td><a name="l66" href="#l66">66</a><td> */<tr><td><a name="l67" href="#l67">67</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANY_VERSION&#39;, false);<tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td>/**<tr><td><a name="l71" href="#l71">71</a><td> * Whether we know the browser engine at compile-time.<tr><td><a name="l72" href="#l72">72</a><td> * @type {boolean}<tr><td><a name="l73" href="#l73">73</a><td> * @private<tr><td><a name="l74" href="#l74">74</a><td> */<tr><td><a name="l75" href="#l75">75</a><td>goog.userAgent.BROWSER_KNOWN_ =<tr><td><a name="l76" href="#l76">76</a><td> goog.userAgent.ASSUME_IE ||<tr><td><a name="l77" href="#l77">77</a><td> goog.userAgent.ASSUME_GECKO ||<tr><td><a name="l78" href="#l78">78</a><td> goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a name="l79" href="#l79">79</a><td> goog.userAgent.ASSUME_WEBKIT ||<tr><td><a name="l80" href="#l80">80</a><td> goog.userAgent.ASSUME_OPERA;<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td>/**<tr><td><a name="l84" href="#l84">84</a><td> * Returns the userAgent string for the current browser.<tr><td><a name="l85" href="#l85">85</a><td> *<tr><td><a name="l86" href="#l86">86</a><td> * @return {string} The userAgent string.<tr><td><a name="l87" href="#l87">87</a><td> */<tr><td><a name="l88" href="#l88">88</a><td>goog.userAgent.getUserAgentString = function() {<tr><td><a name="l89" href="#l89">89</a><td> return goog.labs.userAgent.util.getUserAgent();<tr><td><a name="l90" href="#l90">90</a><td>};<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>/**<tr><td><a name="l94" href="#l94">94</a><td> * TODO(nnaze): Change type to &quot;Navigator&quot; and update compilation targets.<tr><td><a name="l95" href="#l95">95</a><td> * @return {Object} The native navigator object.<tr><td><a name="l96" href="#l96">96</a><td> */<tr><td><a name="l97" href="#l97">97</a><td>goog.userAgent.getNavigator = function() {<tr><td><a name="l98" href="#l98">98</a><td> // Need a local navigator reference instead of using the global one,<tr><td><a name="l99" href="#l99">99</a><td> // to avoid the rare case where they reference different objects.<tr><td><a name="l100" href="#l100">100</a><td> // (in a WorkerPool, for example).<tr><td><a name="l101" href="#l101">101</a><td> return goog.global[&#39;navigator&#39;] || null;<tr><td><a name="l102" href="#l102">102</a><td>};<tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td><tr><td><a name="l105" href="#l105">105</a><td>/**<tr><td><a name="l106" href="#l106">106</a><td> * Whether the user agent is Opera.<tr><td><a name="l107" href="#l107">107</a><td> * @type {boolean}<tr><td><a name="l108" href="#l108">108</a><td> */<tr><td><a name="l109" href="#l109">109</a><td>goog.userAgent.OPERA = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l110" href="#l110">110</a><td> goog.userAgent.ASSUME_OPERA :<tr><td><a name="l111" href="#l111">111</a><td> goog.labs.userAgent.browser.isOpera();<tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td><tr><td><a name="l114" href="#l114">114</a><td>/**<tr><td><a name="l115" href="#l115">115</a><td> * Whether the user agent is Internet Explorer.<tr><td><a name="l116" href="#l116">116</a><td> * @type {boolean}<tr><td><a name="l117" href="#l117">117</a><td> */<tr><td><a name="l118" href="#l118">118</a><td>goog.userAgent.IE = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l119" href="#l119">119</a><td> goog.userAgent.ASSUME_IE :<tr><td><a name="l120" href="#l120">120</a><td> goog.labs.userAgent.browser.isIE();<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td>/**<tr><td><a name="l124" href="#l124">124</a><td> * Whether the user agent is Gecko. Gecko is the rendering engine used by<tr><td><a name="l125" href="#l125">125</a><td> * Mozilla, Firefox, and others.<tr><td><a name="l126" href="#l126">126</a><td> * @type {boolean}<tr><td><a name="l127" href="#l127">127</a><td> */<tr><td><a name="l128" href="#l128">128</a><td>goog.userAgent.GECKO = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l129" href="#l129">129</a><td> goog.userAgent.ASSUME_GECKO :<tr><td><a name="l130" href="#l130">130</a><td> goog.labs.userAgent.engine.isGecko();<tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td>/**<tr><td><a name="l134" href="#l134">134</a><td> * Whether the user agent is WebKit. WebKit is the rendering engine that<tr><td><a name="l135" href="#l135">135</a><td> * Safari, Android and others use.<tr><td><a name="l136" href="#l136">136</a><td> * @type {boolean}<tr><td><a name="l137" href="#l137">137</a><td> */<tr><td><a name="l138" href="#l138">138</a><td>goog.userAgent.WEBKIT = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l139" href="#l139">139</a><td> goog.userAgent.ASSUME_WEBKIT || goog.userAgent.ASSUME_MOBILE_WEBKIT :<tr><td><a name="l140" href="#l140">140</a><td> goog.labs.userAgent.engine.isWebKit();<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td>/**<tr><td><a name="l144" href="#l144">144</a><td> * Whether the user agent is running on a mobile device.<tr><td><a name="l145" href="#l145">145</a><td> *<tr><td><a name="l146" href="#l146">146</a><td> * This is a separate function so that the logic can be tested.<tr><td><a name="l147" href="#l147">147</a><td> *<tr><td><a name="l148" href="#l148">148</a><td> * TODO(nnaze): Investigate swapping in goog.labs.userAgent.device.isMobile().<tr><td><a name="l149" href="#l149">149</a><td> *<tr><td><a name="l150" href="#l150">150</a><td> * @return {boolean} Whether the user agent is running on a mobile device.<tr><td><a name="l151" href="#l151">151</a><td> * @private<tr><td><a name="l152" href="#l152">152</a><td> */<tr><td><a name="l153" href="#l153">153</a><td>goog.userAgent.isMobile_ = function() {<tr><td><a name="l154" href="#l154">154</a><td> return goog.userAgent.WEBKIT &amp;&amp;<tr><td><a name="l155" href="#l155">155</a><td> goog.labs.userAgent.util.matchUserAgent(&#39;Mobile&#39;);<tr><td><a name="l156" href="#l156">156</a><td>};<tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td>/**<tr><td><a name="l160" href="#l160">160</a><td> * Whether the user agent is running on a mobile device.<tr><td><a name="l161" href="#l161">161</a><td> *<tr><td><a name="l162" href="#l162">162</a><td> * TODO(nnaze): Consider deprecating MOBILE when labs.userAgent<tr><td><a name="l163" href="#l163">163</a><td> * is promoted as the gecko/webkit logic is likely inaccurate.<tr><td><a name="l164" href="#l164">164</a><td> *<tr><td><a name="l165" href="#l165">165</a><td> * @type {boolean}<tr><td><a name="l166" href="#l166">166</a><td> */<tr><td><a name="l167" href="#l167">167</a><td>goog.userAgent.MOBILE = goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a name="l168" href="#l168">168</a><td> goog.userAgent.isMobile_();<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/**<tr><td><a name="l172" href="#l172">172</a><td> * Used while transitioning code to use WEBKIT instead.<tr><td><a name="l173" href="#l173">173</a><td> * @type {boolean}<tr><td><a name="l174" href="#l174">174</a><td> * @deprecated Use {@link goog.userAgent.product.SAFARI} instead.<tr><td><a name="l175" href="#l175">175</a><td> * TODO(nicksantos): Delete this from goog.userAgent.<tr><td><a name="l176" href="#l176">176</a><td> */<tr><td><a name="l177" href="#l177">177</a><td>goog.userAgent.SAFARI = goog.userAgent.WEBKIT;<tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td>/**<tr><td><a name="l181" href="#l181">181</a><td> * @return {string} the platform (operating system) the user agent is running<tr><td><a name="l182" href="#l182">182</a><td> * on. Default to empty string because navigator.platform may not be defined<tr><td><a name="l183" href="#l183">183</a><td> * (on Rhino, for example).<tr><td><a name="l184" href="#l184">184</a><td> * @private<tr><td><a name="l185" href="#l185">185</a><td> */<tr><td><a name="l186" href="#l186">186</a><td>goog.userAgent.determinePlatform_ = function() {<tr><td><a name="l187" href="#l187">187</a><td> var navigator = goog.userAgent.getNavigator();<tr><td><a name="l188" href="#l188">188</a><td> return navigator &amp;&amp; navigator.platform || &#39;&#39;;<tr><td><a name="l189" href="#l189">189</a><td>};<tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>/**<tr><td><a name="l193" href="#l193">193</a><td> * The platform (operating system) the user agent is running on. Default to<tr><td><a name="l194" href="#l194">194</a><td> * empty string because navigator.platform may not be defined (on Rhino, for<tr><td><a name="l195" href="#l195">195</a><td> * example).<tr><td><a name="l196" href="#l196">196</a><td> * @type {string}<tr><td><a name="l197" href="#l197">197</a><td> */<tr><td><a name="l198" href="#l198">198</a><td>goog.userAgent.PLATFORM = goog.userAgent.determinePlatform_();<tr><td><a name="l199" href="#l199">199</a><td><tr><td><a name="l200" href="#l200">200</a><td><tr><td><a name="l201" href="#l201">201</a><td>/**<tr><td><a name="l202" href="#l202">202</a><td> * @define {boolean} Whether the user agent is running on a Macintosh operating<tr><td><a name="l203" href="#l203">203</a><td> * system.<tr><td><a name="l204" href="#l204">204</a><td> */<tr><td><a name="l205" href="#l205">205</a><td>goog.define(&#39;goog.userAgent.ASSUME_MAC&#39;, false);<tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td>/**<tr><td><a name="l209" href="#l209">209</a><td> * @define {boolean} Whether the user agent is running on a Windows operating<tr><td><a name="l210" href="#l210">210</a><td> * system.<tr><td><a name="l211" href="#l211">211</a><td> */<tr><td><a name="l212" href="#l212">212</a><td>goog.define(&#39;goog.userAgent.ASSUME_WINDOWS&#39;, false);<tr><td><a name="l213" href="#l213">213</a><td><tr><td><a name="l214" href="#l214">214</a><td><tr><td><a name="l215" href="#l215">215</a><td>/**<tr><td><a name="l216" href="#l216">216</a><td> * @define {boolean} Whether the user agent is running on a Linux operating<tr><td><a name="l217" href="#l217">217</a><td> * system.<tr><td><a name="l218" href="#l218">218</a><td> */<tr><td><a name="l219" href="#l219">219</a><td>goog.define(&#39;goog.userAgent.ASSUME_LINUX&#39;, false);<tr><td><a name="l220" href="#l220">220</a><td><tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td>/**<tr><td><a name="l223" href="#l223">223</a><td> * @define {boolean} Whether the user agent is running on a X11 windowing<tr><td><a name="l224" href="#l224">224</a><td> * system.<tr><td><a name="l225" href="#l225">225</a><td> */<tr><td><a name="l226" href="#l226">226</a><td>goog.define(&#39;goog.userAgent.ASSUME_X11&#39;, false);<tr><td><a name="l227" href="#l227">227</a><td><tr><td><a name="l228" href="#l228">228</a><td><tr><td><a name="l229" href="#l229">229</a><td>/**<tr><td><a name="l230" href="#l230">230</a><td> * @define {boolean} Whether the user agent is running on Android.<tr><td><a name="l231" href="#l231">231</a><td> */<tr><td><a name="l232" href="#l232">232</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANDROID&#39;, false);<tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td><tr><td><a name="l235" href="#l235">235</a><td>/**<tr><td><a name="l236" href="#l236">236</a><td> * @define {boolean} Whether the user agent is running on an iPhone.<tr><td><a name="l237" href="#l237">237</a><td> */<tr><td><a name="l238" href="#l238">238</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPHONE&#39;, false);<tr><td><a name="l239" href="#l239">239</a><td><tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td>/**<tr><td><a name="l242" href="#l242">242</a><td> * @define {boolean} Whether the user agent is running on an iPad.<tr><td><a name="l243" href="#l243">243</a><td> */<tr><td><a name="l244" href="#l244">244</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPAD&#39;, false);<tr><td><a name="l245" href="#l245">245</a><td><tr><td><a name="l246" href="#l246">246</a><td><tr><td><a name="l247" href="#l247">247</a><td>/**<tr><td><a name="l248" href="#l248">248</a><td> * @type {boolean}<tr><td><a name="l249" href="#l249">249</a><td> * @private<tr><td><a name="l250" href="#l250">250</a><td> */<tr><td><a name="l251" href="#l251">251</a><td>goog.userAgent.PLATFORM_KNOWN_ =<tr><td><a name="l252" href="#l252">252</a><td> goog.userAgent.ASSUME_MAC ||<tr><td><a name="l253" href="#l253">253</a><td> goog.userAgent.ASSUME_WINDOWS ||<tr><td><a name="l254" href="#l254">254</a><td> goog.userAgent.ASSUME_LINUX ||<tr><td><a name="l255" href="#l255">255</a><td> goog.userAgent.ASSUME_X11 ||<tr><td><a name="l256" href="#l256">256</a><td> goog.userAgent.ASSUME_ANDROID ||<tr><td><a name="l257" href="#l257">257</a><td> goog.userAgent.ASSUME_IPHONE ||<tr><td><a name="l258" href="#l258">258</a><td> goog.userAgent.ASSUME_IPAD;<tr><td><a name="l259" href="#l259">259</a><td><tr><td><a name="l260" href="#l260">260</a><td><tr><td><a name="l261" href="#l261">261</a><td>/**<tr><td><a name="l262" href="#l262">262</a><td> * Initialize the goog.userAgent constants that define which platform the user<tr><td><a name="l263" href="#l263">263</a><td> * agent is running on.<tr><td><a name="l264" href="#l264">264</a><td> * @private<tr><td><a name="l265" href="#l265">265</a><td> */<tr><td><a name="l266" href="#l266">266</a><td>goog.userAgent.initPlatform_ = function() {<tr><td><a name="l267" href="#l267">267</a><td> /**<tr><td><a name="l268" href="#l268">268</a><td> * Whether the user agent is running on a Macintosh operating system.<tr><td><a name="l269" href="#l269">269</a><td> * @type {boolean}<tr><td><a name="l270" href="#l270">270</a><td> * @private<tr><td><a name="l271" href="#l271">271</a><td> */<tr><td><a name="l272" href="#l272">272</a><td> goog.userAgent.detectedMac_ = goog.string.contains(goog.userAgent.PLATFORM,<tr><td><a name="l273" href="#l273">273</a><td> &#39;Mac&#39;);<tr><td><a name="l274" href="#l274">274</a><td><tr><td><a name="l275" href="#l275">275</a><td> /**<tr><td><a name="l276" href="#l276">276</a><td> * Whether the user agent is running on a Windows operating system.<tr><td><a name="l277" href="#l277">277</a><td> * @type {boolean}<tr><td><a name="l278" href="#l278">278</a><td> * @private<tr><td><a name="l279" href="#l279">279</a><td> */<tr><td><a name="l280" href="#l280">280</a><td> goog.userAgent.detectedWindows_ = goog.string.contains(<tr><td><a name="l281" href="#l281">281</a><td> goog.userAgent.PLATFORM, &#39;Win&#39;);<tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td> /**<tr><td><a name="l284" href="#l284">284</a><td> * Whether the user agent is running on a Linux operating system.<tr><td><a name="l285" href="#l285">285</a><td> * @type {boolean}<tr><td><a name="l286" href="#l286">286</a><td> * @private<tr><td><a name="l287" href="#l287">287</a><td> */<tr><td><a name="l288" href="#l288">288</a><td> goog.userAgent.detectedLinux_ = goog.string.contains(goog.userAgent.PLATFORM,<tr><td><a name="l289" href="#l289">289</a><td> &#39;Linux&#39;);<tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td> /**<tr><td><a name="l292" href="#l292">292</a><td> * Whether the user agent is running on a X11 windowing system.<tr><td><a name="l293" href="#l293">293</a><td> * @type {boolean}<tr><td><a name="l294" href="#l294">294</a><td> * @private<tr><td><a name="l295" href="#l295">295</a><td> */<tr><td><a name="l296" href="#l296">296</a><td> goog.userAgent.detectedX11_ = !!goog.userAgent.getNavigator() &amp;&amp;<tr><td><a name="l297" href="#l297">297</a><td> goog.string.contains(goog.userAgent.getNavigator()[&#39;appVersion&#39;] || &#39;&#39;,<tr><td><a name="l298" href="#l298">298</a><td> &#39;X11&#39;);<tr><td><a name="l299" href="#l299">299</a><td><tr><td><a name="l300" href="#l300">300</a><td> // Need user agent string for Android/IOS detection<tr><td><a name="l301" href="#l301">301</a><td> var ua = goog.userAgent.getUserAgentString();<tr><td><a name="l302" href="#l302">302</a><td><tr><td><a name="l303" href="#l303">303</a><td> /**<tr><td><a name="l304" href="#l304">304</a><td> * Whether the user agent is running on Android.<tr><td><a name="l305" href="#l305">305</a><td> * @type {boolean}<tr><td><a name="l306" href="#l306">306</a><td> * @private<tr><td><a name="l307" href="#l307">307</a><td> */<tr><td><a name="l308" href="#l308">308</a><td> goog.userAgent.detectedAndroid_ = !!ua &amp;&amp;<tr><td><a name="l309" href="#l309">309</a><td> goog.string.contains(ua, &#39;Android&#39;);<tr><td><a name="l310" href="#l310">310</a><td><tr><td><a name="l311" href="#l311">311</a><td> /**<tr><td><a name="l312" href="#l312">312</a><td> * Whether the user agent is running on an iPhone.<tr><td><a name="l313" href="#l313">313</a><td> * @type {boolean}<tr><td><a name="l314" href="#l314">314</a><td> * @private<tr><td><a name="l315" href="#l315">315</a><td> */<tr><td><a name="l316" href="#l316">316</a><td> goog.userAgent.detectedIPhone_ = !!ua &amp;&amp; goog.string.contains(ua, &#39;iPhone&#39;);<tr><td><a name="l317" href="#l317">317</a><td><tr><td><a name="l318" href="#l318">318</a><td> /**<tr><td><a name="l319" href="#l319">319</a><td> * Whether the user agent is running on an iPad.<tr><td><a name="l320" href="#l320">320</a><td> * @type {boolean}<tr><td><a name="l321" href="#l321">321</a><td> * @private<tr><td><a name="l322" href="#l322">322</a><td> */<tr><td><a name="l323" href="#l323">323</a><td> goog.userAgent.detectedIPad_ = !!ua &amp;&amp; goog.string.contains(ua, &#39;iPad&#39;);<tr><td><a name="l324" href="#l324">324</a><td>};<tr><td><a name="l325" href="#l325">325</a><td><tr><td><a name="l326" href="#l326">326</a><td><tr><td><a name="l327" href="#l327">327</a><td>if (!goog.userAgent.PLATFORM_KNOWN_) {<tr><td><a name="l328" href="#l328">328</a><td> goog.userAgent.initPlatform_();<tr><td><a name="l329" href="#l329">329</a><td>}<tr><td><a name="l330" href="#l330">330</a><td><tr><td><a name="l331" href="#l331">331</a><td><tr><td><a name="l332" href="#l332">332</a><td>/**<tr><td><a name="l333" href="#l333">333</a><td> * Whether the user agent is running on a Macintosh operating system.<tr><td><a name="l334" href="#l334">334</a><td> * @type {boolean}<tr><td><a name="l335" href="#l335">335</a><td> */<tr><td><a name="l336" href="#l336">336</a><td>goog.userAgent.MAC = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l337" href="#l337">337</a><td> goog.userAgent.ASSUME_MAC : goog.userAgent.detectedMac_;<tr><td><a name="l338" href="#l338">338</a><td><tr><td><a name="l339" href="#l339">339</a><td><tr><td><a name="l340" href="#l340">340</a><td>/**<tr><td><a name="l341" href="#l341">341</a><td> * Whether the user agent is running on a Windows operating system.<tr><td><a name="l342" href="#l342">342</a><td> * @type {boolean}<tr><td><a name="l343" href="#l343">343</a><td> */<tr><td><a name="l344" href="#l344">344</a><td>goog.userAgent.WINDOWS = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l345" href="#l345">345</a><td> goog.userAgent.ASSUME_WINDOWS : goog.userAgent.detectedWindows_;<tr><td><a name="l346" href="#l346">346</a><td><tr><td><a name="l347" href="#l347">347</a><td><tr><td><a name="l348" href="#l348">348</a><td>/**<tr><td><a name="l349" href="#l349">349</a><td> * Whether the user agent is running on a Linux operating system.<tr><td><a name="l350" href="#l350">350</a><td> * @type {boolean}<tr><td><a name="l351" href="#l351">351</a><td> */<tr><td><a name="l352" href="#l352">352</a><td>goog.userAgent.LINUX = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l353" href="#l353">353</a><td> goog.userAgent.ASSUME_LINUX : goog.userAgent.detectedLinux_;<tr><td><a name="l354" href="#l354">354</a><td><tr><td><a name="l355" href="#l355">355</a><td><tr><td><a name="l356" href="#l356">356</a><td>/**<tr><td><a name="l357" href="#l357">357</a><td> * Whether the user agent is running on a X11 windowing system.<tr><td><a name="l358" href="#l358">358</a><td> * @type {boolean}<tr><td><a name="l359" href="#l359">359</a><td> */<tr><td><a name="l360" href="#l360">360</a><td>goog.userAgent.X11 = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l361" href="#l361">361</a><td> goog.userAgent.ASSUME_X11 : goog.userAgent.detectedX11_;<tr><td><a name="l362" href="#l362">362</a><td><tr><td><a name="l363" href="#l363">363</a><td><tr><td><a name="l364" href="#l364">364</a><td>/**<tr><td><a name="l365" href="#l365">365</a><td> * Whether the user agent is running on Android.<tr><td><a name="l366" href="#l366">366</a><td> * @type {boolean}<tr><td><a name="l367" href="#l367">367</a><td> */<tr><td><a name="l368" href="#l368">368</a><td>goog.userAgent.ANDROID = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l369" href="#l369">369</a><td> goog.userAgent.ASSUME_ANDROID : goog.userAgent.detectedAndroid_;<tr><td><a name="l370" href="#l370">370</a><td><tr><td><a name="l371" href="#l371">371</a><td><tr><td><a name="l372" href="#l372">372</a><td>/**<tr><td><a name="l373" href="#l373">373</a><td> * Whether the user agent is running on an iPhone.<tr><td><a name="l374" href="#l374">374</a><td> * @type {boolean}<tr><td><a name="l375" href="#l375">375</a><td> */<tr><td><a name="l376" href="#l376">376</a><td>goog.userAgent.IPHONE = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l377" href="#l377">377</a><td> goog.userAgent.ASSUME_IPHONE : goog.userAgent.detectedIPhone_;<tr><td><a name="l378" href="#l378">378</a><td><tr><td><a name="l379" href="#l379">379</a><td><tr><td><a name="l380" href="#l380">380</a><td>/**<tr><td><a name="l381" href="#l381">381</a><td> * Whether the user agent is running on an iPad.<tr><td><a name="l382" href="#l382">382</a><td> * @type {boolean}<tr><td><a name="l383" href="#l383">383</a><td> */<tr><td><a name="l384" href="#l384">384</a><td>goog.userAgent.IPAD = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l385" href="#l385">385</a><td> goog.userAgent.ASSUME_IPAD : goog.userAgent.detectedIPad_;<tr><td><a name="l386" href="#l386">386</a><td><tr><td><a name="l387" href="#l387">387</a><td><tr><td><a name="l388" href="#l388">388</a><td>/**<tr><td><a name="l389" href="#l389">389</a><td> * @return {string} The string that describes the version number of the user<tr><td><a name="l390" href="#l390">390</a><td> * agent.<tr><td><a name="l391" href="#l391">391</a><td> * @private<tr><td><a name="l392" href="#l392">392</a><td> */<tr><td><a name="l393" href="#l393">393</a><td>goog.userAgent.determineVersion_ = function() {<tr><td><a name="l394" href="#l394">394</a><td> // All browsers have different ways to detect the version and they all have<tr><td><a name="l395" href="#l395">395</a><td> // different naming schemes.<tr><td><a name="l396" href="#l396">396</a><td><tr><td><a name="l397" href="#l397">397</a><td> // version is a string rather than a number because it may contain &#39;b&#39;, &#39;a&#39;,<tr><td><a name="l398" href="#l398">398</a><td> // and so on.<tr><td><a name="l399" href="#l399">399</a><td> var version = &#39;&#39;, re;<tr><td><a name="l400" href="#l400">400</a><td><tr><td><a name="l401" href="#l401">401</a><td> if (goog.userAgent.OPERA &amp;&amp; goog.global[&#39;opera&#39;]) {<tr><td><a name="l402" href="#l402">402</a><td> var operaVersion = goog.global[&#39;opera&#39;].version;<tr><td><a name="l403" href="#l403">403</a><td> return goog.isFunction(operaVersion) ? operaVersion() : operaVersion;<tr><td><a name="l404" href="#l404">404</a><td> }<tr><td><a name="l405" href="#l405">405</a><td><tr><td><a name="l406" href="#l406">406</a><td> if (goog.userAgent.GECKO) {<tr><td><a name="l407" href="#l407">407</a><td> re = /rv\:([^\);]+)(\)|;)/;<tr><td><a name="l408" href="#l408">408</a><td> } else if (goog.userAgent.IE) {<tr><td><a name="l409" href="#l409">409</a><td> re = /\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/;<tr><td><a name="l410" href="#l410">410</a><td> } else if (goog.userAgent.WEBKIT) {<tr><td><a name="l411" href="#l411">411</a><td> // WebKit/125.4<tr><td><a name="l412" href="#l412">412</a><td> re = /WebKit\/(\S+)/;<tr><td><a name="l413" href="#l413">413</a><td> }<tr><td><a name="l414" href="#l414">414</a><td><tr><td><a name="l415" href="#l415">415</a><td> if (re) {<tr><td><a name="l416" href="#l416">416</a><td> var arr = re.exec(goog.userAgent.getUserAgentString());<tr><td><a name="l417" href="#l417">417</a><td> version = arr ? arr[1] : &#39;&#39;;<tr><td><a name="l418" href="#l418">418</a><td> }<tr><td><a name="l419" href="#l419">419</a><td><tr><td><a name="l420" href="#l420">420</a><td> if (goog.userAgent.IE) {<tr><td><a name="l421" href="#l421">421</a><td> // IE9 can be in document mode 9 but be reporting an inconsistent user agent<tr><td><a name="l422" href="#l422">422</a><td> // version. If it is identifying as a version lower than 9 we take the<tr><td><a name="l423" href="#l423">423</a><td> // documentMode as the version instead. IE8 has similar behavior.<tr><td><a name="l424" href="#l424">424</a><td> // It is recommended to set the X-UA-Compatible header to ensure that IE9<tr><td><a name="l425" href="#l425">425</a><td> // uses documentMode 9.<tr><td><a name="l426" href="#l426">426</a><td> var docMode = goog.userAgent.getDocumentMode_();<tr><td><a name="l427" href="#l427">427</a><td> if (docMode &gt; parseFloat(version)) {<tr><td><a name="l428" href="#l428">428</a><td> return String(docMode);<tr><td><a name="l429" href="#l429">429</a><td> }<tr><td><a name="l430" href="#l430">430</a><td> }<tr><td><a name="l431" href="#l431">431</a><td><tr><td><a name="l432" href="#l432">432</a><td> return version;<tr><td><a name="l433" href="#l433">433</a><td>};<tr><td><a name="l434" href="#l434">434</a><td><tr><td><a name="l435" href="#l435">435</a><td><tr><td><a name="l436" href="#l436">436</a><td>/**<tr><td><a name="l437" href="#l437">437</a><td> * @return {number|undefined} Returns the document mode (for testing).<tr><td><a name="l438" href="#l438">438</a><td> * @private<tr><td><a name="l439" href="#l439">439</a><td> */<tr><td><a name="l440" href="#l440">440</a><td>goog.userAgent.getDocumentMode_ = function() {<tr><td><a name="l441" href="#l441">441</a><td> // NOTE(user): goog.userAgent may be used in context where there is no DOM.<tr><td><a name="l442" href="#l442">442</a><td> var doc = goog.global[&#39;document&#39;];<tr><td><a name="l443" href="#l443">443</a><td> return doc ? doc[&#39;documentMode&#39;] : undefined;<tr><td><a name="l444" href="#l444">444</a><td>};<tr><td><a name="l445" href="#l445">445</a><td><tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td>/**<tr><td><a name="l448" href="#l448">448</a><td> * The version of the user agent. This is a string because it might contain<tr><td><a name="l449" href="#l449">449</a><td> * &#39;b&#39; (as in beta) as well as multiple dots.<tr><td><a name="l450" href="#l450">450</a><td> * @type {string}<tr><td><a name="l451" href="#l451">451</a><td> */<tr><td><a name="l452" href="#l452">452</a><td>goog.userAgent.VERSION = goog.userAgent.determineVersion_();<tr><td><a name="l453" href="#l453">453</a><td><tr><td><a name="l454" href="#l454">454</a><td><tr><td><a name="l455" href="#l455">455</a><td>/**<tr><td><a name="l456" href="#l456">456</a><td> * Compares two version numbers.<tr><td><a name="l457" href="#l457">457</a><td> *<tr><td><a name="l458" href="#l458">458</a><td> * @param {string} v1 Version of first item.<tr><td><a name="l459" href="#l459">459</a><td> * @param {string} v2 Version of second item.<tr><td><a name="l460" href="#l460">460</a><td> *<tr><td><a name="l461" href="#l461">461</a><td> * @return {number} 1 if first argument is higher<tr><td><a name="l462" href="#l462">462</a><td> * 0 if arguments are equal<tr><td><a name="l463" href="#l463">463</a><td> * -1 if second argument is higher.<tr><td><a name="l464" href="#l464">464</a><td> * @deprecated Use goog.string.compareVersions.<tr><td><a name="l465" href="#l465">465</a><td> */<tr><td><a name="l466" href="#l466">466</a><td>goog.userAgent.compare = function(v1, v2) {<tr><td><a name="l467" href="#l467">467</a><td> return goog.string.compareVersions(v1, v2);<tr><td><a name="l468" href="#l468">468</a><td>};<tr><td><a name="l469" href="#l469">469</a><td><tr><td><a name="l470" href="#l470">470</a><td><tr><td><a name="l471" href="#l471">471</a><td>/**<tr><td><a name="l472" href="#l472">472</a><td> * Cache for {@link goog.userAgent.isVersionOrHigher}.<tr><td><a name="l473" href="#l473">473</a><td> * Calls to compareVersions are surprisingly expensive and, as a browser&#39;s<tr><td><a name="l474" href="#l474">474</a><td> * version number is unlikely to change during a session, we cache the results.<tr><td><a name="l475" href="#l475">475</a><td> * @const<tr><td><a name="l476" href="#l476">476</a><td> * @private<tr><td><a name="l477" href="#l477">477</a><td> */<tr><td><a name="l478" href="#l478">478</a><td>goog.userAgent.isVersionOrHigherCache_ = {};<tr><td><a name="l479" href="#l479">479</a><td><tr><td><a name="l480" href="#l480">480</a><td><tr><td><a name="l481" href="#l481">481</a><td>/**<tr><td><a name="l482" href="#l482">482</a><td> * Whether the user agent version is higher or the same as the given version.<tr><td><a name="l483" href="#l483">483</a><td> * NOTE: When checking the version numbers for Firefox and Safari, be sure to<tr><td><a name="l484" href="#l484">484</a><td> * use the engine&#39;s version, not the browser&#39;s version number. For example,<tr><td><a name="l485" href="#l485">485</a><td> * Firefox 3.0 corresponds to Gecko 1.9 and Safari 3.0 to Webkit 522.11.<tr><td><a name="l486" href="#l486">486</a><td> * Opera and Internet Explorer versions match the product release number.&lt;br&gt;<tr><td><a name="l487" href="#l487">487</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Safari_version_history&quot;&gt;<tr><td><a name="l488" href="#l488">488</a><td> * Webkit&lt;/a&gt;<tr><td><a name="l489" href="#l489">489</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Gecko_engine&quot;&gt;Gecko&lt;/a&gt;<tr><td><a name="l490" href="#l490">490</a><td> *<tr><td><a name="l491" href="#l491">491</a><td> * @param {string|number} version The version to check.<tr><td><a name="l492" href="#l492">492</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a name="l493" href="#l493">493</a><td> * the given version.<tr><td><a name="l494" href="#l494">494</a><td> */<tr><td><a name="l495" href="#l495">495</a><td>goog.userAgent.isVersionOrHigher = function(version) {<tr><td><a name="l496" href="#l496">496</a><td> return goog.userAgent.ASSUME_ANY_VERSION ||<tr><td><a name="l497" href="#l497">497</a><td> goog.userAgent.isVersionOrHigherCache_[version] ||<tr><td><a name="l498" href="#l498">498</a><td> (goog.userAgent.isVersionOrHigherCache_[version] =<tr><td><a name="l499" href="#l499">499</a><td> goog.string.compareVersions(goog.userAgent.VERSION, version) &gt;= 0);<tr><td><a name="l500" href="#l500">500</a><td>};<tr><td><a name="l501" href="#l501">501</a><td><tr><td><a name="l502" href="#l502">502</a><td><tr><td><a name="l503" href="#l503">503</a><td>/**<tr><td><a name="l504" href="#l504">504</a><td> * Deprecated alias to {@code goog.userAgent.isVersionOrHigher}.<tr><td><a name="l505" href="#l505">505</a><td> * @param {string|number} version The version to check.<tr><td><a name="l506" href="#l506">506</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a name="l507" href="#l507">507</a><td> * the given version.<tr><td><a name="l508" href="#l508">508</a><td> * @deprecated Use goog.userAgent.isVersionOrHigher().<tr><td><a name="l509" href="#l509">509</a><td> */<tr><td><a name="l510" href="#l510">510</a><td>goog.userAgent.isVersion = goog.userAgent.isVersionOrHigher;<tr><td><a name="l511" href="#l511">511</a><td><tr><td><a name="l512" href="#l512">512</a><td><tr><td><a name="l513" href="#l513">513</a><td>/**<tr><td><a name="l514" href="#l514">514</a><td> * Whether the IE effective document mode is higher or the same as the given<tr><td><a name="l515" href="#l515">515</a><td> * document mode version.<tr><td><a name="l516" href="#l516">516</a><td> * NOTE: Only for IE, return false for another browser.<tr><td><a name="l517" href="#l517">517</a><td> *<tr><td><a name="l518" href="#l518">518</a><td> * @param {number} documentMode The document mode version to check.<tr><td><a name="l519" href="#l519">519</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a name="l520" href="#l520">520</a><td> * same as the given version.<tr><td><a name="l521" href="#l521">521</a><td> */<tr><td><a name="l522" href="#l522">522</a><td>goog.userAgent.isDocumentModeOrHigher = function(documentMode) {<tr><td><a name="l523" href="#l523">523</a><td> return goog.userAgent.IE &amp;&amp; goog.userAgent.DOCUMENT_MODE &gt;= documentMode;<tr><td><a name="l524" href="#l524">524</a><td>};<tr><td><a name="l525" href="#l525">525</a><td><tr><td><a name="l526" href="#l526">526</a><td><tr><td><a name="l527" href="#l527">527</a><td>/**<tr><td><a name="l528" href="#l528">528</a><td> * Deprecated alias to {@code goog.userAgent.isDocumentModeOrHigher}.<tr><td><a name="l529" href="#l529">529</a><td> * @param {number} version The version to check.<tr><td><a name="l530" href="#l530">530</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a name="l531" href="#l531">531</a><td> * same as the given version.<tr><td><a name="l532" href="#l532">532</a><td> * @deprecated Use goog.userAgent.isDocumentModeOrHigher().<tr><td><a name="l533" href="#l533">533</a><td> */<tr><td><a name="l534" href="#l534">534</a><td>goog.userAgent.isDocumentMode = goog.userAgent.isDocumentModeOrHigher;<tr><td><a name="l535" href="#l535">535</a><td><tr><td><a name="l536" href="#l536">536</a><td><tr><td><a name="l537" href="#l537">537</a><td>/**<tr><td><a name="l538" href="#l538">538</a><td> * For IE version &lt; 7, documentMode is undefined, so attempt to use the<tr><td><a name="l539" href="#l539">539</a><td> * CSS1Compat property to see if we are in standards mode. If we are in<tr><td><a name="l540" href="#l540">540</a><td> * standards mode, treat the browser version as the document mode. Otherwise,<tr><td><a name="l541" href="#l541">541</a><td> * IE is emulating version 5.<tr><td><a name="l542" href="#l542">542</a><td> * @type {number|undefined}<tr><td><a name="l543" href="#l543">543</a><td> * @const<tr><td><a name="l544" href="#l544">544</a><td> */<tr><td><a name="l545" href="#l545">545</a><td>goog.userAgent.DOCUMENT_MODE = (function() {<tr><td><a name="l546" href="#l546">546</a><td> var doc = goog.global[&#39;document&#39;];<tr><td><a name="l547" href="#l547">547</a><td> if (!doc || !goog.userAgent.IE) {<tr><td><a name="l548" href="#l548">548</a><td> return undefined;<tr><td><a name="l549" href="#l549">549</a><td> }<tr><td><a name="l550" href="#l550">550</a><td> var mode = goog.userAgent.getDocumentMode_();<tr><td><a name="l551" href="#l551">551</a><td> return mode || (doc[&#39;compatMode&#39;] == &#39;CSS1Compat&#39; ?<tr><td><a name="l552" href="#l552">552</a><td> parseInt(goog.userAgent.VERSION, 10) : 5);<tr><td><a name="l553" href="#l553">553</a><td>})();</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
1
+ <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>useragent.js</title><link href="../../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/goog/useragent/useragent.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2006 The Closure Library Authors. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS-IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>/**<tr><td><a name="l16" href="#l16">16</a><td> * @fileoverview Rendering engine detection.<tr><td><a name="l17" href="#l17">17</a><td> * @see &lt;a href=&quot;http://www.useragentstring.com/&quot;&gt;User agent strings&lt;/a&gt;<tr><td><a name="l18" href="#l18">18</a><td> * For information on the browser brand (such as Safari versus Chrome), see<tr><td><a name="l19" href="#l19">19</a><td> * goog.userAgent.product.<tr><td><a name="l20" href="#l20">20</a><td> * @see ../demos/useragent.html<tr><td><a name="l21" href="#l21">21</a><td> */<tr><td><a name="l22" href="#l22">22</a><td><tr><td><a name="l23" href="#l23">23</a><td>goog.provide(&#39;goog.userAgent&#39;);<tr><td><a name="l24" href="#l24">24</a><td><tr><td><a name="l25" href="#l25">25</a><td>goog.require(&#39;goog.labs.userAgent.browser&#39;);<tr><td><a name="l26" href="#l26">26</a><td>goog.require(&#39;goog.labs.userAgent.engine&#39;);<tr><td><a name="l27" href="#l27">27</a><td>goog.require(&#39;goog.labs.userAgent.util&#39;);<tr><td><a name="l28" href="#l28">28</a><td>goog.require(&#39;goog.string&#39;);<tr><td><a name="l29" href="#l29">29</a><td><tr><td><a name="l30" href="#l30">30</a><td><tr><td><a name="l31" href="#l31">31</a><td>/**<tr><td><a name="l32" href="#l32">32</a><td> * @define {boolean} Whether we know at compile-time that the browser is IE.<tr><td><a name="l33" href="#l33">33</a><td> */<tr><td><a name="l34" href="#l34">34</a><td>goog.define(&#39;goog.userAgent.ASSUME_IE&#39;, false);<tr><td><a name="l35" href="#l35">35</a><td><tr><td><a name="l36" href="#l36">36</a><td><tr><td><a name="l37" href="#l37">37</a><td>/**<tr><td><a name="l38" href="#l38">38</a><td> * @define {boolean} Whether we know at compile-time that the browser is GECKO.<tr><td><a name="l39" href="#l39">39</a><td> */<tr><td><a name="l40" href="#l40">40</a><td>goog.define(&#39;goog.userAgent.ASSUME_GECKO&#39;, false);<tr><td><a name="l41" href="#l41">41</a><td><tr><td><a name="l42" href="#l42">42</a><td><tr><td><a name="l43" href="#l43">43</a><td>/**<tr><td><a name="l44" href="#l44">44</a><td> * @define {boolean} Whether we know at compile-time that the browser is WEBKIT.<tr><td><a name="l45" href="#l45">45</a><td> */<tr><td><a name="l46" href="#l46">46</a><td>goog.define(&#39;goog.userAgent.ASSUME_WEBKIT&#39;, false);<tr><td><a name="l47" href="#l47">47</a><td><tr><td><a name="l48" href="#l48">48</a><td><tr><td><a name="l49" href="#l49">49</a><td>/**<tr><td><a name="l50" href="#l50">50</a><td> * @define {boolean} Whether we know at compile-time that the browser is a<tr><td><a name="l51" href="#l51">51</a><td> * mobile device running WebKit e.g. iPhone or Android.<tr><td><a name="l52" href="#l52">52</a><td> */<tr><td><a name="l53" href="#l53">53</a><td>goog.define(&#39;goog.userAgent.ASSUME_MOBILE_WEBKIT&#39;, false);<tr><td><a name="l54" href="#l54">54</a><td><tr><td><a name="l55" href="#l55">55</a><td><tr><td><a name="l56" href="#l56">56</a><td>/**<tr><td><a name="l57" href="#l57">57</a><td> * @define {boolean} Whether we know at compile-time that the browser is OPERA.<tr><td><a name="l58" href="#l58">58</a><td> */<tr><td><a name="l59" href="#l59">59</a><td>goog.define(&#39;goog.userAgent.ASSUME_OPERA&#39;, false);<tr><td><a name="l60" href="#l60">60</a><td><tr><td><a name="l61" href="#l61">61</a><td><tr><td><a name="l62" href="#l62">62</a><td>/**<tr><td><a name="l63" href="#l63">63</a><td> * @define {boolean} Whether the<tr><td><a name="l64" href="#l64">64</a><td> * {@code goog.userAgent.isVersionOrHigher}<tr><td><a name="l65" href="#l65">65</a><td> * function will return true for any version.<tr><td><a name="l66" href="#l66">66</a><td> */<tr><td><a name="l67" href="#l67">67</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANY_VERSION&#39;, false);<tr><td><a name="l68" href="#l68">68</a><td><tr><td><a name="l69" href="#l69">69</a><td><tr><td><a name="l70" href="#l70">70</a><td>/**<tr><td><a name="l71" href="#l71">71</a><td> * Whether we know the browser engine at compile-time.<tr><td><a name="l72" href="#l72">72</a><td> * @type {boolean}<tr><td><a name="l73" href="#l73">73</a><td> * @private<tr><td><a name="l74" href="#l74">74</a><td> */<tr><td><a name="l75" href="#l75">75</a><td>goog.userAgent.BROWSER_KNOWN_ =<tr><td><a name="l76" href="#l76">76</a><td> goog.userAgent.ASSUME_IE ||<tr><td><a name="l77" href="#l77">77</a><td> goog.userAgent.ASSUME_GECKO ||<tr><td><a name="l78" href="#l78">78</a><td> goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a name="l79" href="#l79">79</a><td> goog.userAgent.ASSUME_WEBKIT ||<tr><td><a name="l80" href="#l80">80</a><td> goog.userAgent.ASSUME_OPERA;<tr><td><a name="l81" href="#l81">81</a><td><tr><td><a name="l82" href="#l82">82</a><td><tr><td><a name="l83" href="#l83">83</a><td>/**<tr><td><a name="l84" href="#l84">84</a><td> * Returns the userAgent string for the current browser.<tr><td><a name="l85" href="#l85">85</a><td> *<tr><td><a name="l86" href="#l86">86</a><td> * @return {string} The userAgent string.<tr><td><a name="l87" href="#l87">87</a><td> */<tr><td><a name="l88" href="#l88">88</a><td>goog.userAgent.getUserAgentString = function() {<tr><td><a name="l89" href="#l89">89</a><td> return goog.labs.userAgent.util.getUserAgent();<tr><td><a name="l90" href="#l90">90</a><td>};<tr><td><a name="l91" href="#l91">91</a><td><tr><td><a name="l92" href="#l92">92</a><td><tr><td><a name="l93" href="#l93">93</a><td>/**<tr><td><a name="l94" href="#l94">94</a><td> * TODO(nnaze): Change type to &quot;Navigator&quot; and update compilation targets.<tr><td><a name="l95" href="#l95">95</a><td> * @return {Object} The native navigator object.<tr><td><a name="l96" href="#l96">96</a><td> */<tr><td><a name="l97" href="#l97">97</a><td>goog.userAgent.getNavigator = function() {<tr><td><a name="l98" href="#l98">98</a><td> // Need a local navigator reference instead of using the global one,<tr><td><a name="l99" href="#l99">99</a><td> // to avoid the rare case where they reference different objects.<tr><td><a name="l100" href="#l100">100</a><td> // (in a WorkerPool, for example).<tr><td><a name="l101" href="#l101">101</a><td> return goog.global[&#39;navigator&#39;] || null;<tr><td><a name="l102" href="#l102">102</a><td>};<tr><td><a name="l103" href="#l103">103</a><td><tr><td><a name="l104" href="#l104">104</a><td><tr><td><a name="l105" href="#l105">105</a><td>/**<tr><td><a name="l106" href="#l106">106</a><td> * Whether the user agent is Opera.<tr><td><a name="l107" href="#l107">107</a><td> * @type {boolean}<tr><td><a name="l108" href="#l108">108</a><td> */<tr><td><a name="l109" href="#l109">109</a><td>goog.userAgent.OPERA = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l110" href="#l110">110</a><td> goog.userAgent.ASSUME_OPERA :<tr><td><a name="l111" href="#l111">111</a><td> goog.labs.userAgent.browser.isOpera();<tr><td><a name="l112" href="#l112">112</a><td><tr><td><a name="l113" href="#l113">113</a><td><tr><td><a name="l114" href="#l114">114</a><td>/**<tr><td><a name="l115" href="#l115">115</a><td> * Whether the user agent is Internet Explorer.<tr><td><a name="l116" href="#l116">116</a><td> * @type {boolean}<tr><td><a name="l117" href="#l117">117</a><td> */<tr><td><a name="l118" href="#l118">118</a><td>goog.userAgent.IE = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l119" href="#l119">119</a><td> goog.userAgent.ASSUME_IE :<tr><td><a name="l120" href="#l120">120</a><td> goog.labs.userAgent.browser.isIE();<tr><td><a name="l121" href="#l121">121</a><td><tr><td><a name="l122" href="#l122">122</a><td><tr><td><a name="l123" href="#l123">123</a><td>/**<tr><td><a name="l124" href="#l124">124</a><td> * Whether the user agent is Gecko. Gecko is the rendering engine used by<tr><td><a name="l125" href="#l125">125</a><td> * Mozilla, Firefox, and others.<tr><td><a name="l126" href="#l126">126</a><td> * @type {boolean}<tr><td><a name="l127" href="#l127">127</a><td> */<tr><td><a name="l128" href="#l128">128</a><td>goog.userAgent.GECKO = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l129" href="#l129">129</a><td> goog.userAgent.ASSUME_GECKO :<tr><td><a name="l130" href="#l130">130</a><td> goog.labs.userAgent.engine.isGecko();<tr><td><a name="l131" href="#l131">131</a><td><tr><td><a name="l132" href="#l132">132</a><td><tr><td><a name="l133" href="#l133">133</a><td>/**<tr><td><a name="l134" href="#l134">134</a><td> * Whether the user agent is WebKit. WebKit is the rendering engine that<tr><td><a name="l135" href="#l135">135</a><td> * Safari, Android and others use.<tr><td><a name="l136" href="#l136">136</a><td> * @type {boolean}<tr><td><a name="l137" href="#l137">137</a><td> */<tr><td><a name="l138" href="#l138">138</a><td>goog.userAgent.WEBKIT = goog.userAgent.BROWSER_KNOWN_ ?<tr><td><a name="l139" href="#l139">139</a><td> goog.userAgent.ASSUME_WEBKIT || goog.userAgent.ASSUME_MOBILE_WEBKIT :<tr><td><a name="l140" href="#l140">140</a><td> goog.labs.userAgent.engine.isWebKit();<tr><td><a name="l141" href="#l141">141</a><td><tr><td><a name="l142" href="#l142">142</a><td><tr><td><a name="l143" href="#l143">143</a><td>/**<tr><td><a name="l144" href="#l144">144</a><td> * Whether the user agent is running on a mobile device.<tr><td><a name="l145" href="#l145">145</a><td> *<tr><td><a name="l146" href="#l146">146</a><td> * This is a separate function so that the logic can be tested.<tr><td><a name="l147" href="#l147">147</a><td> *<tr><td><a name="l148" href="#l148">148</a><td> * TODO(nnaze): Investigate swapping in goog.labs.userAgent.device.isMobile().<tr><td><a name="l149" href="#l149">149</a><td> *<tr><td><a name="l150" href="#l150">150</a><td> * @return {boolean} Whether the user agent is running on a mobile device.<tr><td><a name="l151" href="#l151">151</a><td> * @private<tr><td><a name="l152" href="#l152">152</a><td> */<tr><td><a name="l153" href="#l153">153</a><td>goog.userAgent.isMobile_ = function() {<tr><td><a name="l154" href="#l154">154</a><td> return goog.userAgent.WEBKIT &amp;&amp;<tr><td><a name="l155" href="#l155">155</a><td> goog.labs.userAgent.util.matchUserAgent(&#39;Mobile&#39;);<tr><td><a name="l156" href="#l156">156</a><td>};<tr><td><a name="l157" href="#l157">157</a><td><tr><td><a name="l158" href="#l158">158</a><td><tr><td><a name="l159" href="#l159">159</a><td>/**<tr><td><a name="l160" href="#l160">160</a><td> * Whether the user agent is running on a mobile device.<tr><td><a name="l161" href="#l161">161</a><td> *<tr><td><a name="l162" href="#l162">162</a><td> * TODO(nnaze): Consider deprecating MOBILE when labs.userAgent<tr><td><a name="l163" href="#l163">163</a><td> * is promoted as the gecko/webkit logic is likely inaccurate.<tr><td><a name="l164" href="#l164">164</a><td> *<tr><td><a name="l165" href="#l165">165</a><td> * @type {boolean}<tr><td><a name="l166" href="#l166">166</a><td> */<tr><td><a name="l167" href="#l167">167</a><td>goog.userAgent.MOBILE = goog.userAgent.ASSUME_MOBILE_WEBKIT ||<tr><td><a name="l168" href="#l168">168</a><td> goog.userAgent.isMobile_();<tr><td><a name="l169" href="#l169">169</a><td><tr><td><a name="l170" href="#l170">170</a><td><tr><td><a name="l171" href="#l171">171</a><td>/**<tr><td><a name="l172" href="#l172">172</a><td> * Used while transitioning code to use WEBKIT instead.<tr><td><a name="l173" href="#l173">173</a><td> * @type {boolean}<tr><td><a name="l174" href="#l174">174</a><td> * @deprecated Use {@link goog.userAgent.product.SAFARI} instead.<tr><td><a name="l175" href="#l175">175</a><td> * TODO(nicksantos): Delete this from goog.userAgent.<tr><td><a name="l176" href="#l176">176</a><td> */<tr><td><a name="l177" href="#l177">177</a><td>goog.userAgent.SAFARI = goog.userAgent.WEBKIT;<tr><td><a name="l178" href="#l178">178</a><td><tr><td><a name="l179" href="#l179">179</a><td><tr><td><a name="l180" href="#l180">180</a><td>/**<tr><td><a name="l181" href="#l181">181</a><td> * @return {string} the platform (operating system) the user agent is running<tr><td><a name="l182" href="#l182">182</a><td> * on. Default to empty string because navigator.platform may not be defined<tr><td><a name="l183" href="#l183">183</a><td> * (on Rhino, for example).<tr><td><a name="l184" href="#l184">184</a><td> * @private<tr><td><a name="l185" href="#l185">185</a><td> */<tr><td><a name="l186" href="#l186">186</a><td>goog.userAgent.determinePlatform_ = function() {<tr><td><a name="l187" href="#l187">187</a><td> var navigator = goog.userAgent.getNavigator();<tr><td><a name="l188" href="#l188">188</a><td> return navigator &amp;&amp; navigator.platform || &#39;&#39;;<tr><td><a name="l189" href="#l189">189</a><td>};<tr><td><a name="l190" href="#l190">190</a><td><tr><td><a name="l191" href="#l191">191</a><td><tr><td><a name="l192" href="#l192">192</a><td>/**<tr><td><a name="l193" href="#l193">193</a><td> * The platform (operating system) the user agent is running on. Default to<tr><td><a name="l194" href="#l194">194</a><td> * empty string because navigator.platform may not be defined (on Rhino, for<tr><td><a name="l195" href="#l195">195</a><td> * example).<tr><td><a name="l196" href="#l196">196</a><td> * @type {string}<tr><td><a name="l197" href="#l197">197</a><td> */<tr><td><a name="l198" href="#l198">198</a><td>goog.userAgent.PLATFORM = goog.userAgent.determinePlatform_();<tr><td><a name="l199" href="#l199">199</a><td><tr><td><a name="l200" href="#l200">200</a><td><tr><td><a name="l201" href="#l201">201</a><td>/**<tr><td><a name="l202" href="#l202">202</a><td> * @define {boolean} Whether the user agent is running on a Macintosh operating<tr><td><a name="l203" href="#l203">203</a><td> * system.<tr><td><a name="l204" href="#l204">204</a><td> */<tr><td><a name="l205" href="#l205">205</a><td>goog.define(&#39;goog.userAgent.ASSUME_MAC&#39;, false);<tr><td><a name="l206" href="#l206">206</a><td><tr><td><a name="l207" href="#l207">207</a><td><tr><td><a name="l208" href="#l208">208</a><td>/**<tr><td><a name="l209" href="#l209">209</a><td> * @define {boolean} Whether the user agent is running on a Windows operating<tr><td><a name="l210" href="#l210">210</a><td> * system.<tr><td><a name="l211" href="#l211">211</a><td> */<tr><td><a name="l212" href="#l212">212</a><td>goog.define(&#39;goog.userAgent.ASSUME_WINDOWS&#39;, false);<tr><td><a name="l213" href="#l213">213</a><td><tr><td><a name="l214" href="#l214">214</a><td><tr><td><a name="l215" href="#l215">215</a><td>/**<tr><td><a name="l216" href="#l216">216</a><td> * @define {boolean} Whether the user agent is running on a Linux operating<tr><td><a name="l217" href="#l217">217</a><td> * system.<tr><td><a name="l218" href="#l218">218</a><td> */<tr><td><a name="l219" href="#l219">219</a><td>goog.define(&#39;goog.userAgent.ASSUME_LINUX&#39;, false);<tr><td><a name="l220" href="#l220">220</a><td><tr><td><a name="l221" href="#l221">221</a><td><tr><td><a name="l222" href="#l222">222</a><td>/**<tr><td><a name="l223" href="#l223">223</a><td> * @define {boolean} Whether the user agent is running on a X11 windowing<tr><td><a name="l224" href="#l224">224</a><td> * system.<tr><td><a name="l225" href="#l225">225</a><td> */<tr><td><a name="l226" href="#l226">226</a><td>goog.define(&#39;goog.userAgent.ASSUME_X11&#39;, false);<tr><td><a name="l227" href="#l227">227</a><td><tr><td><a name="l228" href="#l228">228</a><td><tr><td><a name="l229" href="#l229">229</a><td>/**<tr><td><a name="l230" href="#l230">230</a><td> * @define {boolean} Whether the user agent is running on Android.<tr><td><a name="l231" href="#l231">231</a><td> */<tr><td><a name="l232" href="#l232">232</a><td>goog.define(&#39;goog.userAgent.ASSUME_ANDROID&#39;, false);<tr><td><a name="l233" href="#l233">233</a><td><tr><td><a name="l234" href="#l234">234</a><td><tr><td><a name="l235" href="#l235">235</a><td>/**<tr><td><a name="l236" href="#l236">236</a><td> * @define {boolean} Whether the user agent is running on an iPhone.<tr><td><a name="l237" href="#l237">237</a><td> */<tr><td><a name="l238" href="#l238">238</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPHONE&#39;, false);<tr><td><a name="l239" href="#l239">239</a><td><tr><td><a name="l240" href="#l240">240</a><td><tr><td><a name="l241" href="#l241">241</a><td>/**<tr><td><a name="l242" href="#l242">242</a><td> * @define {boolean} Whether the user agent is running on an iPad.<tr><td><a name="l243" href="#l243">243</a><td> */<tr><td><a name="l244" href="#l244">244</a><td>goog.define(&#39;goog.userAgent.ASSUME_IPAD&#39;, false);<tr><td><a name="l245" href="#l245">245</a><td><tr><td><a name="l246" href="#l246">246</a><td><tr><td><a name="l247" href="#l247">247</a><td>/**<tr><td><a name="l248" href="#l248">248</a><td> * @type {boolean}<tr><td><a name="l249" href="#l249">249</a><td> * @private<tr><td><a name="l250" href="#l250">250</a><td> */<tr><td><a name="l251" href="#l251">251</a><td>goog.userAgent.PLATFORM_KNOWN_ =<tr><td><a name="l252" href="#l252">252</a><td> goog.userAgent.ASSUME_MAC ||<tr><td><a name="l253" href="#l253">253</a><td> goog.userAgent.ASSUME_WINDOWS ||<tr><td><a name="l254" href="#l254">254</a><td> goog.userAgent.ASSUME_LINUX ||<tr><td><a name="l255" href="#l255">255</a><td> goog.userAgent.ASSUME_X11 ||<tr><td><a name="l256" href="#l256">256</a><td> goog.userAgent.ASSUME_ANDROID ||<tr><td><a name="l257" href="#l257">257</a><td> goog.userAgent.ASSUME_IPHONE ||<tr><td><a name="l258" href="#l258">258</a><td> goog.userAgent.ASSUME_IPAD;<tr><td><a name="l259" href="#l259">259</a><td><tr><td><a name="l260" href="#l260">260</a><td><tr><td><a name="l261" href="#l261">261</a><td>/**<tr><td><a name="l262" href="#l262">262</a><td> * Initialize the goog.userAgent constants that define which platform the user<tr><td><a name="l263" href="#l263">263</a><td> * agent is running on.<tr><td><a name="l264" href="#l264">264</a><td> * @private<tr><td><a name="l265" href="#l265">265</a><td> */<tr><td><a name="l266" href="#l266">266</a><td>goog.userAgent.initPlatform_ = function() {<tr><td><a name="l267" href="#l267">267</a><td> /**<tr><td><a name="l268" href="#l268">268</a><td> * Whether the user agent is running on a Macintosh operating system.<tr><td><a name="l269" href="#l269">269</a><td> * @type {boolean}<tr><td><a name="l270" href="#l270">270</a><td> * @private<tr><td><a name="l271" href="#l271">271</a><td> */<tr><td><a name="l272" href="#l272">272</a><td> goog.userAgent.detectedMac_ = goog.string.contains(goog.userAgent.PLATFORM,<tr><td><a name="l273" href="#l273">273</a><td> &#39;Mac&#39;);<tr><td><a name="l274" href="#l274">274</a><td><tr><td><a name="l275" href="#l275">275</a><td> /**<tr><td><a name="l276" href="#l276">276</a><td> * Whether the user agent is running on a Windows operating system.<tr><td><a name="l277" href="#l277">277</a><td> * @type {boolean}<tr><td><a name="l278" href="#l278">278</a><td> * @private<tr><td><a name="l279" href="#l279">279</a><td> */<tr><td><a name="l280" href="#l280">280</a><td> goog.userAgent.detectedWindows_ = goog.string.contains(<tr><td><a name="l281" href="#l281">281</a><td> goog.userAgent.PLATFORM, &#39;Win&#39;);<tr><td><a name="l282" href="#l282">282</a><td><tr><td><a name="l283" href="#l283">283</a><td> /**<tr><td><a name="l284" href="#l284">284</a><td> * Whether the user agent is running on a Linux operating system.<tr><td><a name="l285" href="#l285">285</a><td> * @type {boolean}<tr><td><a name="l286" href="#l286">286</a><td> * @private<tr><td><a name="l287" href="#l287">287</a><td> */<tr><td><a name="l288" href="#l288">288</a><td> goog.userAgent.detectedLinux_ = goog.string.contains(goog.userAgent.PLATFORM,<tr><td><a name="l289" href="#l289">289</a><td> &#39;Linux&#39;);<tr><td><a name="l290" href="#l290">290</a><td><tr><td><a name="l291" href="#l291">291</a><td> /**<tr><td><a name="l292" href="#l292">292</a><td> * Whether the user agent is running on a X11 windowing system.<tr><td><a name="l293" href="#l293">293</a><td> * @type {boolean}<tr><td><a name="l294" href="#l294">294</a><td> * @private<tr><td><a name="l295" href="#l295">295</a><td> */<tr><td><a name="l296" href="#l296">296</a><td> goog.userAgent.detectedX11_ = !!goog.userAgent.getNavigator() &amp;&amp;<tr><td><a name="l297" href="#l297">297</a><td> goog.string.contains(goog.userAgent.getNavigator()[&#39;appVersion&#39;] || &#39;&#39;,<tr><td><a name="l298" href="#l298">298</a><td> &#39;X11&#39;);<tr><td><a name="l299" href="#l299">299</a><td><tr><td><a name="l300" href="#l300">300</a><td> // Need user agent string for Android/IOS detection<tr><td><a name="l301" href="#l301">301</a><td> var ua = goog.userAgent.getUserAgentString();<tr><td><a name="l302" href="#l302">302</a><td><tr><td><a name="l303" href="#l303">303</a><td> /**<tr><td><a name="l304" href="#l304">304</a><td> * Whether the user agent is running on Android.<tr><td><a name="l305" href="#l305">305</a><td> * @type {boolean}<tr><td><a name="l306" href="#l306">306</a><td> * @private<tr><td><a name="l307" href="#l307">307</a><td> */<tr><td><a name="l308" href="#l308">308</a><td> goog.userAgent.detectedAndroid_ = !!ua &amp;&amp;<tr><td><a name="l309" href="#l309">309</a><td> goog.string.contains(ua, &#39;Android&#39;);<tr><td><a name="l310" href="#l310">310</a><td><tr><td><a name="l311" href="#l311">311</a><td> /**<tr><td><a name="l312" href="#l312">312</a><td> * Whether the user agent is running on an iPhone.<tr><td><a name="l313" href="#l313">313</a><td> * @type {boolean}<tr><td><a name="l314" href="#l314">314</a><td> * @private<tr><td><a name="l315" href="#l315">315</a><td> */<tr><td><a name="l316" href="#l316">316</a><td> goog.userAgent.detectedIPhone_ = !!ua &amp;&amp; goog.string.contains(ua, &#39;iPhone&#39;);<tr><td><a name="l317" href="#l317">317</a><td><tr><td><a name="l318" href="#l318">318</a><td> /**<tr><td><a name="l319" href="#l319">319</a><td> * Whether the user agent is running on an iPad.<tr><td><a name="l320" href="#l320">320</a><td> * @type {boolean}<tr><td><a name="l321" href="#l321">321</a><td> * @private<tr><td><a name="l322" href="#l322">322</a><td> */<tr><td><a name="l323" href="#l323">323</a><td> goog.userAgent.detectedIPad_ = !!ua &amp;&amp; goog.string.contains(ua, &#39;iPad&#39;);<tr><td><a name="l324" href="#l324">324</a><td>};<tr><td><a name="l325" href="#l325">325</a><td><tr><td><a name="l326" href="#l326">326</a><td><tr><td><a name="l327" href="#l327">327</a><td>if (!goog.userAgent.PLATFORM_KNOWN_) {<tr><td><a name="l328" href="#l328">328</a><td> goog.userAgent.initPlatform_();<tr><td><a name="l329" href="#l329">329</a><td>}<tr><td><a name="l330" href="#l330">330</a><td><tr><td><a name="l331" href="#l331">331</a><td><tr><td><a name="l332" href="#l332">332</a><td>/**<tr><td><a name="l333" href="#l333">333</a><td> * Whether the user agent is running on a Macintosh operating system.<tr><td><a name="l334" href="#l334">334</a><td> * @type {boolean}<tr><td><a name="l335" href="#l335">335</a><td> */<tr><td><a name="l336" href="#l336">336</a><td>goog.userAgent.MAC = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l337" href="#l337">337</a><td> goog.userAgent.ASSUME_MAC : goog.userAgent.detectedMac_;<tr><td><a name="l338" href="#l338">338</a><td><tr><td><a name="l339" href="#l339">339</a><td><tr><td><a name="l340" href="#l340">340</a><td>/**<tr><td><a name="l341" href="#l341">341</a><td> * Whether the user agent is running on a Windows operating system.<tr><td><a name="l342" href="#l342">342</a><td> * @type {boolean}<tr><td><a name="l343" href="#l343">343</a><td> */<tr><td><a name="l344" href="#l344">344</a><td>goog.userAgent.WINDOWS = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l345" href="#l345">345</a><td> goog.userAgent.ASSUME_WINDOWS : goog.userAgent.detectedWindows_;<tr><td><a name="l346" href="#l346">346</a><td><tr><td><a name="l347" href="#l347">347</a><td><tr><td><a name="l348" href="#l348">348</a><td>/**<tr><td><a name="l349" href="#l349">349</a><td> * Whether the user agent is running on a Linux operating system.<tr><td><a name="l350" href="#l350">350</a><td> * @type {boolean}<tr><td><a name="l351" href="#l351">351</a><td> */<tr><td><a name="l352" href="#l352">352</a><td>goog.userAgent.LINUX = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l353" href="#l353">353</a><td> goog.userAgent.ASSUME_LINUX : goog.userAgent.detectedLinux_;<tr><td><a name="l354" href="#l354">354</a><td><tr><td><a name="l355" href="#l355">355</a><td><tr><td><a name="l356" href="#l356">356</a><td>/**<tr><td><a name="l357" href="#l357">357</a><td> * Whether the user agent is running on a X11 windowing system.<tr><td><a name="l358" href="#l358">358</a><td> * @type {boolean}<tr><td><a name="l359" href="#l359">359</a><td> */<tr><td><a name="l360" href="#l360">360</a><td>goog.userAgent.X11 = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l361" href="#l361">361</a><td> goog.userAgent.ASSUME_X11 : goog.userAgent.detectedX11_;<tr><td><a name="l362" href="#l362">362</a><td><tr><td><a name="l363" href="#l363">363</a><td><tr><td><a name="l364" href="#l364">364</a><td>/**<tr><td><a name="l365" href="#l365">365</a><td> * Whether the user agent is running on Android.<tr><td><a name="l366" href="#l366">366</a><td> * @type {boolean}<tr><td><a name="l367" href="#l367">367</a><td> */<tr><td><a name="l368" href="#l368">368</a><td>goog.userAgent.ANDROID = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l369" href="#l369">369</a><td> goog.userAgent.ASSUME_ANDROID : goog.userAgent.detectedAndroid_;<tr><td><a name="l370" href="#l370">370</a><td><tr><td><a name="l371" href="#l371">371</a><td><tr><td><a name="l372" href="#l372">372</a><td>/**<tr><td><a name="l373" href="#l373">373</a><td> * Whether the user agent is running on an iPhone.<tr><td><a name="l374" href="#l374">374</a><td> * @type {boolean}<tr><td><a name="l375" href="#l375">375</a><td> */<tr><td><a name="l376" href="#l376">376</a><td>goog.userAgent.IPHONE = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l377" href="#l377">377</a><td> goog.userAgent.ASSUME_IPHONE : goog.userAgent.detectedIPhone_;<tr><td><a name="l378" href="#l378">378</a><td><tr><td><a name="l379" href="#l379">379</a><td><tr><td><a name="l380" href="#l380">380</a><td>/**<tr><td><a name="l381" href="#l381">381</a><td> * Whether the user agent is running on an iPad.<tr><td><a name="l382" href="#l382">382</a><td> * @type {boolean}<tr><td><a name="l383" href="#l383">383</a><td> */<tr><td><a name="l384" href="#l384">384</a><td>goog.userAgent.IPAD = goog.userAgent.PLATFORM_KNOWN_ ?<tr><td><a name="l385" href="#l385">385</a><td> goog.userAgent.ASSUME_IPAD : goog.userAgent.detectedIPad_;<tr><td><a name="l386" href="#l386">386</a><td><tr><td><a name="l387" href="#l387">387</a><td><tr><td><a name="l388" href="#l388">388</a><td>/**<tr><td><a name="l389" href="#l389">389</a><td> * @return {string} The string that describes the version number of the user<tr><td><a name="l390" href="#l390">390</a><td> * agent.<tr><td><a name="l391" href="#l391">391</a><td> * @private<tr><td><a name="l392" href="#l392">392</a><td> */<tr><td><a name="l393" href="#l393">393</a><td>goog.userAgent.determineVersion_ = function() {<tr><td><a name="l394" href="#l394">394</a><td> // All browsers have different ways to detect the version and they all have<tr><td><a name="l395" href="#l395">395</a><td> // different naming schemes.<tr><td><a name="l396" href="#l396">396</a><td><tr><td><a name="l397" href="#l397">397</a><td> // version is a string rather than a number because it may contain &#39;b&#39;, &#39;a&#39;,<tr><td><a name="l398" href="#l398">398</a><td> // and so on.<tr><td><a name="l399" href="#l399">399</a><td> var version = &#39;&#39;, re;<tr><td><a name="l400" href="#l400">400</a><td><tr><td><a name="l401" href="#l401">401</a><td> if (goog.userAgent.OPERA &amp;&amp; goog.global[&#39;opera&#39;]) {<tr><td><a name="l402" href="#l402">402</a><td> var operaVersion = goog.global[&#39;opera&#39;].version;<tr><td><a name="l403" href="#l403">403</a><td> return goog.isFunction(operaVersion) ? operaVersion() : operaVersion;<tr><td><a name="l404" href="#l404">404</a><td> }<tr><td><a name="l405" href="#l405">405</a><td><tr><td><a name="l406" href="#l406">406</a><td> if (goog.userAgent.GECKO) {<tr><td><a name="l407" href="#l407">407</a><td> re = /rv\:([^\);]+)(\)|;)/;<tr><td><a name="l408" href="#l408">408</a><td> } else if (goog.userAgent.IE) {<tr><td><a name="l409" href="#l409">409</a><td> re = /\b(?:MSIE|rv)[: ]([^\);]+)(\)|;)/;<tr><td><a name="l410" href="#l410">410</a><td> } else if (goog.userAgent.WEBKIT) {<tr><td><a name="l411" href="#l411">411</a><td> // WebKit/125.4<tr><td><a name="l412" href="#l412">412</a><td> re = /WebKit\/(\S+)/;<tr><td><a name="l413" href="#l413">413</a><td> }<tr><td><a name="l414" href="#l414">414</a><td><tr><td><a name="l415" href="#l415">415</a><td> if (re) {<tr><td><a name="l416" href="#l416">416</a><td> var arr = re.exec(goog.userAgent.getUserAgentString());<tr><td><a name="l417" href="#l417">417</a><td> version = arr ? arr[1] : &#39;&#39;;<tr><td><a name="l418" href="#l418">418</a><td> }<tr><td><a name="l419" href="#l419">419</a><td><tr><td><a name="l420" href="#l420">420</a><td> if (goog.userAgent.IE) {<tr><td><a name="l421" href="#l421">421</a><td> // IE9 can be in document mode 9 but be reporting an inconsistent user agent<tr><td><a name="l422" href="#l422">422</a><td> // version. If it is identifying as a version lower than 9 we take the<tr><td><a name="l423" href="#l423">423</a><td> // documentMode as the version instead. IE8 has similar behavior.<tr><td><a name="l424" href="#l424">424</a><td> // It is recommended to set the X-UA-Compatible header to ensure that IE9<tr><td><a name="l425" href="#l425">425</a><td> // uses documentMode 9.<tr><td><a name="l426" href="#l426">426</a><td> var docMode = goog.userAgent.getDocumentMode_();<tr><td><a name="l427" href="#l427">427</a><td> if (docMode &gt; parseFloat(version)) {<tr><td><a name="l428" href="#l428">428</a><td> return String(docMode);<tr><td><a name="l429" href="#l429">429</a><td> }<tr><td><a name="l430" href="#l430">430</a><td> }<tr><td><a name="l431" href="#l431">431</a><td><tr><td><a name="l432" href="#l432">432</a><td> return version;<tr><td><a name="l433" href="#l433">433</a><td>};<tr><td><a name="l434" href="#l434">434</a><td><tr><td><a name="l435" href="#l435">435</a><td><tr><td><a name="l436" href="#l436">436</a><td>/**<tr><td><a name="l437" href="#l437">437</a><td> * @return {number|undefined} Returns the document mode (for testing).<tr><td><a name="l438" href="#l438">438</a><td> * @private<tr><td><a name="l439" href="#l439">439</a><td> */<tr><td><a name="l440" href="#l440">440</a><td>goog.userAgent.getDocumentMode_ = function() {<tr><td><a name="l441" href="#l441">441</a><td> // NOTE(user): goog.userAgent may be used in context where there is no DOM.<tr><td><a name="l442" href="#l442">442</a><td> var doc = goog.global[&#39;document&#39;];<tr><td><a name="l443" href="#l443">443</a><td> return doc ? doc[&#39;documentMode&#39;] : undefined;<tr><td><a name="l444" href="#l444">444</a><td>};<tr><td><a name="l445" href="#l445">445</a><td><tr><td><a name="l446" href="#l446">446</a><td><tr><td><a name="l447" href="#l447">447</a><td>/**<tr><td><a name="l448" href="#l448">448</a><td> * The version of the user agent. This is a string because it might contain<tr><td><a name="l449" href="#l449">449</a><td> * &#39;b&#39; (as in beta) as well as multiple dots.<tr><td><a name="l450" href="#l450">450</a><td> * @type {string}<tr><td><a name="l451" href="#l451">451</a><td> */<tr><td><a name="l452" href="#l452">452</a><td>goog.userAgent.VERSION = goog.userAgent.determineVersion_();<tr><td><a name="l453" href="#l453">453</a><td><tr><td><a name="l454" href="#l454">454</a><td><tr><td><a name="l455" href="#l455">455</a><td>/**<tr><td><a name="l456" href="#l456">456</a><td> * Compares two version numbers.<tr><td><a name="l457" href="#l457">457</a><td> *<tr><td><a name="l458" href="#l458">458</a><td> * @param {string} v1 Version of first item.<tr><td><a name="l459" href="#l459">459</a><td> * @param {string} v2 Version of second item.<tr><td><a name="l460" href="#l460">460</a><td> *<tr><td><a name="l461" href="#l461">461</a><td> * @return {number} 1 if first argument is higher<tr><td><a name="l462" href="#l462">462</a><td> * 0 if arguments are equal<tr><td><a name="l463" href="#l463">463</a><td> * -1 if second argument is higher.<tr><td><a name="l464" href="#l464">464</a><td> * @deprecated Use goog.string.compareVersions.<tr><td><a name="l465" href="#l465">465</a><td> */<tr><td><a name="l466" href="#l466">466</a><td>goog.userAgent.compare = function(v1, v2) {<tr><td><a name="l467" href="#l467">467</a><td> return goog.string.compareVersions(v1, v2);<tr><td><a name="l468" href="#l468">468</a><td>};<tr><td><a name="l469" href="#l469">469</a><td><tr><td><a name="l470" href="#l470">470</a><td><tr><td><a name="l471" href="#l471">471</a><td>/**<tr><td><a name="l472" href="#l472">472</a><td> * Cache for {@link goog.userAgent.isVersionOrHigher}.<tr><td><a name="l473" href="#l473">473</a><td> * Calls to compareVersions are surprisingly expensive and, as a browser&#39;s<tr><td><a name="l474" href="#l474">474</a><td> * version number is unlikely to change during a session, we cache the results.<tr><td><a name="l475" href="#l475">475</a><td> * @const<tr><td><a name="l476" href="#l476">476</a><td> * @private<tr><td><a name="l477" href="#l477">477</a><td> */<tr><td><a name="l478" href="#l478">478</a><td>goog.userAgent.isVersionOrHigherCache_ = {};<tr><td><a name="l479" href="#l479">479</a><td><tr><td><a name="l480" href="#l480">480</a><td><tr><td><a name="l481" href="#l481">481</a><td>/**<tr><td><a name="l482" href="#l482">482</a><td> * Whether the user agent version is higher or the same as the given version.<tr><td><a name="l483" href="#l483">483</a><td> * NOTE: When checking the version numbers for Firefox and Safari, be sure to<tr><td><a name="l484" href="#l484">484</a><td> * use the engine&#39;s version, not the browser&#39;s version number. For example,<tr><td><a name="l485" href="#l485">485</a><td> * Firefox 3.0 corresponds to Gecko 1.9 and Safari 3.0 to Webkit 522.11.<tr><td><a name="l486" href="#l486">486</a><td> * Opera and Internet Explorer versions match the product release number.&lt;br&gt;<tr><td><a name="l487" href="#l487">487</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Safari_version_history&quot;&gt;<tr><td><a name="l488" href="#l488">488</a><td> * Webkit&lt;/a&gt;<tr><td><a name="l489" href="#l489">489</a><td> * @see &lt;a href=&quot;http://en.wikipedia.org/wiki/Gecko_engine&quot;&gt;Gecko&lt;/a&gt;<tr><td><a name="l490" href="#l490">490</a><td> *<tr><td><a name="l491" href="#l491">491</a><td> * @param {string|number} version The version to check.<tr><td><a name="l492" href="#l492">492</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a name="l493" href="#l493">493</a><td> * the given version.<tr><td><a name="l494" href="#l494">494</a><td> */<tr><td><a name="l495" href="#l495">495</a><td>goog.userAgent.isVersionOrHigher = function(version) {<tr><td><a name="l496" href="#l496">496</a><td> return goog.userAgent.ASSUME_ANY_VERSION ||<tr><td><a name="l497" href="#l497">497</a><td> goog.userAgent.isVersionOrHigherCache_[version] ||<tr><td><a name="l498" href="#l498">498</a><td> (goog.userAgent.isVersionOrHigherCache_[version] =<tr><td><a name="l499" href="#l499">499</a><td> goog.string.compareVersions(goog.userAgent.VERSION, version) &gt;= 0);<tr><td><a name="l500" href="#l500">500</a><td>};<tr><td><a name="l501" href="#l501">501</a><td><tr><td><a name="l502" href="#l502">502</a><td><tr><td><a name="l503" href="#l503">503</a><td>/**<tr><td><a name="l504" href="#l504">504</a><td> * Deprecated alias to {@code goog.userAgent.isVersionOrHigher}.<tr><td><a name="l505" href="#l505">505</a><td> * @param {string|number} version The version to check.<tr><td><a name="l506" href="#l506">506</a><td> * @return {boolean} Whether the user agent version is higher or the same as<tr><td><a name="l507" href="#l507">507</a><td> * the given version.<tr><td><a name="l508" href="#l508">508</a><td> * @deprecated Use goog.userAgent.isVersionOrHigher().<tr><td><a name="l509" href="#l509">509</a><td> */<tr><td><a name="l510" href="#l510">510</a><td>goog.userAgent.isVersion = goog.userAgent.isVersionOrHigher;<tr><td><a name="l511" href="#l511">511</a><td><tr><td><a name="l512" href="#l512">512</a><td><tr><td><a name="l513" href="#l513">513</a><td>/**<tr><td><a name="l514" href="#l514">514</a><td> * Whether the IE effective document mode is higher or the same as the given<tr><td><a name="l515" href="#l515">515</a><td> * document mode version.<tr><td><a name="l516" href="#l516">516</a><td> * NOTE: Only for IE, return false for another browser.<tr><td><a name="l517" href="#l517">517</a><td> *<tr><td><a name="l518" href="#l518">518</a><td> * @param {number} documentMode The document mode version to check.<tr><td><a name="l519" href="#l519">519</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a name="l520" href="#l520">520</a><td> * same as the given version.<tr><td><a name="l521" href="#l521">521</a><td> */<tr><td><a name="l522" href="#l522">522</a><td>goog.userAgent.isDocumentModeOrHigher = function(documentMode) {<tr><td><a name="l523" href="#l523">523</a><td> return goog.userAgent.IE &amp;&amp; goog.userAgent.DOCUMENT_MODE &gt;= documentMode;<tr><td><a name="l524" href="#l524">524</a><td>};<tr><td><a name="l525" href="#l525">525</a><td><tr><td><a name="l526" href="#l526">526</a><td><tr><td><a name="l527" href="#l527">527</a><td>/**<tr><td><a name="l528" href="#l528">528</a><td> * Deprecated alias to {@code goog.userAgent.isDocumentModeOrHigher}.<tr><td><a name="l529" href="#l529">529</a><td> * @param {number} version The version to check.<tr><td><a name="l530" href="#l530">530</a><td> * @return {boolean} Whether the IE effective document mode is higher or the<tr><td><a name="l531" href="#l531">531</a><td> * same as the given version.<tr><td><a name="l532" href="#l532">532</a><td> * @deprecated Use goog.userAgent.isDocumentModeOrHigher().<tr><td><a name="l533" href="#l533">533</a><td> */<tr><td><a name="l534" href="#l534">534</a><td>goog.userAgent.isDocumentMode = goog.userAgent.isDocumentModeOrHigher;<tr><td><a name="l535" href="#l535">535</a><td><tr><td><a name="l536" href="#l536">536</a><td><tr><td><a name="l537" href="#l537">537</a><td>/**<tr><td><a name="l538" href="#l538">538</a><td> * For IE version &lt; 7, documentMode is undefined, so attempt to use the<tr><td><a name="l539" href="#l539">539</a><td> * CSS1Compat property to see if we are in standards mode. If we are in<tr><td><a name="l540" href="#l540">540</a><td> * standards mode, treat the browser version as the document mode. Otherwise,<tr><td><a name="l541" href="#l541">541</a><td> * IE is emulating version 5.<tr><td><a name="l542" href="#l542">542</a><td> * @type {number|undefined}<tr><td><a name="l543" href="#l543">543</a><td> * @const<tr><td><a name="l544" href="#l544">544</a><td> */<tr><td><a name="l545" href="#l545">545</a><td>goog.userAgent.DOCUMENT_MODE = (function() {<tr><td><a name="l546" href="#l546">546</a><td> var doc = goog.global[&#39;document&#39;];<tr><td><a name="l547" href="#l547">547</a><td> if (!doc || !goog.userAgent.IE) {<tr><td><a name="l548" href="#l548">548</a><td> return undefined;<tr><td><a name="l549" href="#l549">549</a><td> }<tr><td><a name="l550" href="#l550">550</a><td> var mode = goog.userAgent.getDocumentMode_();<tr><td><a name="l551" href="#l551">551</a><td> return mode || (doc[&#39;compatMode&#39;] == &#39;CSS1Compat&#39; ?<tr><td><a name="l552" href="#l552">552</a><td> parseInt(goog.userAgent.VERSION, 10) : 5);<tr><td><a name="l553" href="#l553">553</a><td>})();</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="../../../../license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../../types.js"></script><script src="../../../../dossier.js"></script>
package/docs/source/lib/webdriver/abstractbuilder.js.src.html CHANGED
@@ -1 +1 @@
1
- <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>abstractbuilder.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/abstractbuilder.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.AbstractBuilder&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;webdriver.Capabilities&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.process&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Creates new {@code webdriver.WebDriver} clients. Upon instantiation, each<tr><td><a name="l24" href="#l24">24</a><td> * Builder will configure itself based on the following environment variables:<tr><td><a name="l25" href="#l25">25</a><td> * &lt;dl&gt;<tr><td><a name="l26" href="#l26">26</a><td> * &lt;dt&gt;{@code webdriver.AbstractBuilder.SERVER_URL_ENV}&lt;/dt&gt;<tr><td><a name="l27" href="#l27">27</a><td> * &lt;dd&gt;Defines the remote WebDriver server that should be used for command<tr><td><a name="l28" href="#l28">28</a><td> * command execution; may be overridden using<tr><td><a name="l29" href="#l29">29</a><td> * {@code webdriver.AbstractBuilder.prototype.usingServer}.&lt;/dd&gt;<tr><td><a name="l30" href="#l30">30</a><td> * &lt;/dl&gt;<tr><td><a name="l31" href="#l31">31</a><td> * @constructor<tr><td><a name="l32" href="#l32">32</a><td> */<tr><td><a name="l33" href="#l33">33</a><td>webdriver.AbstractBuilder = function() {<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td> /**<tr><td><a name="l36" href="#l36">36</a><td> * URL of the remote server to use for new clients; initialized from the<tr><td><a name="l37" href="#l37">37</a><td> * value of the {@link webdriver.AbstractBuilder.SERVER_URL_ENV} environment<tr><td><a name="l38" href="#l38">38</a><td> * variable, but may be overridden using<tr><td><a name="l39" href="#l39">39</a><td> * {@link webdriver.AbstractBuilder#usingServer}.<tr><td><a name="l40" href="#l40">40</a><td> * @private {string}<tr><td><a name="l41" href="#l41">41</a><td> */<tr><td><a name="l42" href="#l42">42</a><td> this.serverUrl_ = webdriver.process.getEnv(<tr><td><a name="l43" href="#l43">43</a><td> webdriver.AbstractBuilder.SERVER_URL_ENV);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td> /**<tr><td><a name="l46" href="#l46">46</a><td> * The desired capabilities to use when creating a new session.<tr><td><a name="l47" href="#l47">47</a><td> * @private {!webdriver.Capabilities}<tr><td><a name="l48" href="#l48">48</a><td> */<tr><td><a name="l49" href="#l49">49</a><td> this.capabilities_ = new webdriver.Capabilities();<tr><td><a name="l50" href="#l50">50</a><td>};<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>/**<tr><td><a name="l54" href="#l54">54</a><td> * Environment variable that defines the URL of the WebDriver server that<tr><td><a name="l55" href="#l55">55</a><td> * should be used for all new WebDriver clients. This setting may be overridden<tr><td><a name="l56" href="#l56">56</a><td> * using {@code #usingServer(url)}.<tr><td><a name="l57" href="#l57">57</a><td> * @type {string}<tr><td><a name="l58" href="#l58">58</a><td> * @const<tr><td><a name="l59" href="#l59">59</a><td> * @see webdriver.process.getEnv<tr><td><a name="l60" href="#l60">60</a><td> */<tr><td><a name="l61" href="#l61">61</a><td>webdriver.AbstractBuilder.SERVER_URL_ENV = &#39;wdurl&#39;;<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * The default URL of the WebDriver server to use if<tr><td><a name="l66" href="#l66">66</a><td> * {@link webdriver.AbstractBuilder.SERVER_URL_ENV} is not set.<tr><td><a name="l67" href="#l67">67</a><td> * @type {string}<tr><td><a name="l68" href="#l68">68</a><td> * @const<tr><td><a name="l69" href="#l69">69</a><td> */<tr><td><a name="l70" href="#l70">70</a><td>webdriver.AbstractBuilder.DEFAULT_SERVER_URL = &#39;http://localhost:4444/wd/hub&#39;;<tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/**<tr><td><a name="l74" href="#l74">74</a><td> * Configures which WebDriver server should be used for new sessions. Overrides<tr><td><a name="l75" href="#l75">75</a><td> * the value loaded from the {@link webdriver.AbstractBuilder.SERVER_URL_ENV}<tr><td><a name="l76" href="#l76">76</a><td> * upon creation of this instance.<tr><td><a name="l77" href="#l77">77</a><td> * @param {string} url URL of the server to use.<tr><td><a name="l78" href="#l78">78</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l79" href="#l79">79</a><td> */<tr><td><a name="l80" href="#l80">80</a><td>webdriver.AbstractBuilder.prototype.usingServer = function(url) {<tr><td><a name="l81" href="#l81">81</a><td> this.serverUrl_ = url;<tr><td><a name="l82" href="#l82">82</a><td> return this;<tr><td><a name="l83" href="#l83">83</a><td>};<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td>/**<tr><td><a name="l87" href="#l87">87</a><td> * @return {string} The URL of the WebDriver server this instance is configured<tr><td><a name="l88" href="#l88">88</a><td> * to use.<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.AbstractBuilder.prototype.getServerUrl = function() {<tr><td><a name="l91" href="#l91">91</a><td> return this.serverUrl_;<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * Sets the desired capabilities when requesting a new session. This will<tr><td><a name="l97" href="#l97">97</a><td> * overwrite any previously set desired capabilities.<tr><td><a name="l98" href="#l98">98</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The desired<tr><td><a name="l99" href="#l99">99</a><td> * capabilities for a new session.<tr><td><a name="l100" href="#l100">100</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l101" href="#l101">101</a><td> */<tr><td><a name="l102" href="#l102">102</a><td>webdriver.AbstractBuilder.prototype.withCapabilities = function(capabilities) {<tr><td><a name="l103" href="#l103">103</a><td> this.capabilities_ = new webdriver.Capabilities(capabilities);<tr><td><a name="l104" href="#l104">104</a><td> return this;<tr><td><a name="l105" href="#l105">105</a><td>};<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>/**<tr><td><a name="l109" href="#l109">109</a><td> * @return {!webdriver.Capabilities} The current desired capabilities for this<tr><td><a name="l110" href="#l110">110</a><td> * builder.<tr><td><a name="l111" href="#l111">111</a><td> */<tr><td><a name="l112" href="#l112">112</a><td>webdriver.AbstractBuilder.prototype.getCapabilities = function() {<tr><td><a name="l113" href="#l113">113</a><td> return this.capabilities_;<tr><td><a name="l114" href="#l114">114</a><td>};<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>/**<tr><td><a name="l118" href="#l118">118</a><td> * Sets the logging preferences for the created session. Preferences may be<tr><td><a name="l119" href="#l119">119</a><td> * changed by repeated calls, or by calling {@link #withCapabilities}.<tr><td><a name="l120" href="#l120">120</a><td> * @param {!(webdriver.logging.Preferences|Object.&lt;string, string&gt;)} prefs The<tr><td><a name="l121" href="#l121">121</a><td> * desired logging preferences.<tr><td><a name="l122" href="#l122">122</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l123" href="#l123">123</a><td> */<tr><td><a name="l124" href="#l124">124</a><td>webdriver.AbstractBuilder.prototype.setLoggingPreferences = function(prefs) {<tr><td><a name="l125" href="#l125">125</a><td> this.capabilities_.set(webdriver.Capability.LOGGING_PREFS, prefs);<tr><td><a name="l126" href="#l126">126</a><td> return this;<tr><td><a name="l127" href="#l127">127</a><td>};<tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td>/**<tr><td><a name="l131" href="#l131">131</a><td> * Builds a new {@link webdriver.WebDriver} instance using this builder&#39;s<tr><td><a name="l132" href="#l132">132</a><td> * current configuration.<tr><td><a name="l133" href="#l133">133</a><td> * @return {!webdriver.WebDriver} A new WebDriver client.<tr><td><a name="l134" href="#l134">134</a><td> */<tr><td><a name="l135" href="#l135">135</a><td>webdriver.AbstractBuilder.prototype.build = goog.abstractMethod;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>
1
+ <!DOCTYPE html><meta charset="UTF-8"><meta http-equiv="Content-Language" content="en" /><title>abstractbuilder.js</title><link href="../../../dossier.css" rel="stylesheet" type="text/css"><div id="main-wrapper"><input type="checkbox" id="sidenav-toggle" /><main><header><h1>lib/webdriver/abstractbuilder.js</h1></header><pre><table class="srcfile"><tbody><tr><td><a name="l1" href="#l1">1</a><td>// Copyright 2012 Software Freedom Conservancy. All Rights Reserved.<tr><td><a name="l2" href="#l2">2</a><td>//<tr><td><a name="l3" href="#l3">3</a><td>// Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);<tr><td><a name="l4" href="#l4">4</a><td>// you may not use this file except in compliance with the License.<tr><td><a name="l5" href="#l5">5</a><td>// You may obtain a copy of the License at<tr><td><a name="l6" href="#l6">6</a><td>//<tr><td><a name="l7" href="#l7">7</a><td>// http://www.apache.org/licenses/LICENSE-2.0<tr><td><a name="l8" href="#l8">8</a><td>//<tr><td><a name="l9" href="#l9">9</a><td>// Unless required by applicable law or agreed to in writing, software<tr><td><a name="l10" href="#l10">10</a><td>// distributed under the License is distributed on an &quot;AS IS&quot; BASIS,<tr><td><a name="l11" href="#l11">11</a><td>// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.<tr><td><a name="l12" href="#l12">12</a><td>// See the License for the specific language governing permissions and<tr><td><a name="l13" href="#l13">13</a><td>// limitations under the License.<tr><td><a name="l14" href="#l14">14</a><td><tr><td><a name="l15" href="#l15">15</a><td>goog.provide(&#39;webdriver.AbstractBuilder&#39;);<tr><td><a name="l16" href="#l16">16</a><td><tr><td><a name="l17" href="#l17">17</a><td>goog.require(&#39;webdriver.Capabilities&#39;);<tr><td><a name="l18" href="#l18">18</a><td>goog.require(&#39;webdriver.process&#39;);<tr><td><a name="l19" href="#l19">19</a><td><tr><td><a name="l20" href="#l20">20</a><td><tr><td><a name="l21" href="#l21">21</a><td><tr><td><a name="l22" href="#l22">22</a><td>/**<tr><td><a name="l23" href="#l23">23</a><td> * Creates new {@code webdriver.WebDriver} clients. Upon instantiation, each<tr><td><a name="l24" href="#l24">24</a><td> * Builder will configure itself based on the following environment variables:<tr><td><a name="l25" href="#l25">25</a><td> * &lt;dl&gt;<tr><td><a name="l26" href="#l26">26</a><td> * &lt;dt&gt;{@code webdriver.AbstractBuilder.SERVER_URL_ENV}&lt;/dt&gt;<tr><td><a name="l27" href="#l27">27</a><td> * &lt;dd&gt;Defines the remote WebDriver server that should be used for command<tr><td><a name="l28" href="#l28">28</a><td> * command execution; may be overridden using<tr><td><a name="l29" href="#l29">29</a><td> * {@code webdriver.AbstractBuilder.prototype.usingServer}.&lt;/dd&gt;<tr><td><a name="l30" href="#l30">30</a><td> * &lt;/dl&gt;<tr><td><a name="l31" href="#l31">31</a><td> * @constructor<tr><td><a name="l32" href="#l32">32</a><td> */<tr><td><a name="l33" href="#l33">33</a><td>webdriver.AbstractBuilder = function() {<tr><td><a name="l34" href="#l34">34</a><td><tr><td><a name="l35" href="#l35">35</a><td> /**<tr><td><a name="l36" href="#l36">36</a><td> * URL of the remote server to use for new clients; initialized from the<tr><td><a name="l37" href="#l37">37</a><td> * value of the {@link webdriver.AbstractBuilder.SERVER_URL_ENV} environment<tr><td><a name="l38" href="#l38">38</a><td> * variable, but may be overridden using<tr><td><a name="l39" href="#l39">39</a><td> * {@link webdriver.AbstractBuilder#usingServer}.<tr><td><a name="l40" href="#l40">40</a><td> * @private {string}<tr><td><a name="l41" href="#l41">41</a><td> */<tr><td><a name="l42" href="#l42">42</a><td> this.serverUrl_ = webdriver.process.getEnv(<tr><td><a name="l43" href="#l43">43</a><td> webdriver.AbstractBuilder.SERVER_URL_ENV);<tr><td><a name="l44" href="#l44">44</a><td><tr><td><a name="l45" href="#l45">45</a><td> /**<tr><td><a name="l46" href="#l46">46</a><td> * The desired capabilities to use when creating a new session.<tr><td><a name="l47" href="#l47">47</a><td> * @private {!webdriver.Capabilities}<tr><td><a name="l48" href="#l48">48</a><td> */<tr><td><a name="l49" href="#l49">49</a><td> this.capabilities_ = new webdriver.Capabilities();<tr><td><a name="l50" href="#l50">50</a><td>};<tr><td><a name="l51" href="#l51">51</a><td><tr><td><a name="l52" href="#l52">52</a><td><tr><td><a name="l53" href="#l53">53</a><td>/**<tr><td><a name="l54" href="#l54">54</a><td> * Environment variable that defines the URL of the WebDriver server that<tr><td><a name="l55" href="#l55">55</a><td> * should be used for all new WebDriver clients. This setting may be overridden<tr><td><a name="l56" href="#l56">56</a><td> * using {@code #usingServer(url)}.<tr><td><a name="l57" href="#l57">57</a><td> * @type {string}<tr><td><a name="l58" href="#l58">58</a><td> * @const<tr><td><a name="l59" href="#l59">59</a><td> * @see webdriver.process.getEnv<tr><td><a name="l60" href="#l60">60</a><td> */<tr><td><a name="l61" href="#l61">61</a><td>webdriver.AbstractBuilder.SERVER_URL_ENV = &#39;wdurl&#39;;<tr><td><a name="l62" href="#l62">62</a><td><tr><td><a name="l63" href="#l63">63</a><td><tr><td><a name="l64" href="#l64">64</a><td>/**<tr><td><a name="l65" href="#l65">65</a><td> * The default URL of the WebDriver server to use if<tr><td><a name="l66" href="#l66">66</a><td> * {@link webdriver.AbstractBuilder.SERVER_URL_ENV} is not set.<tr><td><a name="l67" href="#l67">67</a><td> * @type {string}<tr><td><a name="l68" href="#l68">68</a><td> * @const<tr><td><a name="l69" href="#l69">69</a><td> */<tr><td><a name="l70" href="#l70">70</a><td>webdriver.AbstractBuilder.DEFAULT_SERVER_URL = &#39;http://localhost:4444/wd/hub&#39;;<tr><td><a name="l71" href="#l71">71</a><td><tr><td><a name="l72" href="#l72">72</a><td><tr><td><a name="l73" href="#l73">73</a><td>/**<tr><td><a name="l74" href="#l74">74</a><td> * Configures which WebDriver server should be used for new sessions. Overrides<tr><td><a name="l75" href="#l75">75</a><td> * the value loaded from the {@link webdriver.AbstractBuilder.SERVER_URL_ENV}<tr><td><a name="l76" href="#l76">76</a><td> * upon creation of this instance.<tr><td><a name="l77" href="#l77">77</a><td> * @param {string} url URL of the server to use.<tr><td><a name="l78" href="#l78">78</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l79" href="#l79">79</a><td> */<tr><td><a name="l80" href="#l80">80</a><td>webdriver.AbstractBuilder.prototype.usingServer = function(url) {<tr><td><a name="l81" href="#l81">81</a><td> this.serverUrl_ = url;<tr><td><a name="l82" href="#l82">82</a><td> return this;<tr><td><a name="l83" href="#l83">83</a><td>};<tr><td><a name="l84" href="#l84">84</a><td><tr><td><a name="l85" href="#l85">85</a><td><tr><td><a name="l86" href="#l86">86</a><td>/**<tr><td><a name="l87" href="#l87">87</a><td> * @return {string} The URL of the WebDriver server this instance is configured<tr><td><a name="l88" href="#l88">88</a><td> * to use.<tr><td><a name="l89" href="#l89">89</a><td> */<tr><td><a name="l90" href="#l90">90</a><td>webdriver.AbstractBuilder.prototype.getServerUrl = function() {<tr><td><a name="l91" href="#l91">91</a><td> return this.serverUrl_;<tr><td><a name="l92" href="#l92">92</a><td>};<tr><td><a name="l93" href="#l93">93</a><td><tr><td><a name="l94" href="#l94">94</a><td><tr><td><a name="l95" href="#l95">95</a><td>/**<tr><td><a name="l96" href="#l96">96</a><td> * Sets the desired capabilities when requesting a new session. This will<tr><td><a name="l97" href="#l97">97</a><td> * overwrite any previously set desired capabilities.<tr><td><a name="l98" href="#l98">98</a><td> * @param {!(Object|webdriver.Capabilities)} capabilities The desired<tr><td><a name="l99" href="#l99">99</a><td> * capabilities for a new session.<tr><td><a name="l100" href="#l100">100</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l101" href="#l101">101</a><td> */<tr><td><a name="l102" href="#l102">102</a><td>webdriver.AbstractBuilder.prototype.withCapabilities = function(capabilities) {<tr><td><a name="l103" href="#l103">103</a><td> this.capabilities_ = new webdriver.Capabilities(capabilities);<tr><td><a name="l104" href="#l104">104</a><td> return this;<tr><td><a name="l105" href="#l105">105</a><td>};<tr><td><a name="l106" href="#l106">106</a><td><tr><td><a name="l107" href="#l107">107</a><td><tr><td><a name="l108" href="#l108">108</a><td>/**<tr><td><a name="l109" href="#l109">109</a><td> * @return {!webdriver.Capabilities} The current desired capabilities for this<tr><td><a name="l110" href="#l110">110</a><td> * builder.<tr><td><a name="l111" href="#l111">111</a><td> */<tr><td><a name="l112" href="#l112">112</a><td>webdriver.AbstractBuilder.prototype.getCapabilities = function() {<tr><td><a name="l113" href="#l113">113</a><td> return this.capabilities_;<tr><td><a name="l114" href="#l114">114</a><td>};<tr><td><a name="l115" href="#l115">115</a><td><tr><td><a name="l116" href="#l116">116</a><td><tr><td><a name="l117" href="#l117">117</a><td>/**<tr><td><a name="l118" href="#l118">118</a><td> * Sets the logging preferences for the created session. Preferences may be<tr><td><a name="l119" href="#l119">119</a><td> * changed by repeated calls, or by calling {@link #withCapabilities}.<tr><td><a name="l120" href="#l120">120</a><td> * @param {!(webdriver.logging.Preferences|Object.&lt;string, string&gt;)} prefs The<tr><td><a name="l121" href="#l121">121</a><td> * desired logging preferences.<tr><td><a name="l122" href="#l122">122</a><td> * @return {!webdriver.AbstractBuilder} This Builder instance for chain calling.<tr><td><a name="l123" href="#l123">123</a><td> */<tr><td><a name="l124" href="#l124">124</a><td>webdriver.AbstractBuilder.prototype.setLoggingPreferences = function(prefs) {<tr><td><a name="l125" href="#l125">125</a><td> this.capabilities_.set(webdriver.Capability.LOGGING_PREFS, prefs);<tr><td><a name="l126" href="#l126">126</a><td> return this;<tr><td><a name="l127" href="#l127">127</a><td>};<tr><td><a name="l128" href="#l128">128</a><td><tr><td><a name="l129" href="#l129">129</a><td><tr><td><a name="l130" href="#l130">130</a><td>/**<tr><td><a name="l131" href="#l131">131</a><td> * Builds a new {@link webdriver.WebDriver} instance using this builder&#39;s<tr><td><a name="l132" href="#l132">132</a><td> * current configuration.<tr><td><a name="l133" href="#l133">133</a><td> * @return {!webdriver.WebDriver} A new WebDriver client.<tr><td><a name="l134" href="#l134">134</a><td> */<tr><td><a name="l135" href="#l135">135</a><td>webdriver.AbstractBuilder.prototype.build = goog.abstractMethod;</table></pre></main><nav id="topnav"><div><div id="menubutton"><label for="sidenav-toggle">Menu</label></div><form id="searchbox"><div><input type="search" placeholder="Search" tabindex="1"></div></form></div></nav><nav id="sidenav"><input type="checkbox" id="sidenav-types-ctrl" /><input type="checkbox" id="sidenav-files-ctrl" /><input type="checkbox" id="sidenav-modules-ctrl" /><a id="sidenav-overview"><div><h4>Overview</h4></div></a><div id="sidenav-types"><label for="sidenav-types-ctrl"><h4>Types</h4></label><i>Loading</i></div><div id="sidenav-modules"><label for="sidenav-modules-ctrl"><h4>Modules</h4></label><i>Loading</i></div><div id="sidenav-files"><label for="sidenav-files-ctrl"><h4>Files</h4></label><i>Loading</i></div><a href="../../../license.html"><div><h4>License</h4></div></a></nav><div id="push-footer"></div></div><footer><a href="https://github.com/jleyba/js-dossier">Generated by dossier</a></footer><script src="../../../types.js"></script><script src="../../../dossier.js"></script>