Commands.pm 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475
  1. package Selenium::Remote::Commands;
  2. # ABSTRACT: Implement commands for Selenium::Remote::Driver
  3. use Moo;
  4. has '_cmds' => (
  5. is => 'lazy',
  6. reader => 'get_cmds',
  7. builder => sub {
  8. return {
  9. 'status' => {
  10. 'method' => 'GET',
  11. 'url' => 'status',
  12. 'no_content_success' => 0
  13. },
  14. 'newSession' => {
  15. 'method' => 'POST',
  16. 'url' => 'session',
  17. 'no_content_success' => 0
  18. },
  19. 'getSessions' => {
  20. 'method' => 'GET',
  21. 'url' => 'sessions',
  22. 'no_content_success' => 0
  23. },
  24. 'getCapabilities' => {
  25. 'method' => 'GET',
  26. 'url' => 'session/:sessionId',
  27. 'no_content_success' => 0
  28. },
  29. 'setTimeout' => {
  30. 'method' => 'POST',
  31. 'url' => 'session/:sessionId/timeouts',
  32. 'no_content_success' => 1
  33. },
  34. 'setAsyncScriptTimeout' => {
  35. 'method' => 'POST',
  36. 'url' => 'session/:sessionId/timeouts/async_script',
  37. 'no_content_success' => 1
  38. },
  39. 'setImplicitWaitTimeout' => {
  40. 'method' => 'POST',
  41. 'url' => 'session/:sessionId/timeouts/implicit_wait',
  42. 'no_content_success' => 1
  43. },
  44. 'quit' => {
  45. 'method' => 'DELETE',
  46. 'url' => 'session/:sessionId',
  47. 'no_content_success' => 1
  48. },
  49. 'getCurrentWindowHandle' => {
  50. 'method' => 'GET',
  51. 'url' => 'session/:sessionId/window_handle',
  52. 'no_content_success' => 0
  53. },
  54. 'getWindowHandles' => {
  55. 'method' => 'GET',
  56. 'url' => 'session/:sessionId/window_handles',
  57. 'no_content_success' => 0
  58. },
  59. 'getWindowSize' => {
  60. 'method' => 'GET',
  61. 'url' => 'session/:sessionId/window/:windowHandle/size',
  62. 'no_content_success' => 0
  63. },
  64. 'getWindowPosition' => {
  65. 'method' => 'GET',
  66. 'url' => 'session/:sessionId/window/:windowHandle/position',
  67. 'no_content_success' => 0
  68. },
  69. 'maximizeWindow' => {
  70. 'method' => 'POST',
  71. 'url' => 'session/:sessionId/window/:windowHandle/maximize',
  72. 'no_content_success' => 1
  73. },
  74. 'setWindowSize' => {
  75. 'method' => 'POST',
  76. 'url' => 'session/:sessionId/window/:windowHandle/size',
  77. 'no_content_success' => 1
  78. },
  79. 'setWindowPosition' => {
  80. 'method' => 'POST',
  81. 'url' => 'session/:sessionId/window/:windowHandle/position',
  82. 'no_content_success' => 1
  83. },
  84. 'getCurrentUrl' => {
  85. 'method' => 'GET',
  86. 'url' => 'session/:sessionId/url',
  87. 'no_content_success' => 0
  88. },
  89. 'get' => {
  90. 'method' => 'POST',
  91. 'url' => 'session/:sessionId/url',
  92. 'no_content_success' => 1
  93. },
  94. 'goForward' => {
  95. 'method' => 'POST',
  96. 'url' => 'session/:sessionId/forward',
  97. 'no_content_success' => 1
  98. },
  99. 'goBack' => {
  100. 'method' => 'POST',
  101. 'url' => 'session/:sessionId/back',
  102. 'no_content_success' => 1
  103. },
  104. 'refresh' => {
  105. 'method' => 'POST',
  106. 'url' => 'session/:sessionId/refresh',
  107. 'no_content_success' => 1
  108. },
  109. 'executeScript' => {
  110. 'method' => 'POST',
  111. 'url' => 'session/:sessionId/execute',
  112. 'no_content_success' => 0
  113. },
  114. 'executeAsyncScript' => {
  115. 'method' => 'POST',
  116. 'url' => 'session/:sessionId/execute_async',
  117. 'no_content_success' => 0
  118. },
  119. 'screenshot' => {
  120. 'method' => 'GET',
  121. 'url' => 'session/:sessionId/screenshot',
  122. 'no_content_success' => 0
  123. },
  124. 'availableEngines' => {
  125. 'method' => 'GET',
  126. 'url' => 'session/:sessionId/ime/available_engines',
  127. 'no_content_success' => 0
  128. },
  129. 'switchToFrame' => {
  130. 'method' => 'POST',
  131. 'url' => 'session/:sessionId/frame',
  132. 'no_content_success' => 1
  133. },
  134. 'switchToWindow' => {
  135. 'method' => 'POST',
  136. 'url' => 'session/:sessionId/window',
  137. 'no_content_success' => 1
  138. },
  139. 'getAllCookies' => {
  140. 'method' => 'GET',
  141. 'url' => 'session/:sessionId/cookie',
  142. 'no_content_success' => 0
  143. },
  144. 'addCookie' => {
  145. 'method' => 'POST',
  146. 'url' => 'session/:sessionId/cookie',
  147. 'no_content_success' => 1
  148. },
  149. 'deleteAllCookies' => {
  150. 'method' => 'DELETE',
  151. 'url' => 'session/:sessionId/cookie',
  152. 'no_content_success' => 1
  153. },
  154. 'deleteCookieNamed' => {
  155. 'method' => 'DELETE',
  156. 'url' => 'session/:sessionId/cookie/:name',
  157. 'no_content_success' => 1
  158. },
  159. 'getPageSource' => {
  160. 'method' => 'GET',
  161. 'url' => 'session/:sessionId/source',
  162. 'no_content_success' => 0
  163. },
  164. 'getTitle' => {
  165. 'method' => 'GET',
  166. 'url' => 'session/:sessionId/title',
  167. 'no_content_success' => 0
  168. },
  169. 'findElement' => {
  170. 'method' => 'POST',
  171. 'url' => 'session/:sessionId/element',
  172. 'no_content_success' => 0
  173. },
  174. 'findElements' => {
  175. 'method' => 'POST',
  176. 'url' => 'session/:sessionId/elements',
  177. 'no_content_success' => 0
  178. },
  179. 'getActiveElement' => {
  180. 'method' => 'POST',
  181. 'url' => 'session/:sessionId/element/active',
  182. 'no_content_success' => 0
  183. },
  184. 'describeElement' => {
  185. 'method' => 'GET',
  186. 'url' => 'session/:sessionId/element/:id',
  187. 'no_content_success' => 0
  188. },
  189. 'findChildElement' => {
  190. 'method' => 'POST',
  191. 'url' => 'session/:sessionId/element/:id/element',
  192. 'no_content_success' => 0
  193. },
  194. 'findChildElements' => {
  195. 'method' => 'POST',
  196. 'url' => 'session/:sessionId/element/:id/elements',
  197. 'no_content_success' => 0
  198. },
  199. 'clickElement' => {
  200. 'method' => 'POST',
  201. 'url' => 'session/:sessionId/element/:id/click',
  202. 'no_content_success' => 1
  203. },
  204. 'submitElement' => {
  205. 'method' => 'POST',
  206. 'url' => 'session/:sessionId/element/:id/submit',
  207. 'no_content_success' => 1
  208. },
  209. 'sendKeysToElement' => {
  210. 'method' => 'POST',
  211. 'url' => 'session/:sessionId/element/:id/value',
  212. 'no_content_success' => 1
  213. },
  214. 'sendKeysToActiveElement' => {
  215. 'method' => 'POST',
  216. 'url' => 'session/:sessionId/keys',
  217. 'no_content_success' => 1
  218. },
  219. 'sendModifier' => {
  220. 'method' => 'POST',
  221. 'url' => 'session/:sessionId/modifier',
  222. 'no_content_success' => 1
  223. },
  224. 'isElementSelected' => {
  225. 'method' => 'GET',
  226. 'url' => 'session/:sessionId/element/:id/selected',
  227. 'no_content_success' => 0
  228. },
  229. 'setElementSelected' => {
  230. 'method' => 'POST',
  231. 'url' => 'session/:sessionId/element/:id/selected',
  232. 'no_content_success' => 0
  233. },
  234. 'toggleElement' => {
  235. 'method' => 'POST',
  236. 'url' => 'session/:sessionId/element/:id/toggle',
  237. 'no_content_success' => 0
  238. },
  239. 'isElementEnabled' => {
  240. 'method' => 'GET',
  241. 'url' => 'session/:sessionId/element/:id/enabled',
  242. 'no_content_success' => 0
  243. },
  244. 'getElementLocation' => {
  245. 'method' => 'GET',
  246. 'url' => 'session/:sessionId/element/:id/location',
  247. 'no_content_success' => 0
  248. },
  249. 'getElementLocationInView' => {
  250. 'method' => 'GET',
  251. 'url' => 'session/:sessionId/element/:id/location_in_view',
  252. 'no_content_success' => 0
  253. },
  254. 'getElementTagName' => {
  255. 'method' => 'GET',
  256. 'url' => 'session/:sessionId/element/:id/name',
  257. 'no_content_success' => 0
  258. },
  259. 'clearElement' => {
  260. 'method' => 'POST',
  261. 'url' => 'session/:sessionId/element/:id/clear',
  262. 'no_content_success' => 1
  263. },
  264. 'getElementAttribute' => {
  265. 'method' => 'GET',
  266. 'url' => 'session/:sessionId/element/:id/attribute/:name',
  267. 'no_content_success' => 0
  268. },
  269. 'elementEquals' => {
  270. 'method' => 'GET',
  271. 'url' => 'session/:sessionId/element/:id/equals/:other',
  272. 'no_content_success' => 0
  273. },
  274. 'isElementDisplayed' => {
  275. 'method' => 'GET',
  276. 'url' => 'session/:sessionId/element/:id/displayed',
  277. 'no_content_success' => 0
  278. },
  279. 'close' => {
  280. 'method' => 'DELETE',
  281. 'url' => 'session/:sessionId/window',
  282. 'no_content_success' => 1
  283. },
  284. 'getElementSize' => {
  285. 'method' => 'GET',
  286. 'url' => 'session/:sessionId/element/:id/size',
  287. 'no_content_success' => 0
  288. },
  289. 'getElementText' => {
  290. 'method' => 'GET',
  291. 'url' => 'session/:sessionId/element/:id/text',
  292. 'no_content_success' => 0
  293. },
  294. 'getElementValueOfCssProperty' => {
  295. 'method' => 'GET',
  296. 'url' => 'session/:sessionId/element/:id/css/:propertyName',
  297. 'no_content_success' => 0
  298. },
  299. 'mouseMoveToLocation' => {
  300. 'method' => 'POST',
  301. 'url' => 'session/:sessionId/moveto',
  302. 'no_content_success' => 1
  303. },
  304. 'getAlertText' => {
  305. 'method' => 'GET',
  306. 'url' => 'session/:sessionId/alert_text',
  307. 'no_content_success' => 0
  308. },
  309. 'sendKeysToPrompt' => {
  310. 'method' => 'POST',
  311. 'url' => 'session/:sessionId/alert_text',
  312. 'no_content_success' => 1
  313. },
  314. 'acceptAlert' => {
  315. 'method' => 'POST',
  316. 'url' => 'session/:sessionId/accept_alert',
  317. 'no_content_success' => 1
  318. },
  319. 'dismissAlert' => {
  320. 'method' => 'POST',
  321. 'url' => 'session/:sessionId/dismiss_alert',
  322. 'no_content_success' => 1
  323. },
  324. 'click' => {
  325. 'method' => 'POST',
  326. 'url' => 'session/:sessionId/click',
  327. 'no_content_success' => 1
  328. },
  329. 'doubleClick' => {
  330. 'method' => 'POST',
  331. 'url' => 'session/:sessionId/doubleclick',
  332. 'no_content_success' => 1
  333. },
  334. 'buttonDown' => {
  335. 'method' => 'POST',
  336. 'url' => 'session/:sessionId/buttondown',
  337. 'no_content_success' => 1
  338. },
  339. 'buttonUp' => {
  340. 'method' => 'POST',
  341. 'url' => 'session/:sessionId/buttonup',
  342. 'no_content_success' => 1
  343. },
  344. 'uploadFile' => {
  345. 'method' => 'POST',
  346. 'url' => 'session/:sessionId/file',
  347. 'no_content_success' => 0
  348. },
  349. 'getLocalStorageItem' => {
  350. 'method' => 'GET',
  351. 'url' => '/session/:sessionId/local_storage/key/:key',
  352. 'no_content_success' => 0
  353. },
  354. 'deleteLocalStorageItem' => {
  355. 'method' => 'DELETE',
  356. 'url' => '/session/:sessionId/local_storage/key/:key',
  357. 'no_content_success' => 1
  358. },
  359. 'cacheStatus' => {
  360. 'method' => 'GET',
  361. 'url' => 'session/:sessionId/application_cache/status',
  362. 'no_content_success' => 0
  363. },
  364. 'setGeolocation' => {
  365. 'method' => 'POST',
  366. 'url' => 'session/:sessionId/location',
  367. 'no_content_success' => 1
  368. },
  369. 'getGeolocation' => {
  370. 'method' => 'GET',
  371. 'url' => 'session/:sessionId/location',
  372. 'no_content_success' => 0
  373. },
  374. 'getLog' => {
  375. 'method' => 'POST',
  376. 'url' => 'session/:sessionId/log',
  377. 'no_content_success' => 0
  378. },
  379. 'getLogTypes' => {
  380. 'method' => 'GET',
  381. 'url' => 'session/:sessionId/log/types',
  382. 'no_content_success' => 0
  383. },
  384. 'setOrientation' => {
  385. 'method' => 'POST',
  386. 'url' => 'session/:sessionId/orientation',
  387. 'no_content_success' => 1
  388. },
  389. 'getOrientation' => {
  390. 'method' => 'GET',
  391. 'url' => 'session/:sessionId/orientation',
  392. 'no_content_success' => 0
  393. },
  394. # firefox extension
  395. 'setContext' => {
  396. 'method' => 'POST',
  397. 'url' => 'session/:sessionId/moz/context',
  398. 'no_content_success' => 1
  399. },
  400. 'getContext' => {
  401. 'method' => 'GET',
  402. 'url' => 'session/:sessionId/moz/context',
  403. 'no_content_success' => 0
  404. },
  405. # geckodriver workarounds
  406. 'executeScriptGecko' => {
  407. 'method' => 'POST',
  408. 'url' => 'session/:sessionId/execute/sync',
  409. 'no_content_success' => 0
  410. },
  411. 'executeAsyncScriptGecko' => {
  412. 'method' => 'POST',
  413. 'url' => 'session/:sessionId/execute/async',
  414. 'no_content_success' => 0
  415. },
  416. # /session/:sessionId/local_storage
  417. # /session/:sessionId/local_storage/key/:key
  418. # /session/:sessionId/local_storage/size
  419. # /session/:sessionId/session_storage
  420. # /session/:sessionId/session_storage/key/:key
  421. # /session/:sessionId/session_storage/size
  422. };
  423. }
  424. );
  425. # helper methods to manipulate the _cmds hash
  426. sub get_url {
  427. my ( $self, $command ) = @_;
  428. return $self->get_cmds->{$command}->{url};
  429. }
  430. sub get_method {
  431. my ( $self, $command ) = @_;
  432. return $self->get_cmds->{$command}->{method};
  433. }
  434. sub get_no_content_success {
  435. my ( $self, $command ) = @_;
  436. return $self->get_cmds->{$command}->{no_content_success};
  437. }
  438. # This method will replace the template & return
  439. sub get_params {
  440. my ( $self, $args ) = @_;
  441. if ( !( defined $args->{'session_id'} ) ) {
  442. return;
  443. }
  444. my $data = {};
  445. my $command = $args->{'command'};
  446. my $url = $self->get_url($command);
  447. # Do the var substitutions.
  448. $url =~ s/:sessionId/$args->{'session_id'}/;
  449. $url =~ s/:id/$args->{'id'}/;
  450. $url =~ s/:name/$args->{'name'}/;
  451. $url =~ s/:propertyName/$args->{'property_name'}/;
  452. $url =~ s/:other/$args->{'other'}/;
  453. $url =~ s/:windowHandle/$args->{'window_handle'}/;
  454. $data->{'method'} = $self->get_method($command);
  455. $data->{'no_content_success'} = $self->get_no_content_success($command);
  456. $data->{'url'} = $url;
  457. return $data;
  458. }
  459. 1;
  460. __END__