Frontend of an image comparison solution. Performs image comparisons during end to end tests and writes test results
yarn add image-comparison-frontend
or
npm install --save image-comparison-frontend
You can specify a reportPath (relative to the current directory) to define where to put the .test-result.json
files.
ImageComparison will use the protractor-image-comparison screenshotPath by default.
ResultReporter will use test-results in the current directory by default.
Configure protractor-image-comparison.
Note: returnAllCompareData must be set to true!
In your test, create an ImageComparison instance const imageComparison = new ImageComparison({config...});
and call a check function, for example await imageComparison.checkPage('startPage');)
Create a ResultReporter with const reporter = new ResultReporter({config...})
and after running your test, call await this.reporter.report(...);
with a Result object containing information about the test run.
See src/image-comparison.ts for inspiration.
checkElement(
elementFinder: ElementFinder,
testName: string,
protractorImageComparisonOptions?: any
): Promise<void>
creates an image from the specified element and - if the base image already exists) compares it to the base image.
elementFinder: is any valid Protractor element finder, for example element(by.id('myElement'))
testName: a unique name for your test, for example 'anElement after adding'
protractorImageComparisonOptions: optionally, you can add additional configuration that is passed through to protractor-image-comparison
returns a Promise resolving to void
checkPage(
testName: string,
protractorImageComparisonOptions?: any
): Promise<void>
Convenience function to create an image with checkElement specifying the page <body> as element.
testName: a unique name for your test, for example 'anElement after adding'
returns a Promise resolving to void