[Docs] Wrong description for 'path' parameter of the 'takeScreenshot' action

[miherlosev]

From docs:
path - A relative path to the folder where screenshots should be saved.

It is wrong.
path is a screenshot path. Screenshots are saved in .png format. If screenshot name doesn't contain .png then it will be added to the result name.
Examples:

Screenshots folder is 'screenshots'

takeScreenshot('test') - > screenshots/test.png
takeScreenshot('/test') -> screenshots/test.png
takeScreenshot('/test.png')  -> screenshots/test.png

• testcafe version: 0.16.0@alpha4

[VasilyStrelyaev]

if path includes the filename - what is the default filename if path is not specified?

[miherlosev]

If path does not specified the full path will be calculated as:
screenshots folder + {current-date}\{testName-testIndex}\{userAgent}\screenshotIndex.png

Example:
screenshots folder: c:\\temp

test('test', asynct t => {
    await t.takeScreenshot();
});

Screenshot will be saved in c:\temp\2017-07-05_02-34-34\test-2\Chrome_59.0.3071_Windows_8.1_0.0.0\.1.png file.

@AndreyBelym correct me if I don't right

[AndreyBelym]

Yes, that's mostly right, there will be no {testName} in path, and it differs slightly when quarantine mode is enabled. So if quarantine mode is not enabled:

{screenshotsFolder}\{currentDate}\test-{testIndex}\{userAgent}\{screenshotIndex}.png

and if quarantine is enabled, it is:

{screenshotsFolder}\{currentDate}\test-{testIndex}\run-{quarantineAttempt}\{userAgent}\{screenshotIndex}.png

[lock]

This thread has been automatically locked since it is closed and there has not been any recent activity. Please open a new issue for related bugs or feature requests. We recommend you ask TestCafe API, usage and configuration inquiries on StackOverflow.