@applitools/eyes
Version:
438 lines (437 loc) • 17.5 kB
TypeScript
import type * as Core from '@applitools/core';
import { EyesSelector } from './EyesSelector';
import { SessionType, SessionTypeEnum } from '../enums/SessionType';
import { StitchMode, StitchModeEnum } from '../enums/StitchMode';
import { MatchLevel, MatchLevelEnum } from '../enums/MatchLevel';
import { BrowserType } from '../enums/BrowserType';
import { DeviceName } from '../enums/DeviceName';
import { IosMultiDeviceTarget } from '../enums/IosMultiDeviceTarget';
import { ScreenOrientation } from '../enums/ScreenOrientation';
import { AccessibilitySettings } from './AccessibilitySettings';
import { RenderInfo, RenderInfoLegacy } from './RenderInfo';
import { CutProvider } from './CutProvider';
import { DebugScreenshotProvider } from './DebugScreenshotProvider';
import { RectangleSize, RectangleSizeData } from './RectangleSize';
import { ImageRotation, ImageRotationData } from './ImageRotation';
import { ProxySettings, ProxySettingsData } from './ProxySettings';
import { AUTProxySettings } from './AUTProxySettings';
import { BatchInfo, BatchInfoData } from './BatchInfo';
import { PropertyData, PropertyDataData } from './PropertyData';
import { ImageMatchSettings } from './ImageMatchSettings';
import { LatestCommitInfo } from './LatestCommitInfo';
export type Configuration<TSpec extends Core.SpecType = Core.SpecType> = {
accessibilityValidation?: AccessibilitySettings;
agentId?: string;
apiKey?: string;
appName?: string;
autProxy?: AUTProxySettings;
baselineBranchName?: string;
baselineEnvName?: string;
batch?: BatchInfo;
branchName?: string;
browsersInfo?: RenderInfo[];
captureStatusBar?: boolean;
compareWithParentBranch?: boolean;
/** @undocumented */
concurrentSessions?: number;
/** @undocumented */
connectionTimeout?: number;
cut?: CutProvider;
/** @undocumented */
debugScreenshots?: DebugScreenshotProvider;
defaultMatchSettings?: ImageMatchSettings;
deviceInfo?: string;
disableBrowserFetching?: boolean;
disableNMLUrlCache?: boolean;
displayName?: string;
/** @undocumented */
dontCloseBatches?: boolean;
enablePatterns?: boolean;
environmentName?: string;
/** @deprecated use fully instead */
forceFullPageScreenshot?: boolean;
fully?: boolean;
gitMergeBaseTimestamp?: string;
latestCommitInfo?: LatestCommitInfo;
hideCaret?: boolean;
hideScrollbars?: boolean;
hostApp?: string;
hostAppInfo?: string;
hostOS?: string;
hostOSInfo?: string;
ignoreBaseline?: boolean;
ignoreCaret?: boolean;
ignoreDisplacements?: boolean;
ignoreGitMergeBase?: boolean;
isDisabled?: boolean;
layoutBreakpoints?: boolean | number[] | {
breakpoints: number[] | boolean;
reload?: boolean;
};
matchLevel?: MatchLevel;
matchTimeout?: number;
mobileOptions?: {
keepNavigationBar?: boolean;
};
parentBranchName?: string;
properties?: PropertyData[];
proxy?: ProxySettings;
/** @undocumented */
removeSession?: boolean;
rotation?: ImageRotation;
saveDiffs?: boolean;
saveFailedTests?: boolean;
saveNewTests?: boolean;
scaleRatio?: number;
scrollRootElement?: TSpec['element'] | EyesSelector<TSpec['selector']>;
sendDom?: boolean;
serverUrl?: string;
sessionType?: SessionType;
stitchMode?: StitchMode;
stitchOverlap?: number;
testName?: string;
useDom?: boolean;
viewportSize?: RectangleSize;
visualGridOptions?: Record<string, any>;
waitBeforeCapture?: number | (() => Promise<void>);
waitBeforeScreenshots?: number;
};
export declare class ConfigurationData<TSpec extends Core.SpecType = Core.SpecType> implements Required<Configuration<TSpec>> {
protected static readonly _spec: Core.SpecDriver<Core.SpecType>;
private _spec;
private _config;
private _isElementReference;
private _isSelectorReference;
constructor(config?: Configuration<TSpec>);
/** @internal */
constructor(config?: Configuration<TSpec>, spec?: Core.SpecDriver<TSpec>);
get accessibilityValidation(): AccessibilitySettings;
set accessibilityValidation(accessibilityValidation: AccessibilitySettings);
getAccessibilityValidation(): AccessibilitySettings;
setAccessibilityValidation(accessibilityValidation: AccessibilitySettings): this;
get agentId(): string;
set agentId(agentId: string);
getAgentId(): string;
setAgentId(agentId: string): this;
get apiKey(): string;
set apiKey(apiKey: string);
getApiKey(): string;
setApiKey(apiKey: string): this;
get appName(): string;
set appName(appName: string);
getAppName(): string;
setAppName(appName: string): this;
get autProxy(): AUTProxySettings;
set autProxy(autProxy: AUTProxySettings);
getAutProxy(): AUTProxySettings;
setAutProxy(autProxy: AUTProxySettings): this;
get baselineBranchName(): string;
set baselineBranchName(baselineBranchName: string);
getBaselineBranchName(): string;
setBaselineBranchName(baselineBranchName: string): this;
get baselineEnvName(): string;
set baselineEnvName(baselineEnvName: string);
getBaselineEnvName(): string;
setBaselineEnvName(baselineEnvName: string): this;
get batch(): BatchInfo;
set batch(batch: BatchInfo);
getBatch(): BatchInfoData;
setBatch(batch: BatchInfo): this;
get branchName(): string;
set branchName(branchName: string);
getBranchName(): string;
setBranchName(branchName: string): this;
get browsersInfo(): RenderInfo[];
set browsersInfo(browsersInfo: RenderInfo[]);
getBrowsersInfo(): RenderInfo[];
setBrowsersInfo(browsersInfo: RenderInfoLegacy[]): this;
addBrowsers(...browsersInfo: RenderInfoLegacy[]): this;
addBrowser(browserInfo: RenderInfoLegacy): this;
addBrowser(width: number, height: number, name?: BrowserType): this;
addDeviceEmulation(deviceName: DeviceName, screenOrientation?: ScreenOrientation): this;
addMultiDeviceTarget(deviceName: IosMultiDeviceTarget): this;
get captureStatusBar(): boolean;
set captureStatusBar(captureStatusBar: boolean);
getCaptureStatusBar(): boolean;
setCaptureStatusBar(captureStatusBar: boolean): this;
get compareWithParentBranch(): boolean;
set compareWithParentBranch(compareWithParentBranch: boolean);
getCompareWithParentBranch(): boolean;
setCompareWithParentBranch(compareWithParentBranch: boolean): this;
/** @undocumented */
get concurrentSessions(): number;
/** @undocumented */
set concurrentSessions(concurrentSessions: number);
/** @undocumented */
getConcurrentSessions(): number;
/** @undocumented */
setConcurrentSessions(concurrentSessions: number): this;
/** @undocumented */
get connectionTimeout(): number;
/** @undocumented */
set connectionTimeout(connectionTimeout: number);
/** @undocumented */
getConnectionTimeout(): number;
/** @undocumented */
setConnectionTimeout(connectionTimeout: number): this;
get cut(): CutProvider;
set cut(cut: CutProvider);
getCut(): CutProvider;
setCut(cut: CutProvider): this;
/** @undocumented */
get debugScreenshots(): DebugScreenshotProvider;
/** @undocumented */
set debugScreenshots(debugScreenshots: DebugScreenshotProvider);
/** @undocumented */
getSaveDebugScreenshots(): boolean;
/** @undocumented */
setSaveDebugScreenshots(save: boolean): this;
/** @undocumented */
getDebugScreenshotsPath(): string;
/** @undocumented */
setDebugScreenshotsPath(path: string): this;
/** @undocumented */
getDebugScreenshotsPrefix(): string;
/** @undocumented */
setDebugScreenshotsPrefix(prefix: string): this;
get defaultMatchSettings(): ImageMatchSettings;
set defaultMatchSettings(defaultMatchSettings: ImageMatchSettings);
getDefaultMatchSettings(): ImageMatchSettings;
setDefaultMatchSettings(defaultMatchSettings: ImageMatchSettings): this;
get deviceInfo(): string;
set deviceInfo(deviceInfo: string);
getDeviceInfo(): string;
setDeviceInfo(deviceInfo: string): this;
get disableBrowserFetching(): boolean;
set disableBrowserFetching(disableBrowserFetching: boolean);
getDisableBrowserFetching(): boolean;
setDisableBrowserFetching(disableBrowserFetching: boolean): this;
get disableNMLUrlCache(): boolean;
set disableNMLUrlCache(disableNMLUrlCache: boolean);
getDisableNMLUrlCache(): boolean;
setDisableNMLUrlCache(disableNMLUrlCache: boolean): this;
get displayName(): string;
set displayName(displayName: string);
getDisplayName(): string;
setDisplayName(displayName: string): this;
/** @undocumented */
get dontCloseBatches(): boolean;
/** @undocumented */
set dontCloseBatches(dontCloseBatches: boolean);
/** @undocumented */
getDontCloseBatches(): boolean;
/** @undocumented */
setDontCloseBatches(dontCloseBatches: boolean): this;
get enablePatterns(): boolean;
set enablePatterns(enablePatterns: boolean);
getEnablePatterns(): boolean;
setEnablePatterns(enablePatterns: boolean): this;
get environmentName(): string;
set environmentName(environmentName: string);
getEnvironmentName(): string;
setEnvironmentName(environmentName: string): this;
get forceFullPageScreenshot(): boolean;
set forceFullPageScreenshot(forceFullPageScreenshot: boolean);
getForceFullPageScreenshot(): boolean;
setForceFullPageScreenshot(forceFullPageScreenshot: boolean): this;
get gitMergeBaseTimestamp(): string;
set gitMergeBaseTimestamp(gitMergeBaseTimestamp: string);
getGitMergeBaseTimestamp(): string;
setGitMergeBaseTimestamp(gitMergeBaseTimestamp: string): this;
get latestCommitInfo(): LatestCommitInfo;
set latestCommitInfo(latestCommitInfo: LatestCommitInfo);
getLatestCommitInfo(): LatestCommitInfo;
setLatestCommitInfo(latestCommitInfo: LatestCommitInfo): this;
get hideCaret(): boolean;
set hideCaret(hideCaret: boolean);
getHideCaret(): boolean;
setHideCaret(hideCaret: boolean): this;
get hideScrollbars(): boolean;
set hideScrollbars(hideScrollbars: boolean);
getHideScrollbars(): boolean;
setHideScrollbars(hideScrollbars: boolean): this;
get hostApp(): string;
set hostApp(hostApp: string);
getHostApp(): string;
setHostApp(hostApp: string): this;
get hostAppInfo(): string;
set hostAppInfo(hostAppInfo: string);
getHostAppInfo(): string;
setHostAppInfo(hostAppInfo: string): this;
get hostOS(): string;
set hostOS(hostOS: string);
getHostOS(): string;
setHostOS(hostOS: string): this;
get hostOSInfo(): string;
set hostOSInfo(hostOSInfo: string);
getHostOSInfo(): string;
setHostOSInfo(hostOSInfo: string): this;
get ignoreBaseline(): boolean;
set ignoreBaseline(ignoreBaseline: boolean);
getIgnoreBaseline(): boolean;
setIgnoreBaseline(ignoreBaseline: boolean): this;
get ignoreCaret(): boolean;
set ignoreCaret(ignoreCaret: boolean);
getIgnoreCaret(): boolean;
setIgnoreCaret(ignoreCaret: boolean): this;
get ignoreDisplacements(): boolean;
set ignoreDisplacements(ignoreDisplacements: boolean);
getIgnoreDisplacements(): boolean;
setIgnoreDisplacements(ignoreDisplacements: boolean): this;
get ignoreGitMergeBase(): boolean;
set ignoreGitMergeBase(ignoreGitMergeBase: boolean);
getIgnoreGitMergeBase(): boolean;
setIgnoreGitMergeBase(ignoreGitMergeBase: boolean): this;
get isDisabled(): boolean;
set isDisabled(isDisabled: boolean);
getIsDisabled(): boolean;
setIsDisabled(isDisabled: boolean): this;
get layoutBreakpoints(): boolean | number[] | {
breakpoints: number[] | boolean;
reload?: boolean;
};
set layoutBreakpoints(layoutBreakpoints: boolean | number[] | {
breakpoints: number[] | boolean;
reload?: boolean;
});
getLayoutBreakpoints(): boolean | number[] | {
breakpoints: number[] | boolean;
reload?: boolean;
};
setLayoutBreakpoints(layoutBreakpoints: boolean | number[] | {
breakpoints: number[] | boolean;
reload?: boolean;
}): this;
get matchLevel(): MatchLevel;
set matchLevel(matchLevel: MatchLevel);
getMatchLevel(): MatchLevelEnum;
setMatchLevel(matchLevel: MatchLevel): this;
get matchTimeout(): number;
set matchTimeout(matchTimeout: number);
getMatchTimeout(): number;
setMatchTimeout(matchTimeout: number): this;
get mobileOptions(): {
keepNavigationBar?: boolean;
};
set mobileOptions(mobileOptions: {
keepNavigationBar?: boolean;
});
getMobileOptions(): {
keepNavigationBar?: boolean;
};
setMobileOptions(mobileOptions: {
keepNavigationBar?: boolean;
}): this;
get parentBranchName(): string;
set parentBranchName(parentBranchName: string);
getParentBranchName(): string;
setParentBranchName(parentBranchName: string): this;
get properties(): PropertyData[];
set properties(properties: PropertyData[]);
getProperties(): PropertyDataData[];
setProperties(properties: PropertyData[]): this;
addProperty(name: string, value: string): this;
addProperty(prop: PropertyData): this;
clearProperties(): this;
get proxy(): ProxySettings;
set proxy(proxy: ProxySettings);
getProxy(): ProxySettingsData;
setProxy(proxy: ProxySettings): this;
setProxy(url: string, username?: string, password?: string, deprecatedIsHttpOnly?: boolean): this;
setProxy(isEnabled: false): this;
/** @undocumented */
get removeSession(): boolean;
/** @undocumented */
set removeSession(removeSession: boolean);
/** @undocumented */
getRemoveSession(): boolean;
/** @undocumented */
setRemoveSession(removeSession: boolean): this;
get rotation(): ImageRotation;
set rotation(rotation: ImageRotation);
getRotation(): ImageRotationData;
setRotation(rotation: ImageRotation | ImageRotationData): this;
get saveDiffs(): boolean;
set saveDiffs(saveDiffs: boolean);
getSaveDiffs(): boolean;
setSaveDiffs(saveDiffs: boolean): this;
get saveFailedTests(): boolean;
set saveFailedTests(saveFailedTests: boolean);
getSaveFailedTests(): boolean;
setSaveFailedTests(saveFailedTests: boolean): this;
get saveNewTests(): boolean;
set saveNewTests(saveNewTests: boolean);
getSaveNewTests(): boolean;
setSaveNewTests(saveNewTests: boolean): this;
get scaleRatio(): number;
set scaleRatio(scaleRatio: number);
getScaleRatio(): number;
setScaleRatio(scaleRatio: number): this;
get scrollRootElement(): TSpec['element'] | EyesSelector<TSpec['selector']>;
set scrollRootElement(scrollRootElement: TSpec['element'] | EyesSelector<TSpec['selector']>);
getScrollRootElement(): TSpec['element'] | EyesSelector<TSpec['selector']>;
setScrollRootElement(scrollRootElement: TSpec['element'] | EyesSelector<TSpec['selector']>): this;
get sendDom(): boolean;
set sendDom(sendDom: boolean);
getSendDom(): boolean;
setSendDom(sendDom: boolean): this;
get serverUrl(): string;
set serverUrl(serverUrl: string);
getServerUrl(): string;
setServerUrl(serverUrl: string): this;
get sessionType(): SessionType;
set sessionType(sessionType: SessionType);
getSessionType(): SessionTypeEnum;
setSessionType(sessionType: SessionType): this;
get stitchMode(): StitchMode;
set stitchMode(stitchMode: StitchMode);
getStitchMode(): StitchModeEnum;
setStitchMode(stitchMode: StitchMode): this;
get stitchOverlap(): number;
set stitchOverlap(stitchOverlap: number);
getStitchOverlap(): number;
setStitchOverlap(stitchOverlap: number): this;
get testName(): string;
set testName(testName: string);
getTestName(): string;
setTestName(testName: string): this;
get useDom(): boolean;
set useDom(useDom: boolean);
getUseDom(): boolean;
setUseDom(useDom: boolean): this;
get viewportSize(): RectangleSize;
set viewportSize(viewportSize: RectangleSize);
getViewportSize(): RectangleSizeData;
setViewportSize(viewportSize: RectangleSize): this;
get visualGridOptions(): {
[key: string]: any;
};
set visualGridOptions(visualGridOptions: {
[key: string]: any;
});
getVisualGridOptions(): {
[key: string]: any;
};
setVisualGridOptions(visualGridOptions: {
[key: string]: any;
}): this;
setVisualGridOption(key: string, value: any): this;
get waitBeforeCapture(): number | (() => Promise<void>);
set waitBeforeCapture(waitBeforeCapture: number | (() => Promise<void>));
getWaitBeforeCapture(): number | (() => Promise<void>);
setWaitBeforeCapture(waitBeforeCapture: number | (() => Promise<void>)): this;
get waitBeforeScreenshots(): number;
set waitBeforeScreenshots(waitBeforeScreenshots: number);
getWaitBeforeScreenshots(): number;
setWaitBeforeScreenshots(waitBeforeScreenshots: number): this;
get fully(): boolean;
set fully(fully: boolean);
getFully(): boolean;
setFully(fully: boolean): this;
/** @internal */
toObject(): Configuration<TSpec>;
/** @internal */
toJSON(): Core.Config<TSpec, 'classic'> & Core.Config<TSpec, 'ufg'>;
/** @internal */
toString(): string;
}