codeceptjs 4.0.0-rc.2 → 4.0.0-rc.20

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 (294) hide show
  1. package/README.md +39 -27
  2. package/bin/codecept.js +15 -2
  3. package/bin/codeceptq.js +49 -0
  4. package/bin/mcp-server.js +1187 -0
  5. package/docs/advanced.md +201 -0
  6. package/docs/agents.md +159 -0
  7. package/docs/ai.md +537 -0
  8. package/docs/aitrace.md +266 -0
  9. package/docs/api.md +332 -0
  10. package/docs/assertions.md +415 -0
  11. package/docs/auth.md +318 -0
  12. package/docs/basics.md +424 -0
  13. package/docs/bdd.md +539 -0
  14. package/docs/best.md +240 -0
  15. package/docs/bootstrap.md +132 -0
  16. package/docs/commands.md +352 -0
  17. package/docs/community-helpers.md +63 -0
  18. package/docs/configuration.md +230 -0
  19. package/docs/continuous-integration.md +497 -0
  20. package/docs/custom-helpers.md +297 -0
  21. package/docs/data.md +448 -0
  22. package/docs/debugging.md +332 -0
  23. package/docs/detox.md +235 -0
  24. package/docs/docker.md +136 -0
  25. package/docs/effects.md +179 -0
  26. package/docs/element-based-testing.md +295 -0
  27. package/docs/element-selection.md +125 -0
  28. package/docs/els.md +328 -0
  29. package/docs/examples.md +161 -0
  30. package/docs/heal.md +213 -0
  31. package/docs/helpers/ApiDataFactory.md +267 -0
  32. package/docs/helpers/Appium.md +1405 -0
  33. package/docs/helpers/Detox.md +665 -0
  34. package/docs/helpers/ExpectHelper.md +275 -0
  35. package/docs/helpers/FileSystem.md +152 -0
  36. package/docs/helpers/GraphQL.md +152 -0
  37. package/docs/helpers/GraphQLDataFactory.md +226 -0
  38. package/docs/helpers/JSONResponse.md +255 -0
  39. package/docs/helpers/Mochawesome.md +8 -0
  40. package/docs/helpers/MockRequest.md +377 -0
  41. package/docs/helpers/MockServer.md +212 -0
  42. package/docs/helpers/Playwright.md +2969 -0
  43. package/docs/helpers/Polly.md +44 -0
  44. package/docs/helpers/Protractor.md +1769 -0
  45. package/docs/helpers/Puppeteer-firefox.md +86 -0
  46. package/docs/helpers/Puppeteer.md +2690 -0
  47. package/docs/helpers/REST.md +289 -0
  48. package/docs/helpers/SoftExpectHelper.md +352 -0
  49. package/docs/helpers/WebDriver.md +2682 -0
  50. package/docs/hooks.md +339 -0
  51. package/docs/index.md +111 -0
  52. package/docs/installation.md +83 -0
  53. package/docs/internal-api.md +265 -0
  54. package/docs/internal-test-server.md +89 -0
  55. package/docs/locators.md +355 -0
  56. package/docs/mcp.md +485 -0
  57. package/docs/migration-4.md +556 -0
  58. package/docs/mobile.md +338 -0
  59. package/docs/pageobjects.md +399 -0
  60. package/docs/parallel.md +585 -0
  61. package/docs/playwright.md +714 -0
  62. package/docs/plugins.md +866 -0
  63. package/docs/puppeteer.md +314 -0
  64. package/docs/quickstart.md +120 -0
  65. package/docs/react.md +70 -0
  66. package/docs/reports.md +483 -0
  67. package/docs/retry.md +274 -0
  68. package/docs/secrets.md +150 -0
  69. package/docs/sessions.md +80 -0
  70. package/docs/shadow.md +68 -0
  71. package/docs/test-structure.md +275 -0
  72. package/docs/timeouts.md +183 -0
  73. package/docs/translation.md +247 -0
  74. package/docs/tutorial.md +271 -0
  75. package/docs/typescript.md +374 -0
  76. package/docs/web-element.md +251 -0
  77. package/docs/webdriver.md +708 -0
  78. package/docs/within.md +55 -0
  79. package/lib/ai.js +3 -2
  80. package/lib/aria.js +260 -0
  81. package/lib/assertions.js +18 -0
  82. package/lib/codecept.js +26 -23
  83. package/lib/command/check.js +2 -1
  84. package/lib/command/dryRun.js +24 -5
  85. package/lib/command/generate.js +2 -0
  86. package/lib/command/gherkin/snippets.js +5 -4
  87. package/lib/command/init.js +248 -269
  88. package/lib/command/list.js +150 -10
  89. package/lib/command/query.js +218 -0
  90. package/lib/command/run-multiple.js +2 -0
  91. package/lib/command/run-workers.js +2 -0
  92. package/lib/command/run.js +1 -1
  93. package/lib/command/workers/runTests.js +10 -10
  94. package/lib/config.js +77 -4
  95. package/lib/container.js +114 -17
  96. package/lib/effects.js +17 -0
  97. package/lib/element/WebElement.js +246 -2
  98. package/lib/els.js +12 -6
  99. package/lib/globals.js +32 -19
  100. package/lib/heal.js +4 -3
  101. package/lib/helper/ApiDataFactory.js +2 -1
  102. package/lib/helper/Appium.js +8 -8
  103. package/lib/helper/FileSystem.js +3 -2
  104. package/lib/helper/GraphQLDataFactory.js +2 -1
  105. package/lib/helper/Playwright.js +228 -162
  106. package/lib/helper/Puppeteer.js +208 -76
  107. package/lib/helper/WebDriver.js +173 -68
  108. package/lib/helper/errors/MultipleElementsFound.js +27 -110
  109. package/lib/helper/errors/NonFocusedType.js +8 -0
  110. package/lib/helper/extras/Download.js +45 -0
  111. package/lib/helper/extras/PlaywrightReactVueLocator.js +45 -36
  112. package/lib/helper/extras/elementSelection.js +58 -0
  113. package/lib/helper/extras/focusCheck.js +43 -0
  114. package/lib/helper/extras/richTextEditor.js +178 -0
  115. package/lib/helper/scripts/dropFile.js +11 -0
  116. package/lib/history.js +3 -2
  117. package/lib/html.js +103 -16
  118. package/lib/index.js +9 -1
  119. package/lib/listener/config.js +6 -4
  120. package/lib/listener/emptyRun.js +2 -1
  121. package/lib/listener/globalRetry.js +32 -6
  122. package/lib/listener/helpers.js +4 -1
  123. package/lib/listener/mocha.js +2 -1
  124. package/lib/listener/pageobjects.js +43 -0
  125. package/lib/listener/result.js +3 -2
  126. package/lib/locator.js +126 -3
  127. package/lib/mocha/cli.js +14 -2
  128. package/lib/mocha/factory.js +7 -2
  129. package/lib/mocha/inject.js +1 -1
  130. package/lib/mocha/scenarioConfig.js +2 -1
  131. package/lib/mocha/ui.js +5 -6
  132. package/lib/parser.js +2 -2
  133. package/lib/pause.js +38 -4
  134. package/lib/plugin/aiTrace.js +453 -0
  135. package/lib/plugin/analyze.js +1 -1
  136. package/lib/plugin/auth.js +3 -3
  137. package/lib/plugin/browser.js +77 -0
  138. package/lib/plugin/expose.js +159 -0
  139. package/lib/plugin/heal.js +44 -1
  140. package/lib/plugin/pageInfo.js +53 -49
  141. package/lib/plugin/pause.js +131 -0
  142. package/lib/plugin/pauseOnFail.js +10 -34
  143. package/lib/plugin/retryFailedStep.js +28 -19
  144. package/lib/plugin/screencast.js +287 -0
  145. package/lib/plugin/screenshot.js +563 -0
  146. package/lib/plugin/screenshotOnFail.js +8 -171
  147. package/lib/rerun.js +2 -1
  148. package/lib/result.js +2 -1
  149. package/lib/step/base.js +3 -2
  150. package/lib/step/config.js +15 -2
  151. package/lib/step/record.js +2 -2
  152. package/lib/store.js +72 -3
  153. package/lib/translation.js +2 -1
  154. package/lib/utils/mask_data.js +2 -1
  155. package/lib/utils/pluginParser.js +151 -0
  156. package/lib/utils/trace.js +297 -0
  157. package/lib/utils.js +77 -3
  158. package/lib/workers.js +52 -22
  159. package/package.json +19 -13
  160. package/typings/index.d.ts +19 -5
  161. package/docs/webapi/amOnPage.mustache +0 -11
  162. package/docs/webapi/appendField.mustache +0 -11
  163. package/docs/webapi/attachFile.mustache +0 -12
  164. package/docs/webapi/blur.mustache +0 -18
  165. package/docs/webapi/checkOption.mustache +0 -13
  166. package/docs/webapi/clearCookie.mustache +0 -9
  167. package/docs/webapi/clearField.mustache +0 -9
  168. package/docs/webapi/click.mustache +0 -29
  169. package/docs/webapi/clickLink.mustache +0 -8
  170. package/docs/webapi/closeCurrentTab.mustache +0 -7
  171. package/docs/webapi/closeOtherTabs.mustache +0 -8
  172. package/docs/webapi/dontSee.mustache +0 -11
  173. package/docs/webapi/dontSeeCheckboxIsChecked.mustache +0 -10
  174. package/docs/webapi/dontSeeCookie.mustache +0 -8
  175. package/docs/webapi/dontSeeCurrentPathEquals.mustache +0 -10
  176. package/docs/webapi/dontSeeCurrentUrlEquals.mustache +0 -10
  177. package/docs/webapi/dontSeeElement.mustache +0 -8
  178. package/docs/webapi/dontSeeElementInDOM.mustache +0 -8
  179. package/docs/webapi/dontSeeInCurrentUrl.mustache +0 -4
  180. package/docs/webapi/dontSeeInField.mustache +0 -11
  181. package/docs/webapi/dontSeeInSource.mustache +0 -8
  182. package/docs/webapi/dontSeeInTitle.mustache +0 -8
  183. package/docs/webapi/dontSeeTraffic.mustache +0 -13
  184. package/docs/webapi/doubleClick.mustache +0 -13
  185. package/docs/webapi/downloadFile.mustache +0 -12
  186. package/docs/webapi/dragAndDrop.mustache +0 -9
  187. package/docs/webapi/dragSlider.mustache +0 -11
  188. package/docs/webapi/executeAsyncScript.mustache +0 -24
  189. package/docs/webapi/executeScript.mustache +0 -26
  190. package/docs/webapi/fillField.mustache +0 -16
  191. package/docs/webapi/flushNetworkTraffics.mustache +0 -5
  192. package/docs/webapi/focus.mustache +0 -13
  193. package/docs/webapi/forceClick.mustache +0 -28
  194. package/docs/webapi/forceRightClick.mustache +0 -18
  195. package/docs/webapi/grabAllWindowHandles.mustache +0 -7
  196. package/docs/webapi/grabAttributeFrom.mustache +0 -10
  197. package/docs/webapi/grabAttributeFromAll.mustache +0 -9
  198. package/docs/webapi/grabBrowserLogs.mustache +0 -9
  199. package/docs/webapi/grabCookie.mustache +0 -11
  200. package/docs/webapi/grabCssPropertyFrom.mustache +0 -11
  201. package/docs/webapi/grabCssPropertyFromAll.mustache +0 -10
  202. package/docs/webapi/grabCurrentUrl.mustache +0 -9
  203. package/docs/webapi/grabCurrentWindowHandle.mustache +0 -6
  204. package/docs/webapi/grabDataFromPerformanceTiming.mustache +0 -20
  205. package/docs/webapi/grabElementBoundingRect.mustache +0 -20
  206. package/docs/webapi/grabGeoLocation.mustache +0 -8
  207. package/docs/webapi/grabHTMLFrom.mustache +0 -10
  208. package/docs/webapi/grabHTMLFromAll.mustache +0 -9
  209. package/docs/webapi/grabNumberOfOpenTabs.mustache +0 -8
  210. package/docs/webapi/grabNumberOfVisibleElements.mustache +0 -9
  211. package/docs/webapi/grabPageScrollPosition.mustache +0 -8
  212. package/docs/webapi/grabPopupText.mustache +0 -5
  213. package/docs/webapi/grabRecordedNetworkTraffics.mustache +0 -10
  214. package/docs/webapi/grabSource.mustache +0 -8
  215. package/docs/webapi/grabTextFrom.mustache +0 -10
  216. package/docs/webapi/grabTextFromAll.mustache +0 -9
  217. package/docs/webapi/grabTitle.mustache +0 -8
  218. package/docs/webapi/grabValueFrom.mustache +0 -9
  219. package/docs/webapi/grabValueFromAll.mustache +0 -8
  220. package/docs/webapi/grabWebElement.mustache +0 -9
  221. package/docs/webapi/grabWebElements.mustache +0 -9
  222. package/docs/webapi/moveCursorTo.mustache +0 -12
  223. package/docs/webapi/openNewTab.mustache +0 -7
  224. package/docs/webapi/pressKey.mustache +0 -12
  225. package/docs/webapi/pressKeyDown.mustache +0 -12
  226. package/docs/webapi/pressKeyUp.mustache +0 -12
  227. package/docs/webapi/pressKeyWithKeyNormalization.mustache +0 -60
  228. package/docs/webapi/refreshPage.mustache +0 -6
  229. package/docs/webapi/resizeWindow.mustache +0 -6
  230. package/docs/webapi/rightClick.mustache +0 -14
  231. package/docs/webapi/saveElementScreenshot.mustache +0 -10
  232. package/docs/webapi/saveScreenshot.mustache +0 -12
  233. package/docs/webapi/say.mustache +0 -10
  234. package/docs/webapi/scrollIntoView.mustache +0 -11
  235. package/docs/webapi/scrollPageToBottom.mustache +0 -6
  236. package/docs/webapi/scrollPageToTop.mustache +0 -6
  237. package/docs/webapi/scrollTo.mustache +0 -12
  238. package/docs/webapi/see.mustache +0 -11
  239. package/docs/webapi/seeAttributesOnElements.mustache +0 -9
  240. package/docs/webapi/seeCheckboxIsChecked.mustache +0 -10
  241. package/docs/webapi/seeCookie.mustache +0 -8
  242. package/docs/webapi/seeCssPropertiesOnElements.mustache +0 -9
  243. package/docs/webapi/seeCurrentPathEquals.mustache +0 -10
  244. package/docs/webapi/seeCurrentUrlEquals.mustache +0 -11
  245. package/docs/webapi/seeElement.mustache +0 -8
  246. package/docs/webapi/seeElementInDOM.mustache +0 -8
  247. package/docs/webapi/seeInCurrentUrl.mustache +0 -8
  248. package/docs/webapi/seeInField.mustache +0 -12
  249. package/docs/webapi/seeInPopup.mustache +0 -8
  250. package/docs/webapi/seeInSource.mustache +0 -7
  251. package/docs/webapi/seeInTitle.mustache +0 -8
  252. package/docs/webapi/seeNumberOfElements.mustache +0 -11
  253. package/docs/webapi/seeNumberOfVisibleElements.mustache +0 -10
  254. package/docs/webapi/seeTextEquals.mustache +0 -9
  255. package/docs/webapi/seeTitleEquals.mustache +0 -8
  256. package/docs/webapi/seeTraffic.mustache +0 -36
  257. package/docs/webapi/selectOption.mustache +0 -21
  258. package/docs/webapi/setCookie.mustache +0 -16
  259. package/docs/webapi/setGeoLocation.mustache +0 -12
  260. package/docs/webapi/startRecordingTraffic.mustache +0 -8
  261. package/docs/webapi/startRecordingWebSocketMessages.mustache +0 -8
  262. package/docs/webapi/stopRecordingTraffic.mustache +0 -5
  263. package/docs/webapi/stopRecordingWebSocketMessages.mustache +0 -7
  264. package/docs/webapi/switchTo.mustache +0 -9
  265. package/docs/webapi/switchToNextTab.mustache +0 -10
  266. package/docs/webapi/switchToPreviousTab.mustache +0 -10
  267. package/docs/webapi/type.mustache +0 -21
  268. package/docs/webapi/uncheckOption.mustache +0 -13
  269. package/docs/webapi/wait.mustache +0 -8
  270. package/docs/webapi/waitForClickable.mustache +0 -11
  271. package/docs/webapi/waitForCookie.mustache +0 -9
  272. package/docs/webapi/waitForDetached.mustache +0 -10
  273. package/docs/webapi/waitForDisabled.mustache +0 -6
  274. package/docs/webapi/waitForElement.mustache +0 -11
  275. package/docs/webapi/waitForEnabled.mustache +0 -6
  276. package/docs/webapi/waitForFunction.mustache +0 -17
  277. package/docs/webapi/waitForInvisible.mustache +0 -10
  278. package/docs/webapi/waitForNumberOfTabs.mustache +0 -9
  279. package/docs/webapi/waitForText.mustache +0 -13
  280. package/docs/webapi/waitForValue.mustache +0 -10
  281. package/docs/webapi/waitForVisible.mustache +0 -10
  282. package/docs/webapi/waitInUrl.mustache +0 -9
  283. package/docs/webapi/waitNumberOfVisibleElements.mustache +0 -10
  284. package/docs/webapi/waitToHide.mustache +0 -10
  285. package/docs/webapi/waitUrlEquals.mustache +0 -10
  286. package/lib/helper/AI.js +0 -214
  287. package/lib/listener/enhancedGlobalRetry.js +0 -110
  288. package/lib/plugin/enhancedRetryFailedStep.js +0 -99
  289. package/lib/plugin/htmlReporter.js +0 -3648
  290. package/lib/plugin/stepByStepReport.js +0 -427
  291. package/lib/plugin/subtitles.js +0 -89
  292. package/lib/retryCoordinator.js +0 -207
  293. package/typings/promiseBasedTypes.d.ts +0 -9469
  294. package/typings/types.d.ts +0 -11402
@@ -15,26 +15,16 @@ import { test as generateTest } from './generate.js'
15
15
  const isLocal = installedLocally()
16
16
 
17
17
  const defaultConfig = {
18
- tests: './*_test.js',
18
+ tests: './tests/*_test.js',
19
19
  output: '',
20
20
  helpers: {},
21
21
  include: {},
22
+ noGlobals: true,
22
23
  plugins: {
23
- htmlReporter: {
24
- enabled: true,
25
- },
26
24
  },
27
25
  }
28
26
 
29
27
  const helpers = ['Playwright', 'WebDriver', 'Puppeteer', 'REST', 'GraphQL', 'Appium']
30
- const noTranslation = 'English (no localization)'
31
-
32
- async function getTranslations() {
33
- const translationsModule = await import('../../translations/index.js')
34
- const translations = Object.keys(translationsModule.default || translationsModule)
35
- translations.unshift(noTranslation)
36
- return translations
37
- }
38
28
 
39
29
  const packages = []
40
30
  let isTypeScript = false
@@ -53,6 +43,7 @@ setCommonPlugins();
53
43
  `
54
44
 
55
45
  const defaultActor = `// in this file you can append custom step methods to 'I' object
46
+ import { actor } from 'codeceptjs';
56
47
 
57
48
  export default function() {
58
49
  return actor({
@@ -65,6 +56,7 @@ export default function() {
65
56
  `
66
57
 
67
58
  const defaultActorTs = `// in this file you can append custom step methods to 'I' object
59
+ import { actor } from 'codeceptjs';
68
60
 
69
61
  export = function() {
70
62
  return actor({
@@ -76,9 +68,9 @@ export = function() {
76
68
  }
77
69
  `
78
70
 
79
- export default async function (initPath) {
71
+ export default async function (initPath, options = {}) {
80
72
  const testsPath = getTestRoot(initPath)
81
- const translations = await getTranslations()
73
+ const skipPrompts = !!options.yes
82
74
 
83
75
  print()
84
76
  print(` Welcome to ${colors.magenta.bold('CodeceptJS')} initialization tool`)
@@ -116,251 +108,265 @@ export default async function (initPath) {
116
108
  return
117
109
  }
118
110
 
119
- inquirer
120
- .prompt([
121
- {
122
- name: 'typescript',
123
- type: 'confirm',
124
- default: false,
125
- message: 'Do you plan to write tests in TypeScript?',
126
- },
127
- {
128
- name: 'tests',
129
- type: 'input',
130
- default: answers => `./*_test.${answers.typescript ? 'ts' : 'js'}`,
131
- message: 'Where are your tests located?',
132
- },
133
- {
134
- name: 'helper',
135
- type: 'list',
136
- choices: helpers,
137
- default: 'Playwright',
138
- message: 'What helpers do you want to use?',
139
- },
140
- {
141
- name: 'jsonResponse',
142
- type: 'confirm',
143
- default: true,
144
- message: 'Do you want to use JSONResponse helper for assertions on JSON responses? http://bit.ly/3ASVPy9',
145
- when: answers => ['GraphQL', 'REST'].includes(answers.helper) === true,
146
- },
147
- {
148
- name: 'output',
149
- default: './output',
150
- message: 'Where should logs, screenshots, and reports to be stored?',
151
- },
152
- {
153
- name: 'translation',
154
- type: 'list',
155
- message: 'Do you want to enable localization for tests? http://bit.ly/3GNUBbh',
156
- choices: translations,
157
- },
158
- ])
159
- .then(async result => {
160
- if (result.typescript === true) {
161
- isTypeScript = true
162
- extension = isTypeScript === true ? 'ts' : 'js'
163
- packages.push('typescript')
164
- packages.push('tsx') // Add tsx for TypeScript support
165
- packages.push('@types/node')
111
+ const result = skipPrompts
112
+ ? {
113
+ typescript: false,
114
+ tests: './tests/*_test.js',
115
+ helper: 'Playwright',
116
+ jsonResponse: false,
117
+ output: './output',
166
118
  }
119
+ : await inquirer.prompt([
120
+ {
121
+ name: 'typescript',
122
+ type: 'confirm',
123
+ default: false,
124
+ message: 'Do you plan to write tests in TypeScript?',
125
+ },
126
+ {
127
+ name: 'tests',
128
+ type: 'input',
129
+ default: answers => `./tests/*_test.${answers.typescript ? 'ts' : 'js'}`,
130
+ message: 'Where are your tests located?',
131
+ },
132
+ {
133
+ name: 'helper',
134
+ type: 'list',
135
+ choices: helpers,
136
+ default: 'Playwright',
137
+ message: 'What helpers do you want to use?',
138
+ },
139
+ {
140
+ name: 'jsonResponse',
141
+ type: 'confirm',
142
+ default: true,
143
+ message: 'Do you want to use JSONResponse helper for assertions on JSON responses? http://bit.ly/3ASVPy9',
144
+ when: answers => ['GraphQL', 'REST'].includes(answers.helper) === true,
145
+ },
146
+ {
147
+ name: 'output',
148
+ default: './output',
149
+ message: 'Where should logs, screenshots, and reports to be stored?',
150
+ },
151
+ ])
152
+
153
+ if (result.typescript === true) {
154
+ isTypeScript = true
155
+ extension = isTypeScript === true ? 'ts' : 'js'
156
+ packages.push('typescript')
157
+ packages.push('tsx')
158
+ packages.push('@types/node')
159
+ }
167
160
 
168
- const config = defaultConfig
169
- config.name = testsPath.split(path.sep).pop()
170
- config.output = result.output
161
+ const config = defaultConfig
162
+ config.name = testsPath.split(path.sep).pop()
163
+ config.output = result.output
171
164
 
172
- config.tests = result.tests
173
- if (isTypeScript) {
174
- config.tests = `${config.tests.replace(/\.js$/, `.${extension}`)}`
175
- config.require = ['tsx/cjs'] // Add tsx/cjs loader for TypeScript tests
176
- }
165
+ config.tests = result.tests
166
+ if (isTypeScript) {
167
+ config.tests = `${config.tests.replace(/\.js$/, `.${extension}`)}`
168
+ config.require = ['tsx/cjs']
169
+ }
170
+
171
+ const matchResults = config.tests.match(/[^*.]+/)
172
+ if (matchResults) {
173
+ mkdirp.sync(path.join(testsPath, matchResults[0]))
174
+ }
175
+
176
+ const helperName = result.helper
177
+ config.helpers[helperName] = {}
177
178
 
178
- // create a directory tests if it is included in tests path
179
- const matchResults = config.tests.match(/[^*.]+/)
180
- if (matchResults) {
181
- mkdirp.sync(path.join(testsPath, matchResults[0]))
179
+ if (result.jsonResponse === true) {
180
+ config.helpers.JSONResponse = {}
181
+ }
182
+
183
+ let helperConfigs = []
184
+
185
+ try {
186
+ const HelperModule = await import(`../helper/${helperName}.js`)
187
+ const Helper = HelperModule.default || HelperModule
188
+ if (Helper._checkRequirements) {
189
+ packages.concat(Helper._checkRequirements())
190
+ }
191
+
192
+ if (!Helper._config()) return
193
+ helperConfigs = helperConfigs.concat(
194
+ Helper._config().map(config => {
195
+ config.message = `[${helperName}] ${config.message}`
196
+ config.name = `${helperName}_${config.name}`
197
+ config.type = config.type || 'input'
198
+ return config
199
+ }),
200
+ )
201
+ } catch (err) {
202
+ error(err)
203
+ }
204
+
205
+ const finish = async () => {
206
+ const stepFile = `./steps_file.${extension}`
207
+ fs.writeFileSync(path.join(testsPath, stepFile), extension === 'ts' ? defaultActorTs : defaultActor)
208
+
209
+ config.include = { I: isTypeScript ? './steps_file' : stepFile }
210
+
211
+ print(`Steps file created at ${stepFile}`)
212
+
213
+ let configSource
214
+ const hasConfigure = isLocal && !initPath
215
+
216
+ if (isTypeScript) {
217
+ configSource = beautify(`export const config : CodeceptJS.MainConfig = ${inspect(config, false, 4, false)}`)
218
+
219
+ if (hasConfigure) configSource = importCodeceptConfigure + configHeader + configSource
220
+
221
+ fs.writeFileSync(typeScriptconfigFile, configSource, 'utf-8')
222
+ print(`Config created at ${typeScriptconfigFile}`)
223
+ } else {
224
+ configSource = beautify(`/** @type {CodeceptJS.MainConfig} */\nexport const config = ${inspect(config, false, 4, false)}`)
225
+
226
+ if (hasConfigure) configSource = importCodeceptConfigure + configHeader + configSource
227
+
228
+ fs.writeFileSync(configFile, configSource, 'utf-8')
229
+ print(`Config created at ${configFile}`)
230
+ }
231
+
232
+ if (config.output) {
233
+ if (!fileExists(config.output)) {
234
+ mkdirp.sync(path.join(testsPath, config.output))
235
+ print(`Directory for temporary output files created at '${config.output}'`)
236
+ } else {
237
+ print(`Directory for temporary output files is already created at '${config.output}'`)
182
238
  }
239
+ }
183
240
 
184
- if (result.translation !== noTranslation) config.translation = result.translation
241
+ const jsconfig = {
242
+ compilerOptions: {
243
+ allowJs: true,
244
+ },
245
+ }
185
246
 
186
- const helperName = result.helper
187
- config.helpers[helperName] = {}
247
+ const tsconfig = {
248
+ 'ts-node': {
249
+ files: true,
250
+ },
251
+ compilerOptions: {
252
+ target: 'es2018',
253
+ lib: ['es2018', 'DOM'],
254
+ esModuleInterop: true,
255
+ module: 'commonjs',
256
+ strictNullChecks: false,
257
+ types: ['codeceptjs', 'node'],
258
+ declaration: true,
259
+ skipLibCheck: true,
260
+ },
261
+ exclude: ['node_modules'],
262
+ }
188
263
 
189
- if (result.jsonResponse === true) {
190
- config.helpers.JSONResponse = {}
264
+ if (isTypeScript) {
265
+ const tsconfigJson = beautify(JSON.stringify(tsconfig))
266
+ const tsconfigFile = path.join(testsPath, 'tsconfig.json')
267
+ if (fileExists(tsconfigFile)) {
268
+ print(`tsconfig.json already exists at ${tsconfigFile}`)
269
+ } else {
270
+ fs.writeFileSync(tsconfigFile, tsconfigJson)
271
+ }
272
+ } else {
273
+ const jsconfigJson = beautify(JSON.stringify(jsconfig))
274
+ const jsconfigFile = path.join(testsPath, 'jsconfig.json')
275
+ if (fileExists(jsconfigFile)) {
276
+ print(`jsconfig.json already exists at ${jsconfigFile}`)
277
+ } else {
278
+ fs.writeFileSync(jsconfigFile, jsconfigJson)
279
+ print(`Intellisense enabled in ${jsconfigFile}`)
191
280
  }
281
+ }
192
282
 
193
- let helperConfigs = []
283
+ const generateDefinitionsManually = colors.bold(`To get auto-completion support, please generate type definitions: ${colors.green('npx codeceptjs def')}`)
194
284
 
285
+ if (packages) {
195
286
  try {
196
- const HelperModule = await import(`../helper/${helperName}.js`)
197
- const Helper = HelperModule.default || HelperModule
198
- if (Helper._checkRequirements) {
199
- packages.concat(Helper._checkRequirements())
200
- }
201
-
202
- if (!Helper._config()) return
203
- helperConfigs = helperConfigs.concat(
204
- Helper._config().map(config => {
205
- config.message = `[${helperName}] ${config.message}`
206
- config.name = `${helperName}_${config.name}`
207
- config.type = config.type || 'input'
208
- return config
209
- }),
210
- )
287
+ install(packages)
211
288
  } catch (err) {
212
- error(err)
289
+ print(colors.bold.red(err.toString()))
290
+ print()
291
+ print(colors.bold.red('Please install next packages manually:'))
292
+ print(`npm i ${packages.join(' ')} --save-dev`)
293
+ print()
294
+ print('Things to do after missing packages installed:')
295
+ print('☑', generateDefinitionsManually)
296
+ print('☑ Create first test:', colors.green('npx codeceptjs gt'))
297
+ print(colors.bold.magenta('Find more information at https://codecept.io'))
298
+ return
213
299
  }
300
+ }
214
301
 
215
- const finish = async () => {
216
- // create steps file by default
217
- // no extra step file for typescript (as it doesn't match TS conventions)
218
- const stepFile = `./steps_file.${extension}`
219
- fs.writeFileSync(path.join(testsPath, stepFile), extension === 'ts' ? defaultActorTs : defaultActor)
220
-
221
- if (isTypeScript) {
222
- config.include = await _actorTranslation('./steps_file', config.translation, translations)
223
- } else {
224
- config.include = await _actorTranslation(stepFile, config.translation, translations)
225
- }
226
-
227
- print(`Steps file created at ${stepFile}`)
228
-
229
- let configSource
230
- const hasConfigure = isLocal && !initPath
231
-
232
- if (isTypeScript) {
233
- configSource = beautify(`export const config : CodeceptJS.MainConfig = ${inspect(config, false, 4, false)}`)
234
-
235
- if (hasConfigure) configSource = importCodeceptConfigure + configHeader + configSource
236
-
237
- fs.writeFileSync(typeScriptconfigFile, configSource, 'utf-8')
238
- print(`Config created at ${typeScriptconfigFile}`)
239
- } else {
240
- configSource = beautify(`/** @type {CodeceptJS.MainConfig} */\nexport const config = ${inspect(config, false, 4, false)}`)
241
-
242
- if (hasConfigure) configSource = importCodeceptConfigure + configHeader + configSource
243
-
244
- fs.writeFileSync(configFile, configSource, 'utf-8')
245
- print(`Config created at ${configFile}`)
246
- }
247
-
248
- if (config.output) {
249
- if (!fileExists(config.output)) {
250
- mkdirp.sync(path.join(testsPath, config.output))
251
- print(`Directory for temporary output files created at '${config.output}'`)
252
- } else {
253
- print(`Directory for temporary output files is already created at '${config.output}'`)
254
- }
255
- }
256
-
257
- const jsconfig = {
258
- compilerOptions: {
259
- allowJs: true,
260
- },
261
- }
262
-
263
- const tsconfig = {
264
- 'ts-node': {
265
- files: true,
266
- },
267
- compilerOptions: {
268
- target: 'es2018',
269
- lib: ['es2018', 'DOM'],
270
- esModuleInterop: true,
271
- module: 'commonjs',
272
- strictNullChecks: false,
273
- types: ['codeceptjs', 'node'],
274
- declaration: true,
275
- skipLibCheck: true,
276
- },
277
- exclude: ['node_modules'],
278
- }
279
-
280
- if (isTypeScript) {
281
- const tsconfigJson = beautify(JSON.stringify(tsconfig))
282
- const tsconfigFile = path.join(testsPath, 'tsconfig.json')
283
- if (fileExists(tsconfigFile)) {
284
- print(`tsconfig.json already exists at ${tsconfigFile}`)
285
- } else {
286
- fs.writeFileSync(tsconfigFile, tsconfigJson)
287
- }
288
- } else {
289
- const jsconfigJson = beautify(JSON.stringify(jsconfig))
290
- const jsconfigFile = path.join(testsPath, 'jsconfig.json')
291
- if (fileExists(jsconfigFile)) {
292
- print(`jsconfig.json already exists at ${jsconfigFile}`)
293
- } else {
294
- fs.writeFileSync(jsconfigFile, jsconfigJson)
295
- print(`Intellisense enabled in ${jsconfigFile}`)
296
- }
297
- }
298
-
299
- const generateDefinitionsManually = colors.bold(`To get auto-completion support, please generate type definitions: ${colors.green('npx codeceptjs def')}`)
300
-
301
- if (packages) {
302
- try {
303
- install(packages)
304
- } catch (err) {
305
- print(colors.bold.red(err.toString()))
306
- print()
307
- print(colors.bold.red('Please install next packages manually:'))
308
- print(`npm i ${packages.join(' ')} --save-dev`)
309
- print()
310
- print('Things to do after missing packages installed:')
311
- print('☑', generateDefinitionsManually)
312
- print('☑ Create first test:', colors.green('npx codeceptjs gt'))
313
- print(colors.bold.magenta('Find more information at https://codecept.io'))
314
- return
315
- }
316
- }
317
-
318
- try {
319
- generateDefinitions(testsPath, {})
320
- } catch (err) {
321
- print(colors.bold.red("Couldn't generate type definitions"))
322
- print(colors.red(err.toString()))
323
- print('Skipping type definitions...')
324
- print(generateDefinitionsManually)
325
- }
326
-
327
- print('')
328
- success(' Almost ready... Next step:')
329
-
330
- const generatedTest = generateTest(testsPath)
331
- if (!generatedTest) return
332
- generatedTest.then(() => {
333
- print('\n--')
334
- print(colors.bold.green('CodeceptJS Installed! Enjoy supercharged testing! 🤩'))
335
- print(colors.bold.magenta('Find more information at https://codecept.io'))
336
- print()
337
- })
338
- }
302
+ try {
303
+ generateDefinitions(testsPath, {})
304
+ } catch (err) {
305
+ print(colors.bold.red("Couldn't generate type definitions"))
306
+ print(colors.red(err.toString()))
307
+ print('Skipping type definitions...')
308
+ print(generateDefinitionsManually)
309
+ }
310
+
311
+ print('')
312
+ success(' Almost ready... Next step:')
313
+
314
+ if (skipPrompts) {
315
+ print('\n--')
316
+ print(colors.bold.green('CodeceptJS Installed! Enjoy supercharged testing! 🤩'))
317
+ print(colors.bold.magenta('Find more information at https://codecept.io'))
318
+ print()
319
+ return
320
+ }
339
321
 
340
- print('Configure helpers...')
341
- inquirer.prompt(helperConfigs).then(async helperResult => {
342
- if (helperResult.Playwright_browser === 'electron') {
343
- delete helperResult.Playwright_url
344
- delete helperResult.Playwright_show
345
-
346
- helperResult.Playwright_electron = {
347
- executablePath: '// require("electron") or require("electron-forge")',
348
- args: ['path/to/your/main.js'],
349
- }
350
- }
351
-
352
- Object.keys(helperResult).forEach(key => {
353
- const parts = key.split('_')
354
- const helperName = parts[0]
355
- const configName = parts[1]
356
- if (!configName) return
357
- config.helpers[helperName][configName] = helperResult[key]
358
- })
359
-
360
- print('')
361
- await finish()
362
- })
322
+ const generatedTest = generateTest(testsPath)
323
+ if (!generatedTest) return
324
+ generatedTest.then(() => {
325
+ print('\n--')
326
+ print(colors.bold.green('CodeceptJS Installed! Enjoy supercharged testing! 🤩'))
327
+ print(colors.bold.magenta('Find more information at https://codecept.io'))
328
+ print()
363
329
  })
330
+ }
331
+
332
+ const helperResult = skipPrompts
333
+ ? defaultHelperAnswers(helperName)
334
+ : await (async () => {
335
+ print('Configure helpers...')
336
+ return inquirer.prompt(helperConfigs)
337
+ })()
338
+
339
+ if (helperResult.Playwright_browser === 'electron') {
340
+ delete helperResult.Playwright_url
341
+ delete helperResult.Playwright_show
342
+
343
+ helperResult.Playwright_electron = {
344
+ executablePath: '// require("electron") or require("electron-forge")',
345
+ args: ['path/to/your/main.js'],
346
+ }
347
+ }
348
+
349
+ Object.keys(helperResult).forEach(key => {
350
+ const parts = key.split('_')
351
+ const hName = parts[0]
352
+ const configName = parts[1]
353
+ if (!configName) return
354
+ config.helpers[hName][configName] = helperResult[key]
355
+ })
356
+
357
+ print('')
358
+ await finish()
359
+ }
360
+
361
+ function defaultHelperAnswers(helperName) {
362
+ if (helperName === 'Playwright') {
363
+ return {
364
+ Playwright_browser: 'chromium',
365
+ Playwright_url: process.env.BASE_URL || 'http://localhost',
366
+ Playwright_show: false,
367
+ }
368
+ }
369
+ return {}
364
370
  }
365
371
 
366
372
  function install(dependencies) {
@@ -401,30 +407,3 @@ function install(dependencies) {
401
407
  }
402
408
  return true
403
409
  }
404
-
405
- async function _actorTranslation(stepFile, translationSelected, translations) {
406
- let actor
407
-
408
- for (const translationAvailable of translations) {
409
- if (actor) {
410
- break
411
- }
412
-
413
- if (translationSelected === translationAvailable) {
414
- const translationsModule = await import('../../translations/index.js')
415
- const nameOfActor = (translationsModule.default || translationsModule)[translationAvailable].I
416
-
417
- actor = {
418
- [nameOfActor]: stepFile,
419
- }
420
- }
421
- }
422
-
423
- if (!actor) {
424
- actor = {
425
- I: stepFile,
426
- }
427
- }
428
-
429
- return actor
430
- }