codeceptjs 3.3.5 → 3.3.7-beta.1

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 (129) hide show
  1. package/CHANGELOG.md +37 -7
  2. package/bin/codecept.js +40 -3
  3. package/docs/basics.md +24 -1
  4. package/docs/build/Appium.js +41 -22
  5. package/docs/build/FileSystem.js +1 -1
  6. package/docs/build/Nightmare.js +106 -57
  7. package/docs/build/Playwright.js +187 -111
  8. package/docs/build/Protractor.js +132 -70
  9. package/docs/build/Puppeteer.js +143 -76
  10. package/docs/build/REST.js +2 -2
  11. package/docs/build/TestCafe.js +107 -57
  12. package/docs/build/WebDriver.js +162 -89
  13. package/docs/changelog.md +37 -7
  14. package/docs/commands.md +5 -3
  15. package/docs/configuration.md +5 -5
  16. package/docs/helpers/Appium.md +25 -23
  17. package/docs/helpers/FileSystem.md +1 -1
  18. package/docs/helpers/Nightmare.md +57 -57
  19. package/docs/helpers/Playwright.md +76 -75
  20. package/docs/helpers/Puppeteer.md +76 -85
  21. package/docs/helpers/REST.md +1 -1
  22. package/docs/helpers/TestCafe.md +57 -57
  23. package/docs/helpers/WebDriver.md +84 -97
  24. package/docs/quickstart.md +1 -1
  25. package/docs/reports.md +1 -1
  26. package/docs/secrets.md +1 -1
  27. package/docs/webapi/appendField.mustache +1 -1
  28. package/docs/webapi/attachFile.mustache +3 -3
  29. package/docs/webapi/checkOption.mustache +1 -1
  30. package/docs/webapi/clearCookie.mustache +1 -1
  31. package/docs/webapi/clearField.mustache +1 -1
  32. package/docs/webapi/click.mustache +1 -1
  33. package/docs/webapi/clickLink.mustache +1 -1
  34. package/docs/webapi/closeCurrentTab.mustache +1 -1
  35. package/docs/webapi/closeOtherTabs.mustache +1 -1
  36. package/docs/webapi/dontSee.mustache +1 -1
  37. package/docs/webapi/dontSeeCheckboxIsChecked.mustache +1 -1
  38. package/docs/webapi/dontSeeCookie.mustache +1 -1
  39. package/docs/webapi/dontSeeCurrentUrlEquals.mustache +1 -1
  40. package/docs/webapi/dontSeeElement.mustache +1 -1
  41. package/docs/webapi/dontSeeElementInDOM.mustache +1 -1
  42. package/docs/webapi/dontSeeInCurrentUrl.mustache +1 -1
  43. package/docs/webapi/dontSeeInField.mustache +1 -1
  44. package/docs/webapi/dontSeeInSource.mustache +1 -1
  45. package/docs/webapi/dontSeeInTitle.mustache +1 -1
  46. package/docs/webapi/doubleClick.mustache +1 -1
  47. package/docs/webapi/downloadFile.mustache +1 -1
  48. package/docs/webapi/dragAndDrop.mustache +1 -1
  49. package/docs/webapi/dragSlider.mustache +1 -1
  50. package/docs/webapi/executeAsyncScript.mustache +1 -1
  51. package/docs/webapi/executeScript.mustache +1 -1
  52. package/docs/webapi/fillField.mustache +1 -1
  53. package/docs/webapi/forceClick.mustache +1 -1
  54. package/docs/webapi/forceRightClick.mustache +1 -1
  55. package/docs/webapi/moveCursorTo.mustache +1 -1
  56. package/docs/webapi/openNewTab.mustache +1 -1
  57. package/docs/webapi/pressKey.mustache +1 -1
  58. package/docs/webapi/pressKeyDown.mustache +1 -1
  59. package/docs/webapi/pressKeyUp.mustache +1 -1
  60. package/docs/webapi/pressKeyWithKeyNormalization.mustache +1 -1
  61. package/docs/webapi/refreshPage.mustache +1 -1
  62. package/docs/webapi/resizeWindow.mustache +1 -1
  63. package/docs/webapi/rightClick.mustache +1 -1
  64. package/docs/webapi/saveElementScreenshot.mustache +2 -2
  65. package/docs/webapi/saveScreenshot.mustache +2 -2
  66. package/docs/webapi/say.mustache +1 -1
  67. package/docs/webapi/scrollIntoView.mustache +1 -1
  68. package/docs/webapi/scrollPageToBottom.mustache +1 -1
  69. package/docs/webapi/scrollPageToTop.mustache +1 -1
  70. package/docs/webapi/scrollTo.mustache +1 -1
  71. package/docs/webapi/see.mustache +1 -1
  72. package/docs/webapi/seeAttributesOnElements.mustache +1 -1
  73. package/docs/webapi/seeCheckboxIsChecked.mustache +1 -1
  74. package/docs/webapi/seeCookie.mustache +1 -1
  75. package/docs/webapi/seeCssPropertiesOnElements.mustache +1 -1
  76. package/docs/webapi/seeCurrentUrlEquals.mustache +1 -1
  77. package/docs/webapi/seeElement.mustache +1 -1
  78. package/docs/webapi/seeElementInDOM.mustache +1 -1
  79. package/docs/webapi/seeInCurrentUrl.mustache +1 -1
  80. package/docs/webapi/seeInField.mustache +1 -1
  81. package/docs/webapi/seeInPopup.mustache +1 -1
  82. package/docs/webapi/seeInSource.mustache +1 -1
  83. package/docs/webapi/seeInTitle.mustache +1 -1
  84. package/docs/webapi/seeNumberOfElements.mustache +1 -1
  85. package/docs/webapi/seeNumberOfVisibleElements.mustache +1 -1
  86. package/docs/webapi/seeTextEquals.mustache +1 -1
  87. package/docs/webapi/seeTitleEquals.mustache +1 -1
  88. package/docs/webapi/selectOption.mustache +1 -1
  89. package/docs/webapi/setCookie.mustache +1 -1
  90. package/docs/webapi/setGeoLocation.mustache +1 -1
  91. package/docs/webapi/switchTo.mustache +1 -1
  92. package/docs/webapi/switchToNextTab.mustache +1 -1
  93. package/docs/webapi/switchToPreviousTab.mustache +1 -1
  94. package/docs/webapi/type.mustache +1 -1
  95. package/docs/webapi/uncheckOption.mustache +1 -1
  96. package/docs/webapi/wait.mustache +1 -1
  97. package/docs/webapi/waitForClickable.mustache +1 -1
  98. package/docs/webapi/waitForDetached.mustache +1 -1
  99. package/docs/webapi/waitForElement.mustache +1 -1
  100. package/docs/webapi/waitForEnabled.mustache +1 -1
  101. package/docs/webapi/waitForFunction.mustache +1 -1
  102. package/docs/webapi/waitForInvisible.mustache +1 -1
  103. package/docs/webapi/waitForText.mustache +1 -1
  104. package/docs/webapi/waitForValue.mustache +1 -1
  105. package/docs/webapi/waitForVisible.mustache +1 -1
  106. package/docs/webapi/waitInUrl.mustache +1 -1
  107. package/docs/webapi/waitNumberOfVisibleElements.mustache +1 -1
  108. package/docs/webapi/waitToHide.mustache +1 -1
  109. package/docs/webapi/waitUrlEquals.mustache +1 -1
  110. package/lib/command/configMigrate.js +1 -1
  111. package/lib/command/dryRun.js +2 -1
  112. package/lib/command/generate.js +35 -18
  113. package/lib/command/run-rerun.js +38 -0
  114. package/lib/command/utils.js +13 -3
  115. package/lib/config.js +2 -2
  116. package/lib/data/context.js +7 -0
  117. package/lib/helper/Appium.js +6 -4
  118. package/lib/helper/FileSystem.js +1 -1
  119. package/lib/helper/Nightmare.js +1 -1
  120. package/lib/helper/Playwright.js +50 -38
  121. package/lib/helper/Protractor.js +1 -1
  122. package/lib/helper/REST.js +2 -2
  123. package/lib/helper/TestCafe.js +1 -1
  124. package/lib/helper/WebDriver.js +7 -7
  125. package/lib/plugin/wdio.js +11 -2
  126. package/lib/utils.js +3 -0
  127. package/package.json +2 -2
  128. package/typings/index.d.ts +46 -46
  129. package/typings/types.d.ts +497 -443
@@ -302,7 +302,7 @@ I.appendField('#myTextField', 'appended');
302
302
 
303
303
  - `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator
304
304
  - `value` **[string][6]** text value to append.
305
- [!] returns a _promise_ which is synchronized internally by recorder
305
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
306
306
 
307
307
 
308
308
  This action supports [React locators](https://codecept.io/react#locators)
@@ -311,7 +311,7 @@ This action supports [React locators](https://codecept.io/react#locators)
311
311
  ### attachFile
312
312
 
313
313
  Attaches a file to element located by label, name, CSS or XPath
314
- Path to file is relative current codecept directory (where codecept.json or codecept.conf.js is located).
314
+ Path to file is relative current codecept directory (where codecept.conf.ts or codecept.conf.js is located).
315
315
  File will be uploaded to remote system (if tests are running remotely).
316
316
 
317
317
  ```js
@@ -322,8 +322,8 @@ I.attachFile('form input[name=avatar]', 'data/avatar.jpg');
322
322
  #### Parameters
323
323
 
324
324
  - `locator` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
325
- - `pathToFile` **[string][6]** local file path relative to codecept.json config file.
326
- [!] returns a _promise_ which is synchronized internally by recorder> ⚠ There is an [issue with file upload in Puppeteer 2.1.0 & 2.1.1][7], downgrade to 2.0.0 if you face it.
325
+ - `pathToFile` **[string][6]** local file path relative to codecept.conf.ts or codecept.conf.js config file.
326
+ ⚠️ returns a _promise_ which is synchronized internally by recorder> ⚠ There is an [issue with file upload in Puppeteer 2.1.0 & 2.1.1][7], downgrade to 2.0.0 if you face it.
327
327
 
328
328
  ### cancelPopup
329
329
 
@@ -346,7 +346,7 @@ I.checkOption('agree', '//form');
346
346
 
347
347
  - `field` **([string][6] | [object][4])** checkbox located by label | name | CSS | XPath | strict locator.
348
348
  - `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator.
349
- [!] returns a _promise_ which is synchronized internally by recorder
349
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
350
350
 
351
351
  ### clearCookie
352
352
 
@@ -362,7 +362,7 @@ I.clearCookie('test');
362
362
 
363
363
  - `name`
364
364
  - `cookie` **[string][6]?** (optional, `null` by default) cookie name
365
- [!] returns a _promise_ which is synchronized internally by recorder
365
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
366
366
 
367
367
  ### clearField
368
368
 
@@ -378,7 +378,7 @@ I.clearField('#email');
378
378
 
379
379
  - `field`
380
380
  - `editable` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
381
- [!] returns a _promise_ which is synchronized internally by recorder
381
+ ⚠️ returns a _promise_ which is synchronized internally by recorder.
382
382
 
383
383
  ### click
384
384
 
@@ -408,7 +408,7 @@ I.click({css: 'nav a.login'});
408
408
 
409
409
  - `locator` **([string][6] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
410
410
  - `context` **([string][6]? | [object][4] | null)** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
411
- [!] returns a _promise_ which is synchronized internally by recorder
411
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
412
412
 
413
413
 
414
414
  This action supports [React locators](https://codecept.io/react#locators)
@@ -426,7 +426,7 @@ I.clickLink('Logout', '#nav');
426
426
 
427
427
  - `locator` **([string][6] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator
428
428
  - `context` **([string][6]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator
429
- [!] returns a _promise_ which is synchronized internally by recorder
429
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
430
430
 
431
431
 
432
432
  This action supports [React locators](https://codecept.io/react#locators)
@@ -462,7 +462,7 @@ I.dontSee('Login', '.nav'); // no login inside .nav element
462
462
 
463
463
  - `text` **[string][6]** which is not present.
464
464
  - `context` **([string][6] | [object][4])?** (optional) element located by CSS|XPath|strict locator in which to perfrom search.
465
- [!] returns a _promise_ which is synchronized internally by recorder
465
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
466
466
 
467
467
 
468
468
  This action supports [React locators](https://codecept.io/react#locators)
@@ -481,7 +481,7 @@ I.dontSeeCheckboxIsChecked('agree'); // located by name
481
481
  #### Parameters
482
482
 
483
483
  - `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
484
- [!] returns a _promise_ which is synchronized internally by recorder
484
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
485
485
 
486
486
  ### dontSeeCookie
487
487
 
@@ -494,7 +494,7 @@ I.dontSeeCookie('auth'); // no auth cookie
494
494
  #### Parameters
495
495
 
496
496
  - `name` **[string][6]** cookie name.
497
- [!] returns a _promise_ which is synchronized internally by recorder
497
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
498
498
 
499
499
  ### dontSeeCurrentUrlEquals
500
500
 
@@ -509,7 +509,7 @@ I.dontSeeCurrentUrlEquals('http://mysite.com/login'); // absolute urls are also
509
509
  #### Parameters
510
510
 
511
511
  - `url` **[string][6]** value to check.
512
- [!] returns a _promise_ which is synchronized internally by recorder
512
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
513
513
 
514
514
  ### dontSeeElement
515
515
 
@@ -522,8 +522,7 @@ I.dontSeeElement('.modal'); // modal is not shown
522
522
  #### Parameters
523
523
 
524
524
  - `locator` **([string][6] | [object][4])** located by CSS|XPath|Strict locator.
525
- [!] returns a _promise_ which is synchronized internally by recorder
526
-
525
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
527
526
 
528
527
 
529
528
  This action supports [React locators](https://codecept.io/react#locators)
@@ -540,7 +539,7 @@ I.dontSeeElementInDOM('.nav'); // checks that element is not on page visible or
540
539
  #### Parameters
541
540
 
542
541
  - `locator` **([string][6] | [object][4])** located by CSS|XPath|Strict locator.
543
- [!] returns a _promise_ which is synchronized internally by recorder
542
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
544
543
 
545
544
  ### dontSeeInCurrentUrl
546
545
 
@@ -549,7 +548,7 @@ Checks that current url does not contain a provided fragment.
549
548
  #### Parameters
550
549
 
551
550
  - `url` **[string][6]** value to check.
552
- [!] returns a _promise_ which is synchronized internally by recorder
551
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
553
552
 
554
553
  ### dontSeeInField
555
554
 
@@ -565,7 +564,7 @@ I.dontSeeInField({ css: 'form input.email' }, 'user@user.com'); // field by CSS
565
564
 
566
565
  - `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
567
566
  - `value` **[string][6]** value to check.
568
- [!] returns a _promise_ which is synchronized internally by recorder
567
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
569
568
 
570
569
  ### dontSeeInSource
571
570
 
@@ -579,7 +578,7 @@ I.dontSeeInSource('<!--'); // no comments in source
579
578
 
580
579
  - `text`
581
580
  - `value` **[string][6]** to check.
582
- [!] returns a _promise_ which is synchronized internally by recorder
581
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
583
582
 
584
583
  ### dontSeeInTitle
585
584
 
@@ -592,7 +591,7 @@ I.dontSeeInTitle('Error');
592
591
  #### Parameters
593
592
 
594
593
  - `text` **[string][6]** value to check.
595
- [!] returns a _promise_ which is synchronized internally by recorder
594
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
596
595
 
597
596
  ### doubleClick
598
597
 
@@ -610,7 +609,7 @@ I.doubleClick('.btn.edit');
610
609
 
611
610
  - `locator` **([string][6] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
612
611
  - `context` **([string][6]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
613
- [!] returns a _promise_ which is synchronized internally by recorder
612
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
614
613
 
615
614
 
616
615
  This action supports [React locators](https://codecept.io/react#locators)
@@ -639,7 +638,7 @@ I.dragAndDrop('#dragHandle', '#container');
639
638
 
640
639
  - `srcElement` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
641
640
  - `destElement` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
642
- [!] returns a _promise_ which is synchronized internally by recorder
641
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
643
642
 
644
643
  ### dragSlider
645
644
 
@@ -655,8 +654,7 @@ I.dragSlider('#slider', -70);
655
654
 
656
655
  - `locator` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
657
656
  - `offsetX` **[number][8]** position to drag.
658
- [!] returns a _promise_ which is synchronized internally by recorder
659
-
657
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
660
658
 
661
659
 
662
660
  This action supports [React locators](https://codecept.io/react#locators)
@@ -688,7 +686,7 @@ let val = await I.executeAsyncScript(function(url, done) {
688
686
  #### Parameters
689
687
 
690
688
  - `args` **...any** to be passed to function.
691
- [!] returns a _promise_ which is synchronized internally by recorderAsynchronous scripts can also be executed with `executeScript` if a function returns a Promise.
689
+ ⚠️ returns a _promise_ which is synchronized internally by recorderAsynchronous scripts can also be executed with `executeScript` if a function returns a Promise.
692
690
  - `fn` **([string][6] | [function][10])** function to be executed in browser context.
693
691
 
694
692
  ### executeScript
@@ -720,7 +718,7 @@ let date = await I.executeScript(function(el) {
720
718
  #### Parameters
721
719
 
722
720
  - `args` **...any** to be passed to function.
723
- [!] returns a _promise_ which is synchronized internally by recorderIf a function returns a Promise It will wait for it resolution.
721
+ ⚠️ returns a _promise_ which is synchronized internally by recorderIf a function returns a Promise It will wait for it resolution.
724
722
  - `fn` **([string][6] | [function][10])** function to be executed in browser context.
725
723
 
726
724
  ### fillField
@@ -743,8 +741,7 @@ I.fillField({css: 'form#login input[name=username]'}, 'John');
743
741
 
744
742
  - `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
745
743
  - `value` **([string][6] | [object][4])** text value to fill.
746
- [!] returns a _promise_ which is synchronized internally by recorder
747
-
744
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
748
745
 
749
746
 
750
747
  This action supports [React locators](https://codecept.io/react#locators)
@@ -781,7 +778,7 @@ I.forceClick({css: 'nav a.login'});
781
778
 
782
779
  - `locator` **([string][6] | [object][4])** clickable link or button located by text, or any element located by CSS|XPath|strict locator.
783
780
  - `context` **([string][6]? | [object][4])** (optional, `null` by default) element to search in CSS|XPath|Strict locator.
784
- [!] returns a _promise_ which is synchronized internally by recorder
781
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
785
782
 
786
783
 
787
784
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1188,8 +1185,7 @@ I.moveCursorTo('#submit', 5,5);
1188
1185
  - `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
1189
1186
  - `offsetX` **[number][8]** (optional, `0` by default) X-axis offset.
1190
1187
  - `offsetY` **[number][8]** (optional, `0` by default) Y-axis offset.
1191
- [!] returns a _promise_ which is synchronized internally by recorder
1192
-
1188
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1193
1189
 
1194
1190
 
1195
1191
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1267,7 +1263,7 @@ Some of the supported key names are:
1267
1263
  #### Parameters
1268
1264
 
1269
1265
  - `key` **([string][6] | [Array][12]&lt;[string][6]>)** key or array of keys to press.
1270
- [!] returns a _promise_ which is synchronized internally by recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313][15]).
1266
+ ⚠️ returns a _promise_ which is synchronized internally by recorder_Note:_ Shortcuts like `'Meta'` + `'A'` do not work on macOS ([GoogleChrome/puppeteer#1313][15]).
1271
1267
 
1272
1268
  ### pressKeyDown
1273
1269
 
@@ -1284,7 +1280,7 @@ I.pressKeyUp('Control');
1284
1280
  #### Parameters
1285
1281
 
1286
1282
  - `key` **[string][6]** name of key to press down.
1287
- [!] returns a _promise_ which is synchronized internally by recorder
1283
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1288
1284
 
1289
1285
  ### pressKeyUp
1290
1286
 
@@ -1301,7 +1297,7 @@ I.pressKeyUp('Control');
1301
1297
  #### Parameters
1302
1298
 
1303
1299
  - `key` **[string][6]** name of key to release.
1304
- [!] returns a _promise_ which is synchronized internally by recorder
1300
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1305
1301
 
1306
1302
  ### refreshPage
1307
1303
 
@@ -1311,7 +1307,7 @@ Reload the current page.
1311
1307
  I.refreshPage();
1312
1308
  ```
1313
1309
 
1314
- [!] returns a _promise_ which is synchronized internally by recorder
1310
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1315
1311
 
1316
1312
  ### resizeWindow
1317
1313
 
@@ -1322,7 +1318,7 @@ First parameter can be set to `maximize`.
1322
1318
 
1323
1319
  - `width` **[number][8]** width in pixels or `maximize`.
1324
1320
  - `height` **[number][8]** height in pixels.
1325
- [!] returns a _promise_ which is synchronized internally by recorderUnlike other drivers Puppeteer changes the size of a viewport, not the window!
1321
+ ⚠️ returns a _promise_ which is synchronized internally by recorderUnlike other drivers Puppeteer changes the size of a viewport, not the window!
1326
1322
  Puppeteer does not control the window of a browser so it can't adjust its real size.
1327
1323
  It also can't maximize a window.
1328
1324
 
@@ -1343,7 +1339,7 @@ I.rightClick('Click me', '.context');
1343
1339
 
1344
1340
  - `locator` **([string][6] | [object][4])** clickable element located by CSS|XPath|strict locator.
1345
1341
  - `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS|XPath|strict locator.
1346
- [!] returns a _promise_ which is synchronized internally by recorder
1342
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1347
1343
 
1348
1344
 
1349
1345
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1351,7 +1347,7 @@ This action supports [React locators](https://codecept.io/react#locators)
1351
1347
 
1352
1348
  ### saveElementScreenshot
1353
1349
 
1354
- Saves screenshot of the specified locator to ouput folder (set in codecept.json or codecept.conf.js).
1350
+ Saves screenshot of the specified locator to ouput folder (set in codecept.conf.ts or codecept.conf.js).
1355
1351
  Filename is relative to output folder.
1356
1352
 
1357
1353
  ```js
@@ -1362,11 +1358,11 @@ I.saveElementScreenshot(`#submit`,'debug.png');
1362
1358
 
1363
1359
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1364
1360
  - `fileName` **[string][6]** file name to save.
1365
- [!] returns a _promise_ which is synchronized internally by recorder
1361
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1366
1362
 
1367
1363
  ### saveScreenshot
1368
1364
 
1369
- Saves a screenshot to ouput folder (set in codecept.json or codecept.conf.js).
1365
+ Saves a screenshot to ouput folder (set in codecept.conf.ts or codecept.conf.js).
1370
1366
  Filename is relative to output folder.
1371
1367
  Optionally resize the window to the full available page `scrollHeight` and `scrollWidth` to capture the entire page by passing `true` in as the second argument.
1372
1368
 
@@ -1379,7 +1375,7 @@ I.saveScreenshot('debug.png', true) //resizes to available scrollHeight and scro
1379
1375
 
1380
1376
  - `fileName` **[string][6]** file name to save.
1381
1377
  - `fullPage` **[boolean][17]** (optional, `false` by default) flag to enable fullscreen screenshot mode.
1382
- [!] returns a _promise_ which is synchronized internally by recorder
1378
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1383
1379
 
1384
1380
  ### scrollPageToBottom
1385
1381
 
@@ -1389,7 +1385,7 @@ Scroll page to the bottom.
1389
1385
  I.scrollPageToBottom();
1390
1386
  ```
1391
1387
 
1392
- [!] returns a _promise_ which is synchronized internally by recorder
1388
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1393
1389
 
1394
1390
  ### scrollPageToTop
1395
1391
 
@@ -1399,7 +1395,7 @@ Scroll page to the top.
1399
1395
  I.scrollPageToTop();
1400
1396
  ```
1401
1397
 
1402
- [!] returns a _promise_ which is synchronized internally by recorder
1398
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1403
1399
 
1404
1400
  ### scrollTo
1405
1401
 
@@ -1416,7 +1412,7 @@ I.scrollTo('#submit', 5, 5);
1416
1412
  - `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
1417
1413
  - `offsetX` **[number][8]** (optional, `0` by default) X-axis offset.
1418
1414
  - `offsetY` **[number][8]** (optional, `0` by default) Y-axis offset.
1419
- [!] returns a _promise_ which is synchronized internally by recorder
1415
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1420
1416
 
1421
1417
  ### see
1422
1418
 
@@ -1433,7 +1429,7 @@ I.see('Register', {css: 'form.register'}); // use strict locator
1433
1429
 
1434
1430
  - `text` **[string][6]** expected on page.
1435
1431
  - `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS|Xpath|strict locator in which to search for text.
1436
- [!] returns a _promise_ which is synchronized internally by recorder
1432
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1437
1433
 
1438
1434
 
1439
1435
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1451,8 +1447,7 @@ I.seeAttributesOnElements('//form', { method: "post"});
1451
1447
 
1452
1448
  - `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
1453
1449
  - `attributes` **[object][4]** attributes and their values to check.
1454
- [!] returns a _promise_ which is synchronized internally by recorder
1455
-
1450
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1456
1451
 
1457
1452
 
1458
1453
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1471,7 +1466,7 @@ I.seeCheckboxIsChecked({css: '#signup_form input[type=checkbox]'});
1471
1466
  #### Parameters
1472
1467
 
1473
1468
  - `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
1474
- [!] returns a _promise_ which is synchronized internally by recorder
1469
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1475
1470
 
1476
1471
  ### seeCookie
1477
1472
 
@@ -1484,7 +1479,7 @@ I.seeCookie('Auth');
1484
1479
  #### Parameters
1485
1480
 
1486
1481
  - `name` **[string][6]** cookie name.
1487
- [!] returns a _promise_ which is synchronized internally by recorder
1482
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1488
1483
 
1489
1484
  ### seeCssPropertiesOnElements
1490
1485
 
@@ -1498,8 +1493,7 @@ I.seeCssPropertiesOnElements('h3', { 'font-weight': "bold"});
1498
1493
 
1499
1494
  - `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
1500
1495
  - `cssProperties` **[object][4]** object with CSS properties and their values to check.
1501
- [!] returns a _promise_ which is synchronized internally by recorder
1502
-
1496
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1503
1497
 
1504
1498
 
1505
1499
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1519,7 +1513,7 @@ I.seeCurrentUrlEquals('http://my.site.com/register');
1519
1513
  #### Parameters
1520
1514
 
1521
1515
  - `url` **[string][6]** value to check.
1522
- [!] returns a _promise_ which is synchronized internally by recorder
1516
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1523
1517
 
1524
1518
  ### seeElement
1525
1519
 
@@ -1533,8 +1527,7 @@ I.seeElement('#modal');
1533
1527
  #### Parameters
1534
1528
 
1535
1529
  - `locator` **([string][6] | [object][4])** located by CSS|XPath|strict locator.
1536
- [!] returns a _promise_ which is synchronized internally by recorder
1537
-
1530
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1538
1531
 
1539
1532
 
1540
1533
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1552,7 +1545,7 @@ I.seeElementInDOM('#modal');
1552
1545
  #### Parameters
1553
1546
 
1554
1547
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1555
- [!] returns a _promise_ which is synchronized internally by recorder
1548
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1556
1549
 
1557
1550
  ### seeInCurrentUrl
1558
1551
 
@@ -1565,7 +1558,7 @@ I.seeInCurrentUrl('/register'); // we are on registration page
1565
1558
  #### Parameters
1566
1559
 
1567
1560
  - `url` **[string][6]** a fragment to check
1568
- [!] returns a _promise_ which is synchronized internally by recorder
1561
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1569
1562
 
1570
1563
  ### seeInField
1571
1564
 
@@ -1583,7 +1576,7 @@ I.seeInField('#searchform input','Search');
1583
1576
 
1584
1577
  - `field` **([string][6] | [object][4])** located by label|name|CSS|XPath|strict locator.
1585
1578
  - `value` **[string][6]** value to check.
1586
- [!] returns a _promise_ which is synchronized internally by recorder
1579
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1587
1580
 
1588
1581
  ### seeInPopup
1589
1582
 
@@ -1597,7 +1590,7 @@ I.seeInPopup('Popup text');
1597
1590
  #### Parameters
1598
1591
 
1599
1592
  - `text` **[string][6]** value to check.
1600
- [!] returns a _promise_ which is synchronized internally by recorder
1593
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1601
1594
 
1602
1595
  ### seeInSource
1603
1596
 
@@ -1610,7 +1603,7 @@ I.seeInSource('<h1>Green eggs &amp; ham</h1>');
1610
1603
  #### Parameters
1611
1604
 
1612
1605
  - `text` **[string][6]** value to check.
1613
- [!] returns a _promise_ which is synchronized internally by recorder
1606
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1614
1607
 
1615
1608
  ### seeInTitle
1616
1609
 
@@ -1623,7 +1616,7 @@ I.seeInTitle('Home Page');
1623
1616
  #### Parameters
1624
1617
 
1625
1618
  - `text` **[string][6]** text value to check.
1626
- [!] returns a _promise_ which is synchronized internally by recorder
1619
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1627
1620
 
1628
1621
  ### seeNumberOfElements
1629
1622
 
@@ -1638,7 +1631,7 @@ I.seeNumberOfElements('#submitBtn', 1);
1638
1631
 
1639
1632
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1640
1633
  - `num` **[number][8]** number of elements.
1641
- [!] returns a _promise_ which is synchronized internally by recorder
1634
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1642
1635
 
1643
1636
 
1644
1637
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1657,7 +1650,7 @@ I.seeNumberOfVisibleElements('.buttons', 3);
1657
1650
 
1658
1651
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1659
1652
  - `num` **[number][8]** number of elements.
1660
- [!] returns a _promise_ which is synchronized internally by recorder
1653
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1661
1654
 
1662
1655
 
1663
1656
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1675,7 +1668,7 @@ I.seeTextEquals('text', 'h1');
1675
1668
 
1676
1669
  - `text` **[string][6]** element value to check.
1677
1670
  - `context` **([string][6] | [object][4])?** element located by CSS|XPath|strict locator.
1678
- [!] returns a _promise_ which is synchronized internally by recorder
1671
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1679
1672
 
1680
1673
  ### seeTitleEquals
1681
1674
 
@@ -1688,7 +1681,7 @@ I.seeTitleEquals('Test title.');
1688
1681
  #### Parameters
1689
1682
 
1690
1683
  - `text` **[string][6]** value to check.
1691
- [!] returns a _promise_ which is synchronized internally by recorder
1684
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1692
1685
 
1693
1686
  ### selectOption
1694
1687
 
@@ -1715,7 +1708,7 @@ I.selectOption('Which OS do you use?', ['Android', 'iOS']);
1715
1708
 
1716
1709
  - `select` **([string][6] | [object][4])** field located by label|name|CSS|XPath|strict locator.
1717
1710
  - `option` **([string][6] | [Array][12]&lt;any>)** visible text or value of option.
1718
- [!] returns a _promise_ which is synchronized internally by recorder
1711
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1719
1712
 
1720
1713
  ### setCookie
1721
1714
 
@@ -1736,7 +1729,7 @@ I.setCookie([
1736
1729
  #### Parameters
1737
1730
 
1738
1731
  - `cookie` **(Cookie | [Array][12]&lt;Cookie>)** a cookie object or array of cookie objects.
1739
- [!] returns a _promise_ which is synchronized internally by recorder
1732
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1740
1733
 
1741
1734
  ### switchTo
1742
1735
 
@@ -1750,7 +1743,7 @@ I.switchTo(); // switch back to main page
1750
1743
  #### Parameters
1751
1744
 
1752
1745
  - `locator` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS|XPath|strict locator.
1753
- [!] returns a _promise_ which is synchronized internally by recorder
1746
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1754
1747
 
1755
1748
  ### switchToNextTab
1756
1749
 
@@ -1799,7 +1792,7 @@ I.type(['T', 'E', 'X', 'T']);
1799
1792
 
1800
1793
  - `keys`
1801
1794
  - `delay` **[number][8]?** (optional) delay in ms between key presses
1802
- [!] returns a _promise_ which is synchronized internally by recorder
1795
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1803
1796
  - `key` **([string][6] | [Array][12]&lt;[string][6]>)** or array of keys to type.
1804
1797
 
1805
1798
  ### uncheckOption
@@ -1819,7 +1812,7 @@ I.uncheckOption('agree', '//form');
1819
1812
 
1820
1813
  - `field` **([string][6] | [object][4])** checkbox located by label | name | CSS | XPath | strict locator.
1821
1814
  - `context` **([string][6]? | [object][4])** (optional, `null` by default) element located by CSS | XPath | strict locator.
1822
- [!] returns a _promise_ which is synchronized internally by recorder
1815
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1823
1816
 
1824
1817
  ### usePuppeteerTo
1825
1818
 
@@ -1852,7 +1845,7 @@ I.wait(2); // wait 2 secs
1852
1845
  #### Parameters
1853
1846
 
1854
1847
  - `sec` **[number][8]** number of second to wait.
1855
- [!] returns a _promise_ which is synchronized internally by recorder
1848
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1856
1849
 
1857
1850
  ### waitForClickable
1858
1851
 
@@ -1869,7 +1862,7 @@ I.waitForClickable('.btn.continue', 5); // wait for 5 secs
1869
1862
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1870
1863
  - `waitTimeout`
1871
1864
  - `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait
1872
- [!] returns a _promise_ which is synchronized internally by recorder
1865
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1873
1866
 
1874
1867
  ### waitForDetached
1875
1868
 
@@ -1884,7 +1877,7 @@ I.waitForDetached('#popup');
1884
1877
 
1885
1878
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1886
1879
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
1887
- [!] returns a _promise_ which is synchronized internally by recorder
1880
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1888
1881
 
1889
1882
  ### waitForElement
1890
1883
 
@@ -1900,8 +1893,7 @@ I.waitForElement('.btn.continue', 5); // wait for 5 secs
1900
1893
 
1901
1894
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1902
1895
  - `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait
1903
- [!] returns a _promise_ which is synchronized internally by recorder
1904
-
1896
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1905
1897
 
1906
1898
 
1907
1899
  This action supports [React locators](https://codecept.io/react#locators)
@@ -1916,7 +1908,7 @@ Element can be located by CSS or XPath.
1916
1908
 
1917
1909
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1918
1910
  - `sec` **[number][8]** (optional) time in seconds to wait, 1 by default.
1919
- [!] returns a _promise_ which is synchronized internally by recorder
1911
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1920
1912
 
1921
1913
  ### waitForFunction
1922
1914
 
@@ -1938,7 +1930,7 @@ I.waitForFunction((count) => window.requests == count, [3], 5) // pass args and
1938
1930
  - `fn` **([string][6] | [function][10])** to be executed in browser context.
1939
1931
  - `argsOrSec` **([Array][12]&lt;any> | [number][8])?** (optional, `1` by default) arguments for function or seconds.
1940
1932
  - `sec` **[number][8]?** (optional, `1` by default) time in seconds to wait
1941
- [!] returns a _promise_ which is synchronized internally by recorder
1933
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1942
1934
 
1943
1935
  ### waitForInvisible
1944
1936
 
@@ -1953,7 +1945,7 @@ I.waitForInvisible('#popup');
1953
1945
 
1954
1946
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
1955
1947
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
1956
- [!] returns a _promise_ which is synchronized internally by recorder
1948
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
1957
1949
 
1958
1950
  ### waitForNavigation
1959
1951
 
@@ -2009,7 +2001,7 @@ I.waitForText('Thank you, form has been submitted', 5, '#modal');
2009
2001
  - `text` **[string][6]** to wait for.
2010
2002
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
2011
2003
  - `context` **([string][6] | [object][4])?** (optional) element located by CSS|XPath|strict locator.
2012
- [!] returns a _promise_ which is synchronized internally by recorder
2004
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
2013
2005
 
2014
2006
  ### waitForValue
2015
2007
 
@@ -2024,7 +2016,7 @@ I.waitForValue('//input', "GoodValue");
2024
2016
  - `field` **([string][6] | [object][4])** input field.
2025
2017
  - `value` **[string][6]** expected value.
2026
2018
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
2027
- [!] returns a _promise_ which is synchronized internally by recorder
2019
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
2028
2020
 
2029
2021
  ### waitForVisible
2030
2022
 
@@ -2039,7 +2031,7 @@ I.waitForVisible('#popup');
2039
2031
 
2040
2032
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
2041
2033
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
2042
- [!] returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][21].
2034
+ ⚠️ returns a _promise_ which is synchronized internally by recorderThis method accepts [React selectors][21].
2043
2035
 
2044
2036
  ### waitInUrl
2045
2037
 
@@ -2053,7 +2045,7 @@ I.waitInUrl('/info', 2);
2053
2045
 
2054
2046
  - `urlPart` **[string][6]** value to check.
2055
2047
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
2056
- [!] returns a _promise_ which is synchronized internally by recorder
2048
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
2057
2049
 
2058
2050
  ### waitNumberOfVisibleElements
2059
2051
 
@@ -2068,8 +2060,7 @@ I.waitNumberOfVisibleElements('a', 3);
2068
2060
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
2069
2061
  - `num` **[number][8]** number of elements.
2070
2062
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
2071
- [!] returns a _promise_ which is synchronized internally by recorder
2072
-
2063
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
2073
2064
 
2074
2065
 
2075
2066
  This action supports [React locators](https://codecept.io/react#locators)
@@ -2088,7 +2079,7 @@ I.waitToHide('#popup');
2088
2079
 
2089
2080
  - `locator` **([string][6] | [object][4])** element located by CSS|XPath|strict locator.
2090
2081
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
2091
- [!] returns a _promise_ which is synchronized internally by recorder
2082
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
2092
2083
 
2093
2084
  ### waitUrlEquals
2094
2085
 
@@ -2103,7 +2094,7 @@ I.waitUrlEquals('http://127.0.0.1:8000/info');
2103
2094
 
2104
2095
  - `urlPart` **[string][6]** value to check.
2105
2096
  - `sec` **[number][8]** (optional, `1` by default) time in seconds to wait
2106
- [!] returns a _promise_ which is synchronized internally by recorder
2097
+ ⚠️ returns a _promise_ which is synchronized internally by recorder
2107
2098
 
2108
2099
  : https://github.com/GoogleChrome/puppeteer
2109
2100
 
@@ -22,7 +22,7 @@ Type: [object][4]
22
22
 
23
23
  ### Properties
24
24
 
25
- - `endpoint` **[string][3]** API base URL
25
+ - `endpoint` **[string][3]?** API base URL
26
26
  - `prettyPrintJson` **[boolean][6]?** pretty print json for response/request on console logs
27
27
  - `timeout` **[number][5]?** timeout for requests in milliseconds. 10000ms by default
28
28
  - `defaultHeaders` **[object][4]?** a list of default headers