Support screenshot path pattern

[AlexanderMoskovkin]

Proposal

related issues: #1602, #1651, #1974, #1975.
related PR: #2086

What

Provide a capability to set a pattern for a screenshot path.

API

• CLI API:

-p or --screenshot-path-pattern

testcafe chrome test.js -s <path> -p "${DATE}_${TIME}/test-${TEST_INDEX}/${USERAGENT}/${FILE_INDEX}.png"

Available options:
- ${DATE}
- ${TIME}
- ${TEST_INDEX}
- ${FILE_INDEX}
- ${QUARANTINE_ATTEMPT} --by default "1" (if you add it to the template but run tests without the `-q` option).

- ${FIXTURE}
- ${TEST}
- ${USERAGENT}
- ${BROWSER}
- ${BROWSER_VERSION}
- ${OS}
- ${OS_VERSION}

If TestCafe creates a screenshot when a test fails (--screenshots-on-fails option enabled) we just add the -error postfix to the filename.

• Programming API:

runner.screenshot(path [, takeOnFails][, filePath])
// where filePath is a template string or a function that take the info and returns a value

• t.takeScreenshot, t.takeElementScreenshot
  Should support file path pattern as well.

[miherlosev]

Implemented in #2562

[lock]

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs or feature requests. For TestCafe API, usage and configuration inquiries, we recommend asking them on StackOverflow.