codeceptjs 3.5.7 → 3.5.9-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 (108) hide show
  1. package/README.md +1 -1
  2. package/docs/build/Appium.js +27 -22
  3. package/docs/build/Nightmare.js +51 -52
  4. package/docs/build/Playwright.js +75 -75
  5. package/docs/build/Protractor.js +64 -65
  6. package/docs/build/Puppeteer.js +74 -75
  7. package/docs/build/TestCafe.js +54 -55
  8. package/docs/build/WebDriver.js +79 -80
  9. package/docs/changelog.md +1 -562
  10. package/docs/community-helpers.md +4 -8
  11. package/docs/examples.md +2 -8
  12. package/docs/helpers/Appium.md +85 -83
  13. package/docs/helpers/Nightmare.md +75 -77
  14. package/docs/helpers/Playwright.md +175 -177
  15. package/docs/helpers/Protractor.md +153 -155
  16. package/docs/helpers/Puppeteer.md +146 -148
  17. package/docs/helpers/TestCafe.md +124 -126
  18. package/docs/helpers/WebDriver.md +155 -157
  19. package/docs/webapi/amOnPage.mustache +1 -1
  20. package/docs/webapi/appendField.mustache +1 -1
  21. package/docs/webapi/attachFile.mustache +1 -1
  22. package/docs/webapi/blur.mustache +1 -1
  23. package/docs/webapi/checkOption.mustache +1 -1
  24. package/docs/webapi/clearCookie.mustache +1 -2
  25. package/docs/webapi/clearField.mustache +1 -1
  26. package/docs/webapi/click.mustache +1 -1
  27. package/docs/webapi/clickLink.mustache +1 -1
  28. package/docs/webapi/closeCurrentTab.mustache +1 -1
  29. package/docs/webapi/closeOtherTabs.mustache +1 -1
  30. package/docs/webapi/dontSee.mustache +1 -1
  31. package/docs/webapi/dontSeeCheckboxIsChecked.mustache +1 -1
  32. package/docs/webapi/dontSeeCookie.mustache +1 -1
  33. package/docs/webapi/dontSeeCurrentUrlEquals.mustache +1 -1
  34. package/docs/webapi/dontSeeElement.mustache +1 -1
  35. package/docs/webapi/dontSeeElementInDOM.mustache +1 -1
  36. package/docs/webapi/dontSeeInCurrentUrl.mustache +1 -1
  37. package/docs/webapi/dontSeeInField.mustache +1 -1
  38. package/docs/webapi/dontSeeInSource.mustache +1 -1
  39. package/docs/webapi/dontSeeInTitle.mustache +1 -1
  40. package/docs/webapi/doubleClick.mustache +1 -1
  41. package/docs/webapi/downloadFile.mustache +1 -1
  42. package/docs/webapi/dragAndDrop.mustache +1 -1
  43. package/docs/webapi/dragSlider.mustache +1 -1
  44. package/docs/webapi/fillField.mustache +1 -1
  45. package/docs/webapi/focus.mustache +1 -1
  46. package/docs/webapi/forceClick.mustache +1 -1
  47. package/docs/webapi/forceRightClick.mustache +1 -1
  48. package/docs/webapi/grabDataFromPerformanceTiming.mustache +1 -1
  49. package/docs/webapi/moveCursorTo.mustache +1 -1
  50. package/docs/webapi/openNewTab.mustache +1 -1
  51. package/docs/webapi/pressKey.mustache +1 -1
  52. package/docs/webapi/pressKeyDown.mustache +1 -1
  53. package/docs/webapi/pressKeyUp.mustache +1 -1
  54. package/docs/webapi/pressKeyWithKeyNormalization.mustache +1 -1
  55. package/docs/webapi/refreshPage.mustache +1 -1
  56. package/docs/webapi/resizeWindow.mustache +1 -1
  57. package/docs/webapi/rightClick.mustache +1 -1
  58. package/docs/webapi/saveElementScreenshot.mustache +1 -1
  59. package/docs/webapi/saveScreenshot.mustache +1 -1
  60. package/docs/webapi/say.mustache +1 -1
  61. package/docs/webapi/scrollIntoView.mustache +1 -1
  62. package/docs/webapi/scrollPageToBottom.mustache +1 -1
  63. package/docs/webapi/scrollPageToTop.mustache +1 -1
  64. package/docs/webapi/scrollTo.mustache +1 -1
  65. package/docs/webapi/see.mustache +1 -1
  66. package/docs/webapi/seeAttributesOnElements.mustache +1 -1
  67. package/docs/webapi/seeCheckboxIsChecked.mustache +1 -1
  68. package/docs/webapi/seeCookie.mustache +1 -1
  69. package/docs/webapi/seeCssPropertiesOnElements.mustache +1 -1
  70. package/docs/webapi/seeCurrentUrlEquals.mustache +1 -1
  71. package/docs/webapi/seeElement.mustache +1 -1
  72. package/docs/webapi/seeElementInDOM.mustache +1 -1
  73. package/docs/webapi/seeInCurrentUrl.mustache +1 -1
  74. package/docs/webapi/seeInField.mustache +1 -1
  75. package/docs/webapi/seeInPopup.mustache +1 -1
  76. package/docs/webapi/seeInSource.mustache +1 -1
  77. package/docs/webapi/seeInTitle.mustache +1 -1
  78. package/docs/webapi/seeNumberOfElements.mustache +1 -1
  79. package/docs/webapi/seeNumberOfVisibleElements.mustache +1 -1
  80. package/docs/webapi/seeTextEquals.mustache +1 -1
  81. package/docs/webapi/seeTitleEquals.mustache +1 -1
  82. package/docs/webapi/selectOption.mustache +1 -1
  83. package/docs/webapi/setCookie.mustache +1 -1
  84. package/docs/webapi/setGeoLocation.mustache +1 -1
  85. package/docs/webapi/switchTo.mustache +1 -1
  86. package/docs/webapi/switchToNextTab.mustache +1 -1
  87. package/docs/webapi/switchToPreviousTab.mustache +1 -1
  88. package/docs/webapi/type.mustache +1 -1
  89. package/docs/webapi/uncheckOption.mustache +1 -1
  90. package/docs/webapi/wait.mustache +1 -1
  91. package/docs/webapi/waitForClickable.mustache +1 -1
  92. package/docs/webapi/waitForDetached.mustache +1 -1
  93. package/docs/webapi/waitForElement.mustache +1 -1
  94. package/docs/webapi/waitForEnabled.mustache +1 -1
  95. package/docs/webapi/waitForFunction.mustache +1 -1
  96. package/docs/webapi/waitForInvisible.mustache +1 -1
  97. package/docs/webapi/waitForText.mustache +1 -1
  98. package/docs/webapi/waitForValue.mustache +1 -1
  99. package/docs/webapi/waitForVisible.mustache +1 -1
  100. package/docs/webapi/waitInUrl.mustache +1 -1
  101. package/docs/webapi/waitNumberOfVisibleElements.mustache +1 -1
  102. package/docs/webapi/waitToHide.mustache +1 -1
  103. package/docs/webapi/waitUrlEquals.mustache +1 -1
  104. package/lib/helper/Appium.js +9 -4
  105. package/lib/helper/Playwright.js +3 -2
  106. package/package.json +5 -5
  107. package/typings/promiseBasedTypes.d.ts +423 -1010
  108. package/typings/types.d.ts +423 -427
package/docs/changelog.md CHANGED
@@ -7,572 +7,11 @@ layout: Section
7
7
 
8
8
  # Releases
9
9
 
10
- ## 3.5.7
11
-
12
- Thanks all to those who contributed to make this release!
13
-
14
- 🐛 *Bug Fixes*
15
- * Bump playwright to 1.39.0 - run `npx playwright install` to install the browsers as starting from 1.39.0 browsers are not installed automatically ([#3924](https://github.com/codeceptjs/CodeceptJS/issues/3924)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
16
- * fix(playwright): some wait functions draw error due to switchTo iframe ([#3918](https://github.com/codeceptjs/CodeceptJS/issues/3918)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
17
- * fix(appium): AppiumTestDistribution/appium-device-farm requires 'platformName' ([#3950](https://github.com/codeceptjs/CodeceptJS/issues/3950)) - by **[rock-tran](https://github.com/rock-tran)**
18
- * fix: autologin with empty fetch ([#3947](https://github.com/codeceptjs/CodeceptJS/issues/3947)) - by **[andonary](https://github.com/andonary)**
19
- * fix(cli): customLocator draws error in dry-mode ([#3940](https://github.com/codeceptjs/CodeceptJS/issues/3940)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
20
- * fix: ensure docs include **[returns](https://github.com/returns)** Promise<void> where appropriate ([#3954](https://github.com/codeceptjs/CodeceptJS/issues/3954)) - by **[fwouts](https://github.com/fwouts)**
21
- * fix: long text in data table cuts off ([#3936](https://github.com/codeceptjs/CodeceptJS/issues/3936)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
22
- ```
23
- #language: de
24
- Funktionalität: Faker examples
25
-
26
- Szenariogrundriss: Atualizar senha do usuÃĄrio
27
- Angenommen que estou logado via REST com o usuÃĄrio "<customer>"
28
- | protocol | https: |
29
- | hostname | https://cucumber.io/docs/gherkin/languages/ |
30
-
31
-
32
- Faker examples --
33
- Atualizar senha do usuÃĄrio {"product":"{{vehicle.vehicle}}","customer":"Dr. {{name.findName}}","price":"{{commerce.price}}","cashier":"cashier 2"}
34
- On Angenommen: que estou logado via rest com o usuÃĄrio "dr. {{name.find name}}"
35
- protocol | https:
36
- hostname | https://cucumber.io/docs/gherkin/languages/
37
-
38
- Dr. {{name.findName}}
39
- ✔ OK in 13ms
40
-
41
- ```
42
- * fix(playwright): move to waitFor ([#3933](https://github.com/codeceptjs/CodeceptJS/issues/3933)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
43
- * fix: relax grabCookie type ([#3919](https://github.com/codeceptjs/CodeceptJS/issues/3919)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
44
- * fix: proceedSee error when being called inside within ([#3939](https://github.com/codeceptjs/CodeceptJS/issues/3939)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
45
- * fix: rename haveRequestHeaders of ppt and pw helpers ([#3937](https://github.com/codeceptjs/CodeceptJS/issues/3937)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
46
- ```
47
- Renamed haveRequestHeaders of Puppeteer, Playwright helper so that it would not confuse the REST helper.
48
- Puppeteer: setPuppeteerRequestHeaders
49
- Playwright: setPlaywrightRequestHeaders
50
- ```
51
- * improvement: handle the way to load apifactory nicely ([#3941](https://github.com/codeceptjs/CodeceptJS/issues/3941)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
52
- ```
53
- With this fix, we could now use the following syntax:
54
-
55
- export = new Factory()
56
- .attr('name', () => faker.name.findName())
57
- .attr('job', () => 'leader');
58
-
59
- export default new Factory()
60
- .attr('name', () => faker.name.findName())
61
- .attr('job', () => 'leader');
62
-
63
- modules.export = new Factory()
64
- .attr('name', () => faker.name.findName())
65
- .attr('job', () => 'leader');
66
- ```
67
-
68
- 📖 *Documentation*
69
- * docs(appium): update to v2 ([#3932](https://github.com/codeceptjs/CodeceptJS/issues/3932)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
70
- * docs: improve BDD Gherkin docs ([#3938](https://github.com/codeceptjs/CodeceptJS/issues/3938)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
71
- * Other docs improvements
72
-
73
- đŸ›Šī¸ *Features*
74
- * feat(puppeteer): support trace recording - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
75
- ```
76
- [Trace Recording Customization]
77
- Trace recording provides complete information on test execution and includes screenshots, and network requests logged during run. Traces will be saved to output/trace
78
-
79
- trace: enables trace recording for failed tests; trace are saved into output/trace folder
80
- keepTraceForPassedTests: - save trace for passed tests
81
- ```
82
- * feat: expect helper ([#3923](https://github.com/codeceptjs/CodeceptJS/issues/3923)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
83
- ```
84
- * This helper allows performing assertions based on Chai.
85
- *
86
- * ### Examples
87
- *
88
- * Zero-configuration when paired with other helpers like REST, Playwright:
89
- *
90
- * ```js
91
- * // inside codecept.conf.js
92
- *{
93
- * helpers: {
94
- * Playwright: {...},
95
- * ExpectHelper: {},
96
- * }
97
-
98
- Expect Helper
99
- #expectEqual
100
- #expectNotEqual
101
- #expectContain
102
- #expectNotContain
103
- #expectStartsWith
104
- #expectNotStartsWith
105
- #expectEndsWith
106
- #expectNotEndsWith
107
- #expectJsonSchema
108
- #expectHasProperty
109
- #expectHasAProperty
110
- #expectToBeA
111
- #expectToBeAn
112
- #expectMatchRegex
113
- #expectLengthOf
114
- #expectTrue
115
- #expectEmpty
116
- #expectFalse
117
- #expectAbove
118
- #expectBelow
119
- #expectLengthAboveThan
120
- #expectLengthBelowThan
121
- #expectLengthBelowThan
122
- #expectDeepMembers
123
- #expectDeepIncludeMembers
124
- #expectDeepEqualExcluding
125
- #expectLengthBelowThan
126
- ```
127
- * feat: run-workers with multiple browsers output folders - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
128
- - ![Screenshot 2023-11-04 at 10 49 56](https://github.com/codeceptjs/CodeceptJS/assets/7845001/8eaecc54-de14-4597-b148-1e087bec3c76)
129
- - ![Screenshot 2023-11-03 at 15 56 38](https://github.com/codeceptjs/CodeceptJS/assets/7845001/715aed17-3535-48df-80dd-84f7024f08e3)
130
- * feat: introduce new Playwright methods - by **[hatufacci](https://github.com/hatufacci)**
131
- ```
132
- - grabCheckedElementStatus
133
- - grabDisabledElementStatus
134
- ```
135
- * feat: gherkin supports i18n ([#3934](https://github.com/codeceptjs/CodeceptJS/issues/3934)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
136
- ```
137
- #language: de
138
- Funktionalität: Checkout-Prozess
139
- Um Produkte zu kaufen
140
- Als Kunde
141
- MÃļchte ich in der Lage sein, mehrere Produkte zu kaufen
142
-
143
- **[i18n](https://github.com/i18n)**
144
- Szenariogrundriss: Bestellrabatt
145
- Angenommen ich habe ein Produkt mit einem Preis von <price>$ in meinem Warenkorb
146
- Und der Rabatt fÃŧr Bestellungen Ãŧber $20 beträgt 10 %
147
- Wenn ich zur Kasse gehe
148
- Dann sollte ich den Gesamtpreis von "<total>" $ sehen
149
-
150
- Beispiele:
151
- | price | total |
152
- | 10 | 10.0 |
153
- ```
154
- * feat(autoLogin): improve the check method ([#3935](https://github.com/codeceptjs/CodeceptJS/issues/3935)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
155
- ```
156
- Instead of asserting on page elements for the current user in check, you can use the session you saved in fetch
157
-
158
- autoLogin: {
159
- enabled: true,
160
- saveToFile: true,
161
- inject: 'login',
162
- users: {
163
- admin: {
164
- login: async (I) => { // If you use async function in the autoLogin plugin
165
- const phrase = await I.grabTextFrom('#phrase')
166
- I.fillField('username', 'admin'),
167
- I.fillField('password', 'password')
168
- I.fillField('phrase', phrase)
169
- },
170
- check: (I, session) => {
171
- // Throwing an error in `check` will make CodeceptJS perform the login step for the user
172
- if (session.profile.email !== the.email.you.expect@some-mail.com) {
173
- throw new Error ('Wrong user signed in');
174
- }
175
- },
176
- }
177
- }
178
- }
179
- Scenario('login', async ( {I, login} ) => {
180
- await login('admin') // you should use `await`
181
- })
182
- ```
183
-
184
- ## 3.5.6
185
-
186
- Thanks all to those who contributed to make this release!
187
-
188
- 🐛 *Bug Fixes*
189
- * fix: switchTo/within block doesn't switch to expected iframe ([#3892](https://github.com/codeceptjs/CodeceptJS/issues/3892)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
190
- * fix: highlight element doesn't work as expected ([#3896](https://github.com/codeceptjs/CodeceptJS/issues/3896)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
191
- ```
192
- verbose/ highlight TRUE TRUE -> highlight element
193
- verbose/ highlight TRUE FALSE -> no highlight element
194
- verbose/ highlight FALSE TRUE -> no highlight element
195
- verbose/ highlight FALSE FALSE -> no highlight element
196
- ```
197
- * fix: masked value issue in data table ([#3885](https://github.com/codeceptjs/CodeceptJS/issues/3885)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
198
- ```
199
- const accounts = new DataTable(['role', 'username', 'password']);
200
- accounts.add([
201
- 'ROLE_A',
202
- process.env['FIRST_USERNAME'],
203
- secret(process.env['FIRST_PASSWORD']),
204
- ]);
205
- accounts.add([
206
- 'ROLE_B',
207
- process.env['SECOND_USERNAME'],
208
- secret(process.env['SECOND_PASSWORD']),
209
- ]);
210
-
211
- Data(accounts)
212
- .Scenario(
213
- 'ScenarioTitle',
214
- ({ I, pageObject, current }) => {
215
- I.say("Given I'am logged in");
216
- I.amOnPage('/');
217
- loginPage.**sendForm**(current.username, current.password);
218
- )
219
-
220
-
221
- // output
222
- The test feature --
223
- The scenario | {"username":"Username","password": ***}
224
- 'The real password: theLoggedPasswordInCleartext'
225
- I.fillField('somePasswordLocator', '****')
226
- ✔ OK in 7ms
227
-
228
- The scenario | {"username":"theSecondUsername","password": ***}
229
- 'The real password: theLoggedPasswordInCleartext'
230
- I.fillField('somePasswordLocator', '****')
231
- ✔ OK in 1ms
232
- ```
233
-
234
- * fix: debug info causes error ([#3882](https://github.com/codeceptjs/CodeceptJS/issues/3882)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
235
-
236
- 📖 *Documentation*
237
- * fix: get rid of complaining when using session without await and returning nothing. ([#3899](https://github.com/codeceptjs/CodeceptJS/issues/3899)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
238
- * fix(FileSystem): a typo in writeToFile() ([#3897](https://github.com/codeceptjs/CodeceptJS/issues/3897)) - by **[mirao](https://github.com/mirao)**
239
-
240
- đŸ›Šī¸ *Features*
241
- * feat(translation): add more french keywords and fix deprecated waitForClickable ([#3906](https://github.com/codeceptjs/CodeceptJS/issues/3906)) - by **[andonary](https://github.com/andonary)**
242
- ```
243
- - Add some french keywords for translation
244
- - I.waitForClickable has the same "attends" than I.wait. Using "attends" leads to use the deprecated waitForClickable. Fix it by using different words.
245
- ```
246
-
247
- ## 3.5.5
248
-
249
- 🐛 Bug Fixes
250
- * fix(browserstack): issue with vendor prefix ([#3845](https://github.com/codeceptjs/CodeceptJS/issues/3845)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
251
- ```
252
- export const caps = {
253
- androidCaps: {
254
- appiumV2: true,
255
- host: "hub-cloud.browserstack.com",
256
- port: 4444,
257
- user: process.env.BROWSERSTACK_USER,
258
- key: process.env.BROWSERSTACK_KEY,
259
- 'app': `bs://c700ce60cf13ae8ed97705a55b8e022f1hjhkjh3c5827c`,
260
- browser: '',
261
- desiredCapabilities: {
262
- 'appPackage': data.packageName,
263
- 'deviceName': process.env.DEVICE || 'Google Pixel 3',
264
- 'platformName': process.env.PLATFORM || 'android',
265
- 'platformVersion': process.env.OS_VERSION || '10.0',
266
- 'automationName': process.env.ENGINE || 'UIAutomator2',
267
- 'newCommandTimeout': 300000,
268
- 'androidDeviceReadyTimeout': 300000,
269
- 'androidInstallTimeout': 90000,
270
- 'appWaitDuration': 300000,
271
- 'autoGrantPermissions': true,
272
- 'gpsEnabled': true,
273
- 'isHeadless': false,
274
- 'noReset': false,
275
- 'noSign': true,
276
- 'bstack:options' : {
277
- "appiumVersion" : "2.0.1",
278
- },
279
- }
280
- },
281
- }
282
- ```
283
-
284
- * switchTo/within now supports strict locator ([#3847](https://github.com/codeceptjs/CodeceptJS/issues/3847)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
285
-
286
- ```
287
- I.switchTo({ css: 'iframe[id^=number-frame]' }) // support the strict locator
288
-
289
- I.amOnPage('/iframe');
290
- within({
291
- frame: { css: '#number-frame-1234' }, // support the strict locator
292
- }, () => {
293
- I.fillField('user[login]', 'User');
294
- I.fillField('user[email]', 'user@user.com');
295
- I.fillField('user[password]', 'user@user.com');
296
- I.click('button');
297
- });
298
- ```
299
-
300
- * Improve the IntelliSense when using other languages ([#3848](https://github.com/codeceptjs/CodeceptJS/issues/3848)) - by **[andonary](https://github.com/andonary)**
301
- ```
302
- include: {
303
- Je: './steps_file.js'
304
- }
305
- ```
306
-
307
- * bypassCSP support for Playwright helper ([#3865](https://github.com/codeceptjs/CodeceptJS/issues/3865)) - by **[sammeel](https://github.com/sammeel)**
308
- ```
309
- helpers: {
310
- Playwright: {
311
- bypassCSP: true
312
- }
313
- ```
314
- * fix: missing requests when recording network ([#3834](https://github.com/codeceptjs/CodeceptJS/issues/3834)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
315
-
316
- đŸ›Šī¸ Features and Improvements
317
- * Show environment info in verbose mode ([#3858](https://github.com/codeceptjs/CodeceptJS/issues/3858)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
318
-
319
- ```
320
- Environment information:-
321
-
322
- codeceptVersion: "3.5.4"
323
- nodeInfo: 18.16.0
324
- osInfo: macOS 13.5
325
- cpuInfo: (8) arm64 Apple M1 Pro
326
- chromeInfo: 116.0.5845.179
327
- edgeInfo: 116.0.1938.69
328
- firefoxInfo: Not Found
329
- safariInfo: 16.6
330
- helpers: {
331
- "Playwright": {
332
- "url": "https://github.com",
333
- "show": false,
334
- "browser": "chromium",
335
- "waitForNavigation": "load",
336
- "waitForTimeout": 30000,
337
- "trace": false,
338
- "keepTraceForPassedTests": true
339
- },
340
- "CDPHelper": {
341
- "require": "./helpers/CDPHelper.ts"
342
- },
343
- "OpenAI": {
344
- "chunkSize": 8000
345
- },
346
- "ExpectHelper": {
347
- "require": "codeceptjs-expect"
348
- },
349
- "REST": {
350
- "endpoint": "https://reqres.in",
351
- "timeout": 20000
352
- },
353
- "AllureHelper": {
354
- "require": "./helpers/AllureHelper.ts"
355
- }
356
- }
357
- plugins: {
358
- "screenshotOnFail": {
359
- "enabled": true
360
- },
361
- "tryTo": {
362
- "enabled": true
363
- },
364
- "retryFailedStep": {
365
- "enabled": true
366
- },
367
- "retryTo": {
368
- "enabled": true
369
- },
370
- "eachElement": {
371
- "enabled": true
372
- },
373
- "pauseOnFail": {}
374
- }
375
- ***************************************
376
- If you have questions ask them in our Slack: http://bit.ly/chat-codeceptjs
377
- Or ask them on our discussion board: https://codecept.discourse.group/
378
- Please copy environment info when you report issues on GitHub: https://github.com/Codeception/CodeceptJS/issues
379
- ***************************************
380
- CodeceptJS v3.5.4 #StandWithUkraine
381
- ```
382
-
383
- * some typings improvements ([#3855](https://github.com/codeceptjs/CodeceptJS/issues/3855)) - by **[nikzupancic](https://github.com/nikzupancic)**
384
- * support the puppeteer 21.1.1 ([#3856](https://github.com/codeceptjs/CodeceptJS/issues/3856)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
385
- * fix: support secret value for some methods ([#3837](https://github.com/codeceptjs/CodeceptJS/issues/3837)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
386
-
387
- ```
388
- await I.amOnPage('/form/field_values');
389
- await I.dontSeeInField('checkbox[]', secret('not seen one'));
390
- await I.seeInField('checkbox[]', secret('see test one'));
391
- await I.dontSeeInField('checkbox[]', secret('not seen two'));
392
- await I.seeInField('checkbox[]', secret('see test two'));
393
- await I.dontSeeInField('checkbox[]', secret('not seen three'));
394
- await I.seeInField('checkbox[]', secret('see test three'));
395
- ```
396
-
397
- đŸ›Šī¸ **Several bugfixes and improvements for Codecept-UI**
398
- * Mask the secret value in UI
399
- * Improve UX/UI
400
- * PageObjects are now showing in UI
401
-
402
- ## 3.5.4
403
-
404
- 🐛 Bug Fixes:
405
- * **[Playwright]** When passing `userDataDir`, it throws error after test execution ([#3814](https://github.com/codeceptjs/CodeceptJS/issues/3814)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
406
- * [CodeceptJS-CLI] Improve command to generate types ([#3788](https://github.com/codeceptjs/CodeceptJS/issues/3788)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
407
- * Heal plugin fix ([#3820](https://github.com/codeceptjs/CodeceptJS/issues/3820)) - by **[davert](https://github.com/davert)**
408
- * Fix for error in using `all` with `run-workers` ([#3805](https://github.com/codeceptjs/CodeceptJS/issues/3805)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
409
- ```js
410
- helpers: {
411
- Playwright: {
412
- url: 'https://github.com',
413
- show: false,
414
- browser: 'chromium',
415
- waitForNavigation: 'load',
416
- waitForTimeout: 30_000,
417
- trace: true,
418
- keepTraceForPassedTests: true
419
- },
420
- },
421
- multiple: {
422
- profile1: {
423
- browsers: [
424
- {
425
- browser: "chromium",
426
- }
427
- ]
428
- },
429
- },
430
- ```
431
- * Highlight elements issues ([#3779](https://github.com/codeceptjs/CodeceptJS/issues/3779)) ([#3778](https://github.com/codeceptjs/CodeceptJS/issues/3778)) - by **[philkas](https://github.com/philkas)**
432
- * Support `&nbsp` symbol in `I.see` method ([#3815](https://github.com/codeceptjs/CodeceptJS/issues/3815)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
433
-
434
- ```js
435
- // HTML code uses &nbsp; instead of space
436
- <div class="dJHe_" style="color: rgb(255, 255, 255);">My&nbsp;Text!</div>
437
-
438
- I.see("My Text!") // this test would work with both &nbsp; and space
439
- ```
440
-
441
- 📖 Documentation
442
- * Improve the configuration of electron testing when the app is build with electron-forge ([#3802](https://github.com/codeceptjs/CodeceptJS/issues/3802)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
443
-
444
- ```js
445
- const path = require("path");
446
-
447
- exports.config = {
448
- helpers: {
449
- Playwright: {
450
- browser: "electron",
451
- electron: {
452
- executablePath: require("electron"),
453
- args: [path.join(__dirname, ".webpack/main/index.js")],
454
- },
455
- },
456
- },
457
- // rest of config
458
- }
459
- ```
460
-
461
- đŸ›Šī¸ Features
462
-
463
- #### **[Playwright]** new features and improvements
464
- * Parse the response in recording network steps ([#3771](https://github.com/codeceptjs/CodeceptJS/issues/3771)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
465
-
466
- ```js
467
- const traffics = await I.grabRecordedNetworkTraffics();
468
- expect(traffics[0].url).to.equal('https://reqres.in/api/comments/1');
469
- expect(traffics[0].response.status).to.equal(200);
470
- expect(traffics[0].response.body).to.contain({ name: 'this was mocked' });
471
-
472
- expect(traffics[1].url).to.equal('https://reqres.in/api/comments/1');
473
- expect(traffics[1].response.status).to.equal(200);
474
- expect(traffics[1].response.body).to.contain({ name: 'this was another mocked' });
475
- ```
476
- * Grab metrics ([#3809](https://github.com/codeceptjs/CodeceptJS/issues/3809)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
477
-
478
- ```js
479
- const metrics = await I.grabMetrics();
480
-
481
- // returned metrics
482
-
483
- [
484
- { name: 'Timestamp', value: 1584904.203473 },
485
- { name: 'AudioHandlers', value: 0 },
486
- { name: 'AudioWorkletProcessors', value: 0 },
487
- { name: 'Documents', value: 22 },
488
- { name: 'Frames', value: 10 },
489
- { name: 'JSEventListeners', value: 366 },
490
- { name: 'LayoutObjects', value: 1240 },
491
- { name: 'MediaKeySessions', value: 0 },
492
- { name: 'MediaKeys', value: 0 },
493
- { name: 'Nodes', value: 4505 },
494
- { name: 'Resources', value: 141 },
495
- { name: 'ContextLifecycleStateObservers', value: 34 },
496
- { name: 'V8PerContextDatas', value: 4 },
497
- { name: 'WorkerGlobalScopes', value: 0 },
498
- { name: 'UACSSResources', value: 0 },
499
- { name: 'RTCPeerConnections', value: 0 },
500
- { name: 'ResourceFetchers', value: 22 },
501
- { name: 'AdSubframes', value: 0 },
502
- { name: 'DetachedScriptStates', value: 2 },
503
- { name: 'ArrayBufferContents', value: 1 },
504
- { name: 'LayoutCount', value: 0 },
505
- { name: 'RecalcStyleCount', value: 0 },
506
- { name: 'LayoutDuration', value: 0 },
507
- { name: 'RecalcStyleDuration', value: 0 },
508
- { name: 'DevToolsCommandDuration', value: 0.000013 },
509
- { name: 'ScriptDuration', value: 0 },
510
- { name: 'V8CompileDuration', value: 0 },
511
- { name: 'TaskDuration', value: 0.000014 },
512
- { name: 'TaskOtherDuration', value: 0.000001 },
513
- { name: 'ThreadTime', value: 0.000046 },
514
- { name: 'ProcessTime', value: 0.616852 },
515
- { name: 'JSHeapUsedSize', value: 19004908 },
516
- { name: 'JSHeapTotalSize', value: 26820608 },
517
- { name: 'FirstMeaningfulPaint', value: 0 },
518
- { name: 'DomContentLoaded', value: 1584903.690491 },
519
- { name: 'NavigationStart', value: 1584902.841845 }
520
- ]
521
- ```
522
-
523
- * Grab WebSocket (WS) messages ([#3789](https://github.com/codeceptjs/CodeceptJS/issues/3789)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
524
- * `flushWebSocketMessages`
525
- * `grabWebSocketMessages`
526
- * `startRecordingWebSocketMessages`
527
- * `stopRecordingWebSocketMessages`
528
-
529
- ```js
530
- await I.startRecordingWebSocketMessages();
531
- I.amOnPage('https://websocketstest.com/');
532
- I.waitForText('Work for You!');
533
- I.flushNetworkTraffics();
534
- const wsMessages = I.grabWebSocketMessages();
535
- expect(wsMessages.length).to.equal(0);
536
- ```
537
-
538
- ```js
539
- await I.startRecordingWebSocketMessages();
540
- await I.amOnPage('https://websocketstest.com/');
541
- I.waitForText('Work for You!');
542
- const wsMessages = I.grabWebSocketMessages();
543
- expect(wsMessages.length).to.greaterThan(0);
544
- ```
545
-
546
- ```js
547
- await I.startRecordingWebSocketMessages();
548
- await I.amOnPage('https://websocketstest.com/');
549
- I.waitForText('Work for You!');
550
- const wsMessages = I.grabWebSocketMessages();
551
- await I.stopRecordingWebSocketMessages();
552
- await I.amOnPage('https://websocketstest.com/');
553
- I.waitForText('Work for You!');
554
- const afterWsMessages = I.grabWebSocketMessages();
555
- expect(wsMessages.length).to.equal(afterWsMessages.length);
556
- ```
557
-
558
- * Move from `ElementHandle` to `Locator`. This change is quite major, but it happened under hood, so should not affect your code. ([#3738](https://github.com/codeceptjs/CodeceptJS/issues/3738)) - by **[KobeNguyenT](https://github.com/KobeNguyenT)**
559
-
560
10
  ## 3.5.3
561
11
 
562
12
  đŸ›Šī¸ Features
563
13
 
564
- * **[Playwright]** Added commands to check network traffic [#3748](https://github.com/codeceptjs/CodeceptJS/issues/3748) - by **[ngraf](https://github.com/ngraf)** **[KobeNguyenT](https://github.com/KobeNguyenT)**
565
- * `startRecordingTraffic`
566
- * `grabRecordedNetworkTraffics`
567
- * `blockTraffic`
568
- * `mockTraffic`
569
- * `flushNetworkTraffics`
570
- * `stopRecordingTraffic`
571
- * `seeTraffic`
572
- * `grabTrafficUrl`
573
- * `dontSeeTraffic`
574
-
575
- Examples:
14
+ * **[Playwright]** Provide new steps to check network traffic [#3748](https://github.com/codeceptjs/CodeceptJS/issues/3748) - by **[ngraf](https://github.com/ngraf)** **[KobeNguyenT](https://github.com/KobeNguyenT)**
576
15
 
577
16
  ```js
578
17
  // recording traffics and verify the traffic
@@ -31,6 +31,9 @@ Please **add your own** by editing this page.
31
31
  * [codeceptjs-bshelper](https://github.com/PeterNgTr/codeceptjs-bshelper) - a helper which updates `Test Names` & `Test Results` on Browserstack
32
32
  * [codeceptjs-tbhelper](https://github.com/testingbot/codeceptjs-tbhelper) - a helper which updates `Test Names` & `Test Results` on TestingBot
33
33
 
34
+ ## Integrations
35
+ * [codeceptjs-testrail](https://github.com/PeterNgTr/codeceptjs-testrail) - a plugin to integrate with [Testrail](https://www.gurock.com/testrail)
36
+
34
37
  ## Visual-Testing
35
38
  * [codeceptjs-resemblehelper](https://github.com/puneet0191/codeceptjs-resemblehelper) - a helper which helps with visual testing using resemble.js.
36
39
  * [codeceptjs-applitoolshelper](https://www.npmjs.com/package/codeceptjs-applitoolshelper) - a helper which helps interaction with [Applitools](https://applitools.com)
@@ -39,10 +42,8 @@ Please **add your own** by editing this page.
39
42
  ## Reporters
40
43
  * [codeceptjs-rphelper](https://github.com/reportportal/agent-js-codecept) is a CodeceptJS helper which can publish tests results on ReportPortal after execution.
41
44
  * [codeceptjs-xray-helper](https://www.npmjs.com/package/codeceptjs-xray-helper) is a CodeceptJS helper which can publish tests results on [XRAY](https://confluence.xpand-it.com/display/XRAYCLOUD/Import+Execution+Results+-+REST).
42
- * [codeceptjs-xray-cloud-helper](https://www.npmjs.com/package/codeceptjs-xray-cloud-helper) is a helper that automatically retrieves the result of CodeceptJS tests and sends them to XRAY/JIRA(cloud version) via [XRAY Cloud API](https://docs.getxray.app/display/XRAYCLOUD/Import+Execution+Results+-+REST+v2#ImportExecutionResultsRESTv2-XrayJSONresults).
43
45
  * [codeceptjs-slack-reporter](https://www.npmjs.com/package/codeceptjs-slack-reporter) Get a Slack notification when one or more scenarios fail.
44
46
  * [codeceptjs-browserlogs-plugin](https://github.com/pavkam/codeceptjs-browserlogs-plugin) Record the browser logs for failed tests.
45
- * [codeceptjs-testrail](https://github.com/PeterNgTr/codeceptjs-testrail) - a plugin to integrate with [Testrail](https://www.gurock.com/testrail)
46
47
 
47
48
  ## Browser request control
48
49
  * [codeceptjs-resources-check](https://github.com/luarmr/codeceptjs-resources-check) Load a URL with Puppeteer and listen to the requests while the page is loading. Enabling count the number or check the sizes of the requests.
@@ -54,9 +55,4 @@ Please **add your own** by editing this page.
54
55
  ## Other
55
56
 
56
57
  * [codeceptjs-cmdhelper](https://github.com/thiagodp/codeceptjs-cmdhelper) allows you to run commands in the terminal/console
57
- * [eslint-plugin-codeceptjs](https://www.npmjs.com/package/eslint-plugin-codeceptjs) Eslint rules for CodeceptJS.
58
- * [codeceptjs-datalayer-helper](https://github.com/kobenguyent/codeceptjs-datalayer-helper) CodeceptJS DataLayer helper helps you to get the datalayer JavaScript array that is used to store information and send this data to the tag manager.
59
- * [codeceptjs-a11y-helper](https://github.com/kobenguyent/codeceptjs-a11y-helper) accessibility tests integrated with CodeceptJS - Playwright-axe
60
- * [codeceptjs-lighthouse-helper](https://github.com/kobenguyent/codeceptjs-lighthouse-helper) lighthouse audit integrated with CodeceptJS - Playwright
61
- * [Snowplow Data analytics](https://www.npmjs.com/package/@viasat/codeceptjs-snowplow-helper) - Test your Snowplow events implementations with CodeceptJS and Snowplow Micro.
62
- * [codeceptjs-failure-logger](https://github.com/kobenguyent/codeceptjs-failure-logger) - Log failed CodeceptJS tests to file
58
+ * [eslint-plugin-codeceptjs](https://www.npmjs.com/package/eslint-plugin-codeceptjs) Eslint rules for CodeceptJS.
package/docs/examples.md CHANGED
@@ -16,7 +16,6 @@ Playground repository where you can run tests in different helpers on a basic si
16
16
 
17
17
  Tests repository demonstrate usage of
18
18
 
19
- * Playwright helper
20
19
  * Puppeteer helper
21
20
  * WebDriver helper
22
21
  * TestCafe plugin
@@ -29,6 +28,7 @@ Tests repository demonstrate usage of
29
28
  CodeceptJS repo contains basic tests (both failing and passing) just to show how it works.
30
29
  Our team uses it to test new features and run simple scenarios.
31
30
 
31
+
32
32
  ## [CodeceptJS Cucumber E2E Framework](https://github.com/gkushang/codeceptjs-e2e)
33
33
 
34
34
  This repository contains complete E2E framework for CodeceptJS with Cucumber and SauceLabs Integration
@@ -146,10 +146,4 @@ This is necessary if all integrations with TMS and CI/CD are already configured,
146
146
  * HTTP request client with session support and unit tests
147
147
  * Exemplary code control
148
148
  * Ready to launch in a CI/CD system as is
149
- * OOP, Test data models and builders, endpoint decorators
150
-
151
- ## [Playwright fun with CodeceptJS](https://github.com/PeterNgTr/codeceptjs-playwright-fun)
152
- * Tests are written in TS
153
- * CI/CD with Github Actions
154
- * Page Object Model is applied
155
- * ReportPortal Integration
149
+ * OOP, Test data models and builders, endpoint decorators