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.
- package/README.md +39 -27
- package/bin/codecept.js +15 -2
- package/bin/codeceptq.js +49 -0
- package/bin/mcp-server.js +1187 -0
- package/docs/advanced.md +201 -0
- package/docs/agents.md +159 -0
- package/docs/ai.md +537 -0
- package/docs/aitrace.md +266 -0
- package/docs/api.md +332 -0
- package/docs/assertions.md +415 -0
- package/docs/auth.md +318 -0
- package/docs/basics.md +424 -0
- package/docs/bdd.md +539 -0
- package/docs/best.md +240 -0
- package/docs/bootstrap.md +132 -0
- package/docs/commands.md +352 -0
- package/docs/community-helpers.md +63 -0
- package/docs/configuration.md +230 -0
- package/docs/continuous-integration.md +497 -0
- package/docs/custom-helpers.md +297 -0
- package/docs/data.md +448 -0
- package/docs/debugging.md +332 -0
- package/docs/detox.md +235 -0
- package/docs/docker.md +136 -0
- package/docs/effects.md +179 -0
- package/docs/element-based-testing.md +295 -0
- package/docs/element-selection.md +125 -0
- package/docs/els.md +328 -0
- package/docs/examples.md +161 -0
- package/docs/heal.md +213 -0
- package/docs/helpers/ApiDataFactory.md +267 -0
- package/docs/helpers/Appium.md +1405 -0
- package/docs/helpers/Detox.md +665 -0
- package/docs/helpers/ExpectHelper.md +275 -0
- package/docs/helpers/FileSystem.md +152 -0
- package/docs/helpers/GraphQL.md +152 -0
- package/docs/helpers/GraphQLDataFactory.md +226 -0
- package/docs/helpers/JSONResponse.md +255 -0
- package/docs/helpers/Mochawesome.md +8 -0
- package/docs/helpers/MockRequest.md +377 -0
- package/docs/helpers/MockServer.md +212 -0
- package/docs/helpers/Playwright.md +2969 -0
- package/docs/helpers/Polly.md +44 -0
- package/docs/helpers/Protractor.md +1769 -0
- package/docs/helpers/Puppeteer-firefox.md +86 -0
- package/docs/helpers/Puppeteer.md +2690 -0
- package/docs/helpers/REST.md +289 -0
- package/docs/helpers/SoftExpectHelper.md +352 -0
- package/docs/helpers/WebDriver.md +2682 -0
- package/docs/hooks.md +339 -0
- package/docs/index.md +111 -0
- package/docs/installation.md +83 -0
- package/docs/internal-api.md +265 -0
- package/docs/internal-test-server.md +89 -0
- package/docs/locators.md +355 -0
- package/docs/mcp.md +485 -0
- package/docs/migration-4.md +556 -0
- package/docs/mobile.md +338 -0
- package/docs/pageobjects.md +399 -0
- package/docs/parallel.md +585 -0
- package/docs/playwright.md +714 -0
- package/docs/plugins.md +866 -0
- package/docs/puppeteer.md +314 -0
- package/docs/quickstart.md +120 -0
- package/docs/react.md +70 -0
- package/docs/reports.md +483 -0
- package/docs/retry.md +274 -0
- package/docs/secrets.md +150 -0
- package/docs/sessions.md +80 -0
- package/docs/shadow.md +68 -0
- package/docs/test-structure.md +275 -0
- package/docs/timeouts.md +183 -0
- package/docs/translation.md +247 -0
- package/docs/tutorial.md +271 -0
- package/docs/typescript.md +374 -0
- package/docs/web-element.md +251 -0
- package/docs/webdriver.md +708 -0
- package/docs/within.md +55 -0
- package/lib/ai.js +3 -2
- package/lib/aria.js +260 -0
- package/lib/assertions.js +18 -0
- package/lib/codecept.js +26 -23
- package/lib/command/check.js +2 -1
- package/lib/command/dryRun.js +24 -5
- package/lib/command/generate.js +2 -0
- package/lib/command/gherkin/snippets.js +5 -4
- package/lib/command/init.js +248 -269
- package/lib/command/list.js +150 -10
- package/lib/command/query.js +218 -0
- package/lib/command/run-multiple.js +2 -0
- package/lib/command/run-workers.js +2 -0
- package/lib/command/run.js +1 -1
- package/lib/command/workers/runTests.js +10 -10
- package/lib/config.js +77 -4
- package/lib/container.js +114 -17
- package/lib/effects.js +17 -0
- package/lib/element/WebElement.js +246 -2
- package/lib/els.js +12 -6
- package/lib/globals.js +32 -19
- package/lib/heal.js +4 -3
- package/lib/helper/ApiDataFactory.js +2 -1
- package/lib/helper/Appium.js +8 -8
- package/lib/helper/FileSystem.js +3 -2
- package/lib/helper/GraphQLDataFactory.js +2 -1
- package/lib/helper/Playwright.js +228 -162
- package/lib/helper/Puppeteer.js +208 -76
- package/lib/helper/WebDriver.js +173 -68
- package/lib/helper/errors/MultipleElementsFound.js +27 -110
- package/lib/helper/errors/NonFocusedType.js +8 -0
- package/lib/helper/extras/Download.js +45 -0
- package/lib/helper/extras/PlaywrightReactVueLocator.js +45 -36
- package/lib/helper/extras/elementSelection.js +58 -0
- package/lib/helper/extras/focusCheck.js +43 -0
- package/lib/helper/extras/richTextEditor.js +178 -0
- package/lib/helper/scripts/dropFile.js +11 -0
- package/lib/history.js +3 -2
- package/lib/html.js +103 -16
- package/lib/index.js +9 -1
- package/lib/listener/config.js +6 -4
- package/lib/listener/emptyRun.js +2 -1
- package/lib/listener/globalRetry.js +32 -6
- package/lib/listener/helpers.js +4 -1
- package/lib/listener/mocha.js +2 -1
- package/lib/listener/pageobjects.js +43 -0
- package/lib/listener/result.js +3 -2
- package/lib/locator.js +126 -3
- package/lib/mocha/cli.js +14 -2
- package/lib/mocha/factory.js +7 -2
- package/lib/mocha/inject.js +1 -1
- package/lib/mocha/scenarioConfig.js +2 -1
- package/lib/mocha/ui.js +5 -6
- package/lib/parser.js +2 -2
- package/lib/pause.js +38 -4
- package/lib/plugin/aiTrace.js +453 -0
- package/lib/plugin/analyze.js +1 -1
- package/lib/plugin/auth.js +3 -3
- package/lib/plugin/browser.js +77 -0
- package/lib/plugin/expose.js +159 -0
- package/lib/plugin/heal.js +44 -1
- package/lib/plugin/pageInfo.js +53 -49
- package/lib/plugin/pause.js +131 -0
- package/lib/plugin/pauseOnFail.js +10 -34
- package/lib/plugin/retryFailedStep.js +28 -19
- package/lib/plugin/screencast.js +287 -0
- package/lib/plugin/screenshot.js +563 -0
- package/lib/plugin/screenshotOnFail.js +8 -171
- package/lib/rerun.js +2 -1
- package/lib/result.js +2 -1
- package/lib/step/base.js +3 -2
- package/lib/step/config.js +15 -2
- package/lib/step/record.js +2 -2
- package/lib/store.js +72 -3
- package/lib/translation.js +2 -1
- package/lib/utils/mask_data.js +2 -1
- package/lib/utils/pluginParser.js +151 -0
- package/lib/utils/trace.js +297 -0
- package/lib/utils.js +77 -3
- package/lib/workers.js +52 -22
- package/package.json +19 -13
- package/typings/index.d.ts +19 -5
- package/docs/webapi/amOnPage.mustache +0 -11
- package/docs/webapi/appendField.mustache +0 -11
- package/docs/webapi/attachFile.mustache +0 -12
- package/docs/webapi/blur.mustache +0 -18
- package/docs/webapi/checkOption.mustache +0 -13
- package/docs/webapi/clearCookie.mustache +0 -9
- package/docs/webapi/clearField.mustache +0 -9
- package/docs/webapi/click.mustache +0 -29
- package/docs/webapi/clickLink.mustache +0 -8
- package/docs/webapi/closeCurrentTab.mustache +0 -7
- package/docs/webapi/closeOtherTabs.mustache +0 -8
- package/docs/webapi/dontSee.mustache +0 -11
- package/docs/webapi/dontSeeCheckboxIsChecked.mustache +0 -10
- package/docs/webapi/dontSeeCookie.mustache +0 -8
- package/docs/webapi/dontSeeCurrentPathEquals.mustache +0 -10
- package/docs/webapi/dontSeeCurrentUrlEquals.mustache +0 -10
- package/docs/webapi/dontSeeElement.mustache +0 -8
- package/docs/webapi/dontSeeElementInDOM.mustache +0 -8
- package/docs/webapi/dontSeeInCurrentUrl.mustache +0 -4
- package/docs/webapi/dontSeeInField.mustache +0 -11
- package/docs/webapi/dontSeeInSource.mustache +0 -8
- package/docs/webapi/dontSeeInTitle.mustache +0 -8
- package/docs/webapi/dontSeeTraffic.mustache +0 -13
- package/docs/webapi/doubleClick.mustache +0 -13
- package/docs/webapi/downloadFile.mustache +0 -12
- package/docs/webapi/dragAndDrop.mustache +0 -9
- package/docs/webapi/dragSlider.mustache +0 -11
- package/docs/webapi/executeAsyncScript.mustache +0 -24
- package/docs/webapi/executeScript.mustache +0 -26
- package/docs/webapi/fillField.mustache +0 -16
- package/docs/webapi/flushNetworkTraffics.mustache +0 -5
- package/docs/webapi/focus.mustache +0 -13
- package/docs/webapi/forceClick.mustache +0 -28
- package/docs/webapi/forceRightClick.mustache +0 -18
- package/docs/webapi/grabAllWindowHandles.mustache +0 -7
- package/docs/webapi/grabAttributeFrom.mustache +0 -10
- package/docs/webapi/grabAttributeFromAll.mustache +0 -9
- package/docs/webapi/grabBrowserLogs.mustache +0 -9
- package/docs/webapi/grabCookie.mustache +0 -11
- package/docs/webapi/grabCssPropertyFrom.mustache +0 -11
- package/docs/webapi/grabCssPropertyFromAll.mustache +0 -10
- package/docs/webapi/grabCurrentUrl.mustache +0 -9
- package/docs/webapi/grabCurrentWindowHandle.mustache +0 -6
- package/docs/webapi/grabDataFromPerformanceTiming.mustache +0 -20
- package/docs/webapi/grabElementBoundingRect.mustache +0 -20
- package/docs/webapi/grabGeoLocation.mustache +0 -8
- package/docs/webapi/grabHTMLFrom.mustache +0 -10
- package/docs/webapi/grabHTMLFromAll.mustache +0 -9
- package/docs/webapi/grabNumberOfOpenTabs.mustache +0 -8
- package/docs/webapi/grabNumberOfVisibleElements.mustache +0 -9
- package/docs/webapi/grabPageScrollPosition.mustache +0 -8
- package/docs/webapi/grabPopupText.mustache +0 -5
- package/docs/webapi/grabRecordedNetworkTraffics.mustache +0 -10
- package/docs/webapi/grabSource.mustache +0 -8
- package/docs/webapi/grabTextFrom.mustache +0 -10
- package/docs/webapi/grabTextFromAll.mustache +0 -9
- package/docs/webapi/grabTitle.mustache +0 -8
- package/docs/webapi/grabValueFrom.mustache +0 -9
- package/docs/webapi/grabValueFromAll.mustache +0 -8
- package/docs/webapi/grabWebElement.mustache +0 -9
- package/docs/webapi/grabWebElements.mustache +0 -9
- package/docs/webapi/moveCursorTo.mustache +0 -12
- package/docs/webapi/openNewTab.mustache +0 -7
- package/docs/webapi/pressKey.mustache +0 -12
- package/docs/webapi/pressKeyDown.mustache +0 -12
- package/docs/webapi/pressKeyUp.mustache +0 -12
- package/docs/webapi/pressKeyWithKeyNormalization.mustache +0 -60
- package/docs/webapi/refreshPage.mustache +0 -6
- package/docs/webapi/resizeWindow.mustache +0 -6
- package/docs/webapi/rightClick.mustache +0 -14
- package/docs/webapi/saveElementScreenshot.mustache +0 -10
- package/docs/webapi/saveScreenshot.mustache +0 -12
- package/docs/webapi/say.mustache +0 -10
- package/docs/webapi/scrollIntoView.mustache +0 -11
- package/docs/webapi/scrollPageToBottom.mustache +0 -6
- package/docs/webapi/scrollPageToTop.mustache +0 -6
- package/docs/webapi/scrollTo.mustache +0 -12
- package/docs/webapi/see.mustache +0 -11
- package/docs/webapi/seeAttributesOnElements.mustache +0 -9
- package/docs/webapi/seeCheckboxIsChecked.mustache +0 -10
- package/docs/webapi/seeCookie.mustache +0 -8
- package/docs/webapi/seeCssPropertiesOnElements.mustache +0 -9
- package/docs/webapi/seeCurrentPathEquals.mustache +0 -10
- package/docs/webapi/seeCurrentUrlEquals.mustache +0 -11
- package/docs/webapi/seeElement.mustache +0 -8
- package/docs/webapi/seeElementInDOM.mustache +0 -8
- package/docs/webapi/seeInCurrentUrl.mustache +0 -8
- package/docs/webapi/seeInField.mustache +0 -12
- package/docs/webapi/seeInPopup.mustache +0 -8
- package/docs/webapi/seeInSource.mustache +0 -7
- package/docs/webapi/seeInTitle.mustache +0 -8
- package/docs/webapi/seeNumberOfElements.mustache +0 -11
- package/docs/webapi/seeNumberOfVisibleElements.mustache +0 -10
- package/docs/webapi/seeTextEquals.mustache +0 -9
- package/docs/webapi/seeTitleEquals.mustache +0 -8
- package/docs/webapi/seeTraffic.mustache +0 -36
- package/docs/webapi/selectOption.mustache +0 -21
- package/docs/webapi/setCookie.mustache +0 -16
- package/docs/webapi/setGeoLocation.mustache +0 -12
- package/docs/webapi/startRecordingTraffic.mustache +0 -8
- package/docs/webapi/startRecordingWebSocketMessages.mustache +0 -8
- package/docs/webapi/stopRecordingTraffic.mustache +0 -5
- package/docs/webapi/stopRecordingWebSocketMessages.mustache +0 -7
- package/docs/webapi/switchTo.mustache +0 -9
- package/docs/webapi/switchToNextTab.mustache +0 -10
- package/docs/webapi/switchToPreviousTab.mustache +0 -10
- package/docs/webapi/type.mustache +0 -21
- package/docs/webapi/uncheckOption.mustache +0 -13
- package/docs/webapi/wait.mustache +0 -8
- package/docs/webapi/waitForClickable.mustache +0 -11
- package/docs/webapi/waitForCookie.mustache +0 -9
- package/docs/webapi/waitForDetached.mustache +0 -10
- package/docs/webapi/waitForDisabled.mustache +0 -6
- package/docs/webapi/waitForElement.mustache +0 -11
- package/docs/webapi/waitForEnabled.mustache +0 -6
- package/docs/webapi/waitForFunction.mustache +0 -17
- package/docs/webapi/waitForInvisible.mustache +0 -10
- package/docs/webapi/waitForNumberOfTabs.mustache +0 -9
- package/docs/webapi/waitForText.mustache +0 -13
- package/docs/webapi/waitForValue.mustache +0 -10
- package/docs/webapi/waitForVisible.mustache +0 -10
- package/docs/webapi/waitInUrl.mustache +0 -9
- package/docs/webapi/waitNumberOfVisibleElements.mustache +0 -10
- package/docs/webapi/waitToHide.mustache +0 -10
- package/docs/webapi/waitUrlEquals.mustache +0 -10
- package/lib/helper/AI.js +0 -214
- package/lib/listener/enhancedGlobalRetry.js +0 -110
- package/lib/plugin/enhancedRetryFailedStep.js +0 -99
- package/lib/plugin/htmlReporter.js +0 -3648
- package/lib/plugin/stepByStepReport.js +0 -427
- package/lib/plugin/subtitles.js +0 -89
- package/lib/retryCoordinator.js +0 -207
- package/typings/promiseBasedTypes.d.ts +0 -9469
- package/typings/types.d.ts +0 -11402
package/lib/command/init.js
CHANGED
|
@@ -15,26 +15,16 @@ import { test as generateTest } from './generate.js'
|
|
|
15
15
|
const isLocal = installedLocally()
|
|
16
16
|
|
|
17
17
|
const defaultConfig = {
|
|
18
|
-
tests: '
|
|
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
|
|
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
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
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
|
-
|
|
169
|
-
|
|
170
|
-
|
|
161
|
+
const config = defaultConfig
|
|
162
|
+
config.name = testsPath.split(path.sep).pop()
|
|
163
|
+
config.output = result.output
|
|
171
164
|
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
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
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
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
|
-
|
|
241
|
+
const jsconfig = {
|
|
242
|
+
compilerOptions: {
|
|
243
|
+
allowJs: true,
|
|
244
|
+
},
|
|
245
|
+
}
|
|
185
246
|
|
|
186
|
-
|
|
187
|
-
|
|
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
|
-
|
|
190
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
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
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
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
|
-
}
|