@applitools/eyes-testcafe 1.14.3 → 1.15.3

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/types/index.d.ts CHANGED
@@ -1,2096 +1,1542 @@
1
+ export default Eyes;
2
+ export type Driver = TestController & { __applitoolsBrand?: never; };
3
+ export type Element = (globalThis.Selector | NodeSnapshot) & { __applitoolsBrand?: never; };
4
+ export type Selector = globalThis.Selector & { __applitoolsBrand?: never; };
5
+ export class Eyes {
6
+ static setViewportSize: (driver: Driver, viewportSize: RectangleSize) => Promise<void>;
7
+ constructor(runner?: EyesRunner, config?: ConfigurationPlain);
8
+ constructor(config?: ConfigurationPlain, runner?: EyesRunner);
9
+ constructor(options: { configPath: string; runner?: EyesRunner; });
10
+ get logger(): Logger;
11
+ getLogger(): Logger;
12
+ get runner(): EyesRunner;
13
+ getRunner(): EyesRunner;
14
+ get driver(): Driver;
15
+ getDriver(): Driver;
16
+ get configuration(): ConfigurationPlain;
17
+ set configuration(configuration: ConfigurationPlain);
18
+ getConfiguration(): Configuration;
19
+ setConfiguration(config: ConfigurationPlain): void;
20
+ get isOpen(): boolean;
21
+ getIsOpen(): boolean;
22
+ on(handler: (event: string, data?: Record<string, any>) => any): () => void;
23
+ on(event: "setSizeWillStart", handler: (data: { viewportSize: RectangleSizePlain; }) => any): () => void;
24
+ on(event: "setSizeEnded", handler: () => any): () => void;
25
+ on(event: "initStarted", handler: () => any): () => void;
26
+ on(event: "initEnded", handler: () => any): () => void;
27
+ on(event: "testStarted", handler: (data: { sessionId: string; }) => any): () => void;
28
+ on(event: "validationWillStart", handler: (data: { sessionId: string; validationInfo: ValidationInfoPlain; }) => any): () => void;
29
+ on(event: "validationEnded", handler: (data: { sessionId: string; validationId: number; validationResult: ValidationResultPlain; }) => any): () => void;
30
+ on(event: "testEnded", handler: (data: { sessionId: string; testResults: TestResultsPlain; }) => any): () => void;
31
+ off(event: string): void;
32
+ off(handler: (...args: Array<any>) => any): void;
33
+ open(driver: Driver, config?: ConfigurationPlain): Promise<Driver>;
34
+ open(driver: Driver, appName?: string, testName?: string, viewportSize?: RectangleSizePlain, sessionType?: SessionTypePlain): Promise<Driver>;
35
+ open(options: { t: Driver; } & TestCafeConfiguration): Promise<Driver>;
36
+ checkWindow(name?: string, timeout?: number, fully?: boolean): Promise<MatchResult>;
37
+ checkWindow(settings: TestCafeCheckSettings): Promise<MatchResult>;
38
+ checkFrame(element: number | Element | EyesSelector<Selector>, timeout?: number, name?: string): Promise<MatchResult>;
39
+ checkElement(element: Element, timeout?: number, name?: string): Promise<MatchResult>;
40
+ checkElementBy(selector: EyesSelector<Selector>, timeout?: number, name?: string): Promise<MatchResult>;
41
+ checkRegion(region?: RegionPlain, name?: string, timeout?: number): Promise<MatchResult>;
42
+ checkRegionByElement(element: Element, name?: string, timeout?: number): Promise<MatchResult>;
43
+ checkRegionBy(selector: EyesSelector<Selector>, name?: string, timeout?: number, fully?: boolean): Promise<MatchResult>;
44
+ checkRegionInFrame(frame: number | Element | EyesSelector<Selector>, selector: EyesSelector<Selector>, timeout?: number, name?: string, fully?: boolean): Promise<MatchResult>;
45
+ check(name: string, checkSettings: CheckSettings): Promise<MatchResult>;
46
+ check(checkSettings?: CheckSettingsPlain): Promise<MatchResult>;
47
+ locate<TLocator extends string>(settings: VisualLocatorSettings<TLocator>): Promise<Record<TLocator, Array<RegionPlain>>>;
48
+ extractTextRegions<TPattern extends string>(settings: OCRSettings<TPattern>): Promise<Record<TPattern, Array<TextRegion>>>;
49
+ extractText(regions: Array<OCRRegion>): Promise<Array<string>>;
50
+ close(throwErr?: boolean): Promise<TestResults>;
51
+ closeAsync(): Promise<void>;
52
+ abort(): Promise<TestResults>;
53
+ abortAsync(): Promise<void>;
54
+ abortIfNotClosed(): Promise<TestResultsPlain>;
55
+ getViewportSize(): Promise<RectangleSize>;
56
+ setViewportSize(size: RectangleSizePlain): Promise<void>;
57
+ getScrollRootElement(): Element | EyesSelector<Selector>;
58
+ setScrollRootElement(scrollRootElement: Element | EyesSelector<Selector>): void;
59
+ setLogHandler(handler: LogHandler): void;
60
+ getLogHandler(): LogHandler;
61
+ setCutProvider(cutProvider: CutProvider): void;
62
+ setImageCut(cutProvider: CutProvider): void;
63
+ getIsCutProviderExplicitlySet(): boolean;
64
+ getRotation(): ImageRotation;
65
+ setRotation(rotation: ImageRotationPlain | ImageRotation): void;
66
+ getScaleRatio(): number;
67
+ setScaleRatio(scaleRatio: number): void;
68
+ getSaveDebugScreenshots(): boolean;
69
+ setSaveDebugScreenshots(save: boolean): void;
70
+ getDebugScreenshotsPath(): string;
71
+ setDebugScreenshotsPath(path: string): void;
72
+ getDebugScreenshotsPrefix(): string;
73
+ setDebugScreenshotsPrefix(prefix: string): void;
74
+ addProperty(name: string, value: string): Configuration;
75
+ clearProperties(): Configuration;
76
+ getBatch(): BatchInfo;
77
+ setBatch(batch: BatchInfoPlain): void;
78
+ setBatch(name: string, id?: string, startedAt?: string | Date): void;
79
+ getApiKey(): string;
80
+ setApiKey(apiKey: string): void;
81
+ getTestName(): string;
82
+ setTestName(testName: string): void;
83
+ getAppName(): string;
84
+ setAppName(appName: string): void;
85
+ getBaselineBranchName(): string;
86
+ setBaselineBranchName(baselineBranchName: string): void;
87
+ getBaselineName(): string;
88
+ setBaselineName(baselineName: string): void;
89
+ getBaselineEnvName(): string;
90
+ setBaselineEnvName(baselineEnvName: string): void;
91
+ getBranchName(): string;
92
+ setBranchName(branchName: string): void;
93
+ getHostApp(): string;
94
+ setHostApp(hostApp: string): void;
95
+ getHostOS(): string;
96
+ setHostOS(hostOS: string): void;
97
+ getHostAppInfo(): string;
98
+ setHostAppInfo(hostAppInfo: string): void;
99
+ getHostOSInfo(): string;
100
+ setHostOSInfo(hostOSInfo: string): void;
101
+ getDeviceInfo(): string;
102
+ setDeviceInfo(deviceInfo: string): void;
103
+ setIgnoreCaret(ignoreCaret: boolean): void;
104
+ getIgnoreCaret(): boolean;
105
+ getIsDisabled(): boolean;
106
+ setIsDisabled(isDisabled: boolean): void;
107
+ getMatchLevel(): MatchLevel;
108
+ setMatchLevel(matchLevel: MatchLevelPlain): void;
109
+ getMatchTimeout(): number;
110
+ setMatchTimeout(matchTimeout: number): void;
111
+ getParentBranchName(): string;
112
+ setParentBranchName(parentBranchName: string): void;
113
+ setProxy(proxy: ProxySettingsPlain): void;
114
+ setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): void;
115
+ setProxy(isEnabled: false): void;
116
+ getProxy(): ProxySettings;
117
+ getSaveDiffs(): boolean;
118
+ setSaveDiffs(saveDiffs: boolean): void;
119
+ getSaveNewTests(): boolean;
120
+ setSaveNewTests(saveNewTests: boolean): void;
121
+ getServerUrl(): string;
122
+ setServerUrl(serverUrl: string): void;
123
+ getSendDom(): boolean;
124
+ setSendDom(sendDom: boolean): void;
125
+ getHideCaret(): boolean;
126
+ setHideCaret(hideCaret: boolean): void;
127
+ getHideScrollbars(): boolean;
128
+ setHideScrollbars(hideScrollbars: boolean): void;
129
+ getForceFullPageScreenshot(): boolean;
130
+ setForceFullPageScreenshot(forceFullPageScreenshot: boolean): void;
131
+ getWaitBeforeScreenshots(): number;
132
+ setWaitBeforeScreenshots(waitBeforeScreenshots: number): void;
133
+ getStitchMode(): StitchMode;
134
+ setStitchMode(stitchMode: StitchModePlain): void;
135
+ getStitchOverlap(): number;
136
+ setStitchOverlap(stitchOverlap: number): void;
137
+ getSessionEventHandlers(): SessionEventHandlers;
138
+ addSessionEventHandler(handler: SessionEventHandler): void;
139
+ removeSessionEventHandler(handler: SessionEventHandler): void;
140
+ clearSessionEventHandlers(): void;
141
+ waitForResults(throwErr: boolean): Promise<TestResultsSummary>;
142
+ }
143
+ export type ConfigurationPlain = {
144
+ logs?: LogHandlerPlain;
145
+ debugScreenshots?: { save: boolean; path?: string; prefix?: string; };
146
+ agentId?: string;
147
+ apiKey?: string;
148
+ serverUrl?: string;
149
+ proxy?: ProxySettingsPlain;
150
+ isDisabled?: boolean;
151
+ connectionTimeout?: number;
152
+ removeSession?: boolean;
153
+ remoteEvents?: { serverUrl: string; accessKey?: string; timeout?: number; };
154
+ appName?: string;
155
+ testName?: string;
156
+ displayName?: string;
157
+ viewportSize?: RectangleSizePlain;
158
+ sessionType?: SessionTypePlain;
159
+ properties?: Array<PropertyDataPlain>;
160
+ batch?: BatchInfoPlain;
161
+ defaultMatchSettings?: ImageMatchSettingsPlain;
162
+ hostApp?: string;
163
+ hostOS?: string;
164
+ hostAppInfo?: string;
165
+ hostOSInfo?: string;
166
+ deviceInfo?: string;
167
+ baselineEnvName?: string;
168
+ environmentName?: string;
169
+ branchName?: string;
170
+ parentBranchName?: string;
171
+ baselineBranchName?: string;
172
+ compareWithParentBranch?: boolean;
173
+ ignoreBaseline?: boolean;
174
+ ignoreGitMergeBase?: boolean;
175
+ saveFailedTests?: boolean;
176
+ saveNewTests?: boolean;
177
+ saveDiffs?: boolean;
178
+ dontCloseBatches?: boolean;
179
+ sendDom?: boolean;
180
+ matchTimeout?: number;
181
+ forceFullPageScreenshot?: boolean;
182
+ waitBeforeScreenshots?: number;
183
+ stitchMode?: StitchModePlain;
184
+ hideScrollbars?: boolean;
185
+ hideCaret?: boolean;
186
+ stitchOverlap?: number;
187
+ scrollRootElement?: Element | EyesSelector<Selector>;
188
+ cut?: CutProviderPlain;
189
+ rotation?: ImageRotationPlain;
190
+ scaleRatio?: number;
191
+ waitBeforeCapture?: number;
192
+ concurrentSessions?: number;
193
+ browsersInfo?: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo>;
194
+ visualGridOptions?: Record<string, any>;
195
+ layoutBreakpoints?: boolean | Array<number>;
196
+ disableBrowserFetching?: boolean;
197
+ };
198
+ export class Configuration implements Required<ConfigurationPlain> {
199
+ constructor(config?: ConfigurationPlain);
200
+ get logs(): LogHandlerPlain;
201
+ set logs(logs: LogHandlerPlain);
202
+ getShowLogs(): boolean;
203
+ setShowLogs(show: boolean): Configuration;
204
+ getLogHandler(): LogHandlerPlain;
205
+ setLogHandler(handler: LogHandlerPlain): Configuration;
206
+ get debugScreenshots(): { save: boolean; path?: string; prefix?: string; };
207
+ set debugScreenshots(debugScreenshots: { save: boolean; path?: string; prefix?: string; });
208
+ getSaveDebugScreenshots(): boolean;
209
+ setSaveDebugScreenshots(save: boolean): Configuration;
210
+ getDebugScreenshotsPath(): string;
211
+ setDebugScreenshotsPath(path: string): Configuration;
212
+ getDebugScreenshotsPrefix(): string;
213
+ setDebugScreenshotsPrefix(prefix: string): Configuration;
214
+ get appName(): string;
215
+ set appName(appName: string);
216
+ getAppName(): string;
217
+ setAppName(appName: string): Configuration;
218
+ get testName(): string;
219
+ set testName(testName: string);
220
+ getTestName(): string;
221
+ setTestName(testName: string): Configuration;
222
+ get displayName(): string;
223
+ set displayName(displayName: string);
224
+ getDisplayName(): string;
225
+ setDisplayName(displayName: string): Configuration;
226
+ get isDisabled(): boolean;
227
+ set isDisabled(isDisabled: boolean);
228
+ getIsDisabled(): boolean;
229
+ setIsDisabled(isDisabled: boolean): Configuration;
230
+ get matchTimeout(): number;
231
+ set matchTimeout(matchTimeout: number);
232
+ getMatchTimeout(): number;
233
+ setMatchTimeout(matchTimeout: number): Configuration;
234
+ get sessionType(): SessionTypePlain;
235
+ set sessionType(sessionType: SessionTypePlain);
236
+ getSessionType(): SessionType;
237
+ setSessionType(sessionType: SessionTypePlain): Configuration;
238
+ get viewportSize(): RectangleSizePlain;
239
+ set viewportSize(viewportSize: RectangleSizePlain);
240
+ getViewportSize(): RectangleSize;
241
+ setViewportSize(viewportSize: RectangleSizePlain): Configuration;
242
+ get agentId(): string;
243
+ set agentId(agentId: string);
244
+ getAgentId(): string;
245
+ setAgentId(agentId: string): Configuration;
246
+ get apiKey(): string;
247
+ set apiKey(apiKey: string);
248
+ getApiKey(): string;
249
+ setApiKey(apiKey: string): Configuration;
250
+ get serverUrl(): string;
251
+ set serverUrl(serverUrl: string);
252
+ getServerUrl(): string;
253
+ setServerUrl(serverUrl: string): Configuration;
254
+ get proxy(): ProxySettingsPlain;
255
+ set proxy(proxy: ProxySettingsPlain);
256
+ getProxy(): ProxySettings;
257
+ setProxy(proxy: ProxySettingsPlain): Configuration;
258
+ setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): Configuration;
259
+ setProxy(isEnabled: false): Configuration;
260
+ get connectionTimeout(): number;
261
+ set connectionTimeout(connectionTimeout: number);
262
+ getConnectionTimeout(): number;
263
+ setConnectionTimeout(connectionTimeout: number): Configuration;
264
+ get removeSession(): boolean;
265
+ set removeSession(removeSession: boolean);
266
+ getRemoveSession(): boolean;
267
+ setRemoveSession(removeSession: boolean): Configuration;
268
+ get remoteEvents(): { serverUrl: string; accessKey?: string; timeout?: number; };
269
+ set remoteEvents(remoteEvents: { serverUrl: string; accessKey?: string; timeout?: number; });
270
+ getRemoteEvents(): { serverUrl: string; accessKey?: string; timeout?: number; };
271
+ setRemoteEvents(remoteEvents: { serverUrl: string; accessKey?: string; timeout?: number; }): Configuration;
272
+ get batch(): BatchInfoPlain;
273
+ set batch(batch: BatchInfoPlain);
274
+ getBatch(): BatchInfo;
275
+ setBatch(batch: BatchInfoPlain): Configuration;
276
+ get properties(): Array<PropertyDataPlain>;
277
+ set properties(properties: Array<PropertyDataPlain>);
278
+ getProperties(): Array<PropertyData>;
279
+ setProperties(properties: Array<PropertyDataPlain>): Configuration;
280
+ addProperty(name: string, value: string): Configuration;
281
+ addProperty(prop: PropertyDataPlain): Configuration;
282
+ clearProperties(): Configuration;
283
+ get baselineEnvName(): string;
284
+ set baselineEnvName(baselineEnvName: string);
285
+ getBaselineEnvName(): string;
286
+ setBaselineEnvName(baselineEnvName: string): Configuration;
287
+ get environmentName(): string;
288
+ set environmentName(environmentName: string);
289
+ getEnvironmentName(): string;
290
+ setEnvironmentName(environmentName: string): Configuration;
291
+ get branchName(): string;
292
+ set branchName(branchName: string);
293
+ getBranchName(): string;
294
+ setBranchName(branchName: string): Configuration;
295
+ get parentBranchName(): string;
296
+ set parentBranchName(parentBranchName: string);
297
+ getParentBranchName(): string;
298
+ setParentBranchName(parentBranchName: string): Configuration;
299
+ get baselineBranchName(): string;
300
+ set baselineBranchName(baselineBranchName: string);
301
+ getBaselineBranchName(): string;
302
+ setBaselineBranchName(baselineBranchName: string): Configuration;
303
+ get compareWithParentBranch(): boolean;
304
+ set compareWithParentBranch(compareWithParentBranch: boolean);
305
+ getCompareWithParentBranch(): boolean;
306
+ setCompareWithParentBranch(compareWithParentBranch: boolean): Configuration;
307
+ get ignoreGitMergeBase(): boolean;
308
+ set ignoreGitMergeBase(ignoreGitMergeBase: boolean);
309
+ getIgnoreGitMergeBase(): boolean;
310
+ setIgnoreGitMergeBase(ignoreGitMergeBase: boolean): Configuration;
311
+ get ignoreBaseline(): boolean;
312
+ set ignoreBaseline(ignoreBaseline: boolean);
313
+ getIgnoreBaseline(): boolean;
314
+ setIgnoreBaseline(ignoreBaseline: boolean): Configuration;
315
+ get saveFailedTests(): boolean;
316
+ set saveFailedTests(saveFailedTests: boolean);
317
+ getSaveFailedTests(): boolean;
318
+ setSaveFailedTests(saveFailedTests: boolean): Configuration;
319
+ get saveNewTests(): boolean;
320
+ set saveNewTests(saveNewTests: boolean);
321
+ getSaveNewTests(): boolean;
322
+ setSaveNewTests(saveNewTests: boolean): Configuration;
323
+ get saveDiffs(): boolean;
324
+ set saveDiffs(saveDiffs: boolean);
325
+ getSaveDiffs(): boolean;
326
+ setSaveDiffs(saveDiffs: boolean): Configuration;
327
+ get sendDom(): boolean;
328
+ set sendDom(sendDom: boolean);
329
+ getSendDom(): boolean;
330
+ setSendDom(sendDom: boolean): Configuration;
331
+ get hostApp(): string;
332
+ set hostApp(hostApp: string);
333
+ getHostApp(): string;
334
+ setHostApp(hostApp: string): Configuration;
335
+ get hostOS(): string;
336
+ set hostOS(hostOS: string);
337
+ getHostOS(): string;
338
+ setHostOS(hostOS: string): Configuration;
339
+ get hostAppInfo(): string;
340
+ set hostAppInfo(hostAppInfo: string);
341
+ getHostAppInfo(): string;
342
+ setHostAppInfo(hostAppInfo: string): Configuration;
343
+ get hostOSInfo(): string;
344
+ set hostOSInfo(hostOSInfo: string);
345
+ getHostOSInfo(): string;
346
+ setHostOSInfo(hostOSInfo: string): Configuration;
347
+ get deviceInfo(): string;
348
+ set deviceInfo(deviceInfo: string);
349
+ getDeviceInfo(): string;
350
+ setDeviceInfo(deviceInfo: string): Configuration;
351
+ get defaultMatchSettings(): ImageMatchSettingsPlain;
352
+ set defaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain);
353
+ getDefaultMatchSettings(): ImageMatchSettingsPlain;
354
+ setDefaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain): Configuration;
355
+ getMatchLevel(): MatchLevel;
356
+ setMatchLevel(matchLevel: MatchLevelPlain): Configuration;
357
+ getAccessibilityValidation(): AccessibilitySettings;
358
+ setAccessibilityValidation(accessibilityValidation: AccessibilitySettings): Configuration;
359
+ getUseDom(): boolean;
360
+ setUseDom(useDom: boolean): Configuration;
361
+ getEnablePatterns(): boolean;
362
+ setEnablePatterns(enablePatterns: boolean): Configuration;
363
+ getIgnoreDisplacements(): boolean;
364
+ setIgnoreDisplacements(ignoreDisplacements: boolean): Configuration;
365
+ getIgnoreCaret(): boolean;
366
+ setIgnoreCaret(ignoreCaret: boolean): Configuration;
367
+ get forceFullPageScreenshot(): boolean;
368
+ set forceFullPageScreenshot(forceFullPageScreenshot: boolean);
369
+ getForceFullPageScreenshot(): boolean;
370
+ setForceFullPageScreenshot(forceFullPageScreenshot: boolean): Configuration;
371
+ get waitBeforeScreenshots(): number;
372
+ set waitBeforeScreenshots(waitBeforeScreenshots: number);
373
+ getWaitBeforeScreenshots(): number;
374
+ setWaitBeforeScreenshots(waitBeforeScreenshots: number): Configuration;
375
+ get waitBeforeCapture(): number;
376
+ set waitBeforeCapture(waitBeforeCapture: number);
377
+ getWaitBeforeCapture(): number;
378
+ setWaitBeforeCapture(waitBeforeCapture: number): Configuration;
379
+ get stitchMode(): StitchModePlain;
380
+ set stitchMode(stitchMode: StitchModePlain);
381
+ getStitchMode(): StitchMode;
382
+ setStitchMode(stitchMode: StitchModePlain): Configuration;
383
+ get hideScrollbars(): boolean;
384
+ set hideScrollbars(hideScrollbars: boolean);
385
+ getHideScrollbars(): boolean;
386
+ setHideScrollbars(hideScrollbars: boolean): Configuration;
387
+ get hideCaret(): boolean;
388
+ set hideCaret(hideCaret: boolean);
389
+ getHideCaret(): boolean;
390
+ setHideCaret(hideCaret: boolean): Configuration;
391
+ get stitchOverlap(): number;
392
+ set stitchOverlap(stitchOverlap: number);
393
+ getStitchOverlap(): number;
394
+ setStitchOverlap(stitchOverlap: number): Configuration;
395
+ get scrollRootElement(): Element | EyesSelector<Selector>;
396
+ set scrollRootElement(scrollRootElement: Element | EyesSelector<Selector>);
397
+ getScrollRootElement(): Element | EyesSelector<Selector>;
398
+ setScrollRootElement(scrollRootElement: Element | EyesSelector<Selector>): Configuration;
399
+ get cut(): CutProviderPlain;
400
+ set cut(cut: CutProviderPlain);
401
+ getCut(): CutProviderPlain;
402
+ setCut(cut: CutProviderPlain): Configuration;
403
+ get rotation(): ImageRotationPlain;
404
+ set rotation(rotation: ImageRotationPlain);
405
+ getRotation(): ImageRotation;
406
+ setRotation(rotation: ImageRotationPlain | ImageRotation): Configuration;
407
+ get scaleRatio(): number;
408
+ set scaleRatio(scaleRatio: number);
409
+ getScaleRatio(): number;
410
+ setScaleRatio(scaleRatio: number): Configuration;
411
+ get concurrentSessions(): number;
412
+ set concurrentSessions(concurrentSessions: number);
413
+ getConcurrentSessions(): number;
414
+ setConcurrentSessions(concurrentSessions: number): Configuration;
415
+ get browsersInfo(): Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo>;
416
+ set browsersInfo(browsersInfo: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo>);
417
+ getBrowsersInfo(): Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }>;
418
+ setBrowsersInfo(browsersInfo: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }>): Configuration;
419
+ addBrowsers(...browsersInfo: Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }>): Configuration;
420
+ addBrowser(browserInfo: DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }): Configuration;
421
+ addBrowser(width: number, height: number, name?: BrowserTypePlain): Configuration;
422
+ addDeviceEmulation(deviceName: DeviceNamePlain, screenOrientation?: ScreenOrientationPlain): Configuration;
423
+ get visualGridOptions(): { [key: string]: any; };
424
+ set visualGridOptions(visualGridOptions: { [key: string]: any; });
425
+ getVisualGridOptions(): { [key: string]: any; };
426
+ setVisualGridOptions(visualGridOptions: { [key: string]: any; }): Configuration;
427
+ setVisualGridOption(key: string, value: any): Configuration;
428
+ get layoutBreakpoints(): boolean | Array<number>;
429
+ set layoutBreakpoints(layoutBreakpoints: boolean | Array<number>);
430
+ getLayoutBreakpoints(): boolean | Array<number>;
431
+ setLayoutBreakpoints(layoutBreakpoints: boolean | Array<number>): Configuration;
432
+ get disableBrowserFetching(): boolean;
433
+ set disableBrowserFetching(disableBrowserFetching: boolean);
434
+ getDisableBrowserFetching(): boolean;
435
+ setDisableBrowserFetching(disableBrowserFetching: boolean): Configuration;
436
+ get dontCloseBatches(): boolean;
437
+ set dontCloseBatches(dontCloseBatches: boolean);
438
+ getDontCloseBatches(): boolean;
439
+ setDontCloseBatches(dontCloseBatches: boolean): Configuration;
440
+ }
441
+ export type OCRRegion = { target: Element | RegionPlain | EyesSelector<Selector>; hint?: string; minMatch?: number; language?: string; };
442
+ export type CheckSettingsPlain = {
443
+ name?: string;
444
+ region?: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
445
+ frames?: Array<{ frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }); } | (number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>;
446
+ scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; });
447
+ fully?: boolean;
448
+ matchLevel?: MatchLevelPlain;
449
+ useDom?: boolean;
450
+ sendDom?: boolean;
451
+ enablePatterns?: boolean;
452
+ ignoreDisplacements?: boolean;
453
+ ignoreCaret?: boolean;
454
+ ignoreRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
455
+ layoutRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
456
+ strictRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
457
+ contentRegions?: Array<RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))>;
458
+ floatingRegions?: Array<(RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | {
459
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
460
+ maxUpOffset?: number;
461
+ maxDownOffset?: number;
462
+ maxLeftOffset?: number;
463
+ maxRightOffset?: number;
464
+ }>;
465
+ accessibilityRegions?: Array<(RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | { region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); type?: AccessibilityRegionTypePlain; }>;
466
+ disableBrowserFetching?: boolean;
467
+ layoutBreakpoints?: boolean | Array<number>;
468
+ visualGridOptions?: { [key: string]: any; };
469
+ hooks?: { beforeCaptureScreenshot: string; };
470
+ renderId?: string;
471
+ variationGroupId?: string;
472
+ timeout?: number;
473
+ waitBeforeCapture?: number;
474
+ };
475
+ export class CheckSettings {
476
+ constructor(settings?: CheckSettingsPlain);
477
+ name(name: string): CheckSettings;
478
+ withName(name: string): CheckSettings;
479
+ region(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
480
+ shadow(selector: string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }): CheckSettings;
481
+ frame(context: { frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }); }): CheckSettings;
482
+ frame(frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })), scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })): CheckSettings;
483
+ ignoreRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
484
+ ignoreRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
485
+ ignore(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
486
+ ignores(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
487
+ layoutRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
488
+ layoutRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
489
+ strictRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
490
+ strictRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
491
+ contentRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
492
+ contentRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
493
+ floatingRegion(region: {
494
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
495
+ maxUpOffset?: number;
496
+ maxDownOffset?: number;
497
+ maxLeftOffset?: number;
498
+ maxRightOffset?: number;
499
+ }): CheckSettings;
500
+ floatingRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))), maxUpOffset?: number, maxDownOffset?: number, maxLeftOffset?: number, maxRightOffset?: number): CheckSettings;
501
+ floatingRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | {
502
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
503
+ maxUpOffset?: number;
504
+ maxDownOffset?: number;
505
+ maxLeftOffset?: number;
506
+ maxRightOffset?: number;
507
+ }>): CheckSettings;
508
+ floatingRegions(maxOffset: number, ...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
509
+ floating(region: {
510
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
511
+ maxUpOffset?: number;
512
+ maxDownOffset?: number;
513
+ maxLeftOffset?: number;
514
+ maxRightOffset?: number;
515
+ }): CheckSettings;
516
+ floating(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
517
+ floatings(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | {
518
+ region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }));
519
+ maxUpOffset?: number;
520
+ maxDownOffset?: number;
521
+ maxLeftOffset?: number;
522
+ maxRightOffset?: number;
523
+ }>): CheckSettings;
524
+ floatings(maxOffset: number, ...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
525
+ accessibilityRegion(region: { region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); type?: AccessibilityRegionTypePlain; }): CheckSettings;
526
+ accessibilityRegion(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))), type?: AccessibilityRegionTypePlain): CheckSettings;
527
+ accessibilityRegions(...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }))) | { region: RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); type?: AccessibilityRegionTypePlain; }>): CheckSettings;
528
+ accessibilityRegions(type: AccessibilityRegionTypePlain, ...regions: Array<LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))>): CheckSettings;
529
+ scrollRootElement(scrollRootElement: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })): CheckSettings;
530
+ fully(fully?: boolean): CheckSettings;
531
+ stitchContent(stitchContent?: boolean): CheckSettings;
532
+ matchLevel(matchLevel: MatchLevelPlain): CheckSettings;
533
+ layout(): CheckSettings;
534
+ exact(): CheckSettings;
535
+ strict(): CheckSettings;
536
+ content(): CheckSettings;
537
+ useDom(useDom?: boolean): CheckSettings;
538
+ sendDom(sendDom?: boolean): CheckSettings;
539
+ enablePatterns(enablePatterns?: boolean): CheckSettings;
540
+ ignoreDisplacements(ignoreDisplacements?: boolean): CheckSettings;
541
+ ignoreCaret(ignoreCaret?: boolean): CheckSettings;
542
+ disableBrowserFetching(disableBrowserFetching: boolean): CheckSettings;
543
+ layoutBreakpoints(layoutBreakpoints?: boolean | Array<number>): CheckSettings;
544
+ hook(name: string, script: string): CheckSettings;
545
+ beforeRenderScreenshotHook(script: string): CheckSettings;
546
+ webHook(script: string): CheckSettings;
547
+ visualGridOption(key: string, value: any): CheckSettings;
548
+ visualGridOptions(options: { [key: string]: any; }): CheckSettings;
549
+ renderId(renderId: string): CheckSettings;
550
+ variationGroupId(variationGroupId: string): CheckSettings;
551
+ timeout(timeout: number): CheckSettings;
552
+ waitBeforeCapture(waitBeforeCapture: number): CheckSettings;
553
+ }
554
+ export const Target: {
555
+ window(): CheckSettings;
556
+ region(region: LegacyRegionPlain | (RegionPlain | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })))): CheckSettings;
557
+ frame(context: { frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })); scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }); }): CheckSettings;
558
+ frame(frame: number | (Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })), scrollRootElement?: Element | (string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; })): CheckSettings;
559
+ shadow(selector: string | Selector | { selector: string | Selector; type?: string; shadow?: EyesSelector<Selector>; frame?: EyesSelector<Selector>; }): CheckSettings;
560
+ };
561
+ export class BatchClose {
562
+ static close(settings: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }): Promise<void>;
563
+ constructor(options?: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; });
564
+ close(): Promise<void>;
565
+ setBatchIds(batchIds: Array<string>): BatchClose;
566
+ setUrl(serverUrl: string): BatchClose;
567
+ setApiKey(apiKey: string): BatchClose;
568
+ setProxy(proxy: ProxySettingsPlain): BatchClose;
569
+ }
570
+ export type TestCafeConfiguration = {
571
+ appName?: string;
572
+ testName?: string;
573
+ browser?: DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo | Array<DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo>;
574
+ batchId?: string;
575
+ batchName?: string;
576
+ batchSequenceName?: string;
577
+ batchSequence?: string;
578
+ baselineEnvName?: string;
579
+ envName?: string;
580
+ proxy?: string | ProxySettingsPlain;
581
+ ignoreCaret?: boolean;
582
+ matchLevel?: MatchLevel;
583
+ baselineBranchName?: string;
584
+ baselineBranch?: string;
585
+ parentBranchName?: string;
586
+ parentBranch?: string;
587
+ branchName?: string;
588
+ branch?: string;
589
+ saveDiffs?: boolean;
590
+ saveFailedTests?: boolean;
591
+ saveNewTests?: boolean;
592
+ properties?: Array<{ name: string; value: any; }>;
593
+ compareWithParentBranch?: boolean;
594
+ ignoreBaseline?: boolean;
595
+ accessibilityValidation?: AccessibilitySettings;
596
+ notifyOnCompletion?: boolean;
597
+ batchNotify?: boolean;
598
+ isDisabled?: boolean;
599
+ ignoreDisplacements?: boolean;
600
+ concurrency?: number;
601
+ failTestcafeOnDiff?: boolean;
602
+ tapDirPath?: string;
603
+ };
604
+ export type TestCafeCheckSettings = {
605
+ tag?: string;
606
+ target?: "window" | "region";
607
+ fully?: boolean;
608
+ selector?: Selector;
609
+ region?: RegionPlain;
610
+ ignore?: (Selector | RegionPlain | { selector: Selector; }) | Array<Selector | RegionPlain | { selector: Selector; }>;
611
+ floating?: ((Selector | RegionPlain | { selector: Selector; }) & { maxUpOffset?: number; maxDownOffset?: number; maxLeftOffset?: number; maxRightOffset?: number; }) | Array<(Selector | RegionPlain | { selector: Selector; }) & { maxUpOffset?: number; maxDownOffset?: number; maxLeftOffset?: number; maxRightOffset?: number; }>;
612
+ layout?: (Selector | RegionPlain | { selector: Selector; }) | Array<Selector | RegionPlain | { selector: Selector; }>;
613
+ content?: (Selector | RegionPlain | { selector: Selector; }) | Array<Selector | RegionPlain | { selector: Selector; }>;
614
+ strict?: (Selector | RegionPlain | { selector: Selector; }) | Array<Selector | RegionPlain | { selector: Selector; }>;
615
+ accessibility?: ((Selector | RegionPlain | { selector: Selector; }) & { accessibilityType: AccessibilityRegionType; }) | Array<(Selector | RegionPlain | { selector: Selector; }) & { accessibilityType: AccessibilityRegionType; }>;
616
+ scriptHooks?: { beforeCaptureScreenshot: string; };
617
+ sendDom?: boolean;
618
+ ignoreDisplacements?: boolean;
619
+ };
620
+ export type AccessibilityGuidelinesVersionPlain = "WCAG_2_0" | "WCAG_2_1";
1
621
  export enum AccessibilityGuidelinesVersion {
2
- WCAG_2_0 = 'WCAG_2_0',
3
- WCAG_2_1 = 'WCAG_2_1',
622
+ WCAG_2_0 = 'WCAG_2_0',
623
+ WCAG_2_1 = 'WCAG_2_1'
4
624
  }
5
-
625
+ export type AccessibilityLevelPlain = "AA" | "AAA";
6
626
  export enum AccessibilityLevel {
7
- AA = 'AA',
8
- AAA = 'AAA',
627
+ AA = 'AA',
628
+ AAA = 'AAA'
9
629
  }
10
-
630
+ export type AccessibilityRegionTypePlain = "IgnoreContrast" | "RegularText" | "LargeText" | "BoldText" | "GraphicalObject";
11
631
  export enum AccessibilityRegionType {
12
- BoldText = 'BoldText',
13
- GraphicalObject = 'GraphicalObject',
14
- IgnoreContrast = 'IgnoreContrast',
15
- LargeText = 'LargeText',
16
- RegularText = 'RegularText',
632
+ IgnoreContrast = 'IgnoreContrast',
633
+ RegularText = 'RegularText',
634
+ LargeText = 'LargeText',
635
+ BoldText = 'BoldText',
636
+ GraphicalObject = 'GraphicalObject'
17
637
  }
18
-
638
+ export type AccessibilityStatusPlain = "Passed" | "Failed";
19
639
  export enum AccessibilityStatus {
20
- Failed = 'Failed',
21
- Passed = 'Passed',
640
+ Passed = 'Passed',
641
+ Failed = 'Failed'
22
642
  }
23
-
643
+ export type BrowserTypePlain = "chrome" | "chrome-one-version-back" | "chrome-two-versions-back" | "firefox" | "firefox-one-version-back" | "firefox-two-versions-back" | "ie" | "ie10" | "edge" | "edgechromium" | "edgelegacy" | "edgechromium-one-version-back" | "edgechromium-two-versions-back" | "safari" | "safari-earlyaccess" | "safari-one-version-back" | "safari-two-versions-back";
24
644
  export enum BrowserType {
25
- CHROME = 'chrome',
26
- CHROME_ONE_VERSION_BACK = 'chrome-one-version-back',
27
- CHROME_TWO_VERSIONS_BACK = 'chrome-two-versions-back',
28
- EDGE = 'edge',
29
- EDGE_CHROMIUM = 'edgechromium',
30
- EDGE_CHROMIUM_ONE_VERSION_BACK = 'edgechromium-one-version-back',
31
- EDGE_CHROMIUM_TWO_VERSIONS_BACK = 'edgechromium-two-versions-back',
32
- EDGE_LEGACY = 'edgelegacy',
33
- FIREFOX = 'firefox',
34
- FIREFOX_ONE_VERSION_BACK = 'firefox-one-version-back',
35
- FIREFOX_TWO_VERSIONS_BACK = 'firefox-two-versions-back',
36
- IE_10 = 'ie10',
37
- IE_11 = 'ie',
38
- SAFARI = 'safari',
39
- SAFARI_EARLY_ACCESS = 'safari-earlyaccess',
40
- SAFARI_ONE_VERSION_BACK = 'safari-one-version-back',
41
- SAFARI_TWO_VERSIONS_BACK = 'safari-two-versions-back',
645
+ CHROME = 'chrome',
646
+ CHROME_ONE_VERSION_BACK = 'chrome-one-version-back',
647
+ CHROME_TWO_VERSIONS_BACK = 'chrome-two-versions-back',
648
+ FIREFOX = 'firefox',
649
+ FIREFOX_ONE_VERSION_BACK = 'firefox-one-version-back',
650
+ FIREFOX_TWO_VERSIONS_BACK = 'firefox-two-versions-back',
651
+ IE_11 = 'ie',
652
+ IE_10 = 'ie10',
653
+ EDGE = 'edge',
654
+ EDGE_CHROMIUM = 'edgechromium',
655
+ EDGE_LEGACY = 'edgelegacy',
656
+ EDGE_CHROMIUM_ONE_VERSION_BACK = 'edgechromium-one-version-back',
657
+ EDGE_CHROMIUM_TWO_VERSIONS_BACK = 'edgechromium-two-versions-back',
658
+ SAFARI = 'safari',
659
+ SAFARI_EARLY_ACCESS = 'safari-earlyaccess',
660
+ SAFARI_ONE_VERSION_BACK = 'safari-one-version-back',
661
+ SAFARI_TWO_VERSIONS_BACK = 'safari-two-versions-back'
42
662
  }
43
-
44
- /** @undocumented */
663
+ export type CorsIframeHandlePlain = "BLANK" | "KEEP" | "SNAPSHOT";
45
664
  export enum CorsIframeHandle {
46
- BLANK = 'BLANK',
47
- KEEP = 'KEEP',
48
- SNAPSHOT = 'SNAPSHOT',
665
+ BLANK = 'BLANK',
666
+ KEEP = 'KEEP',
667
+ SNAPSHOT = 'SNAPSHOT'
49
668
  }
50
-
669
+ export type DeviceNamePlain = "Blackberry PlayBook" | "BlackBerry Z30" | "Galaxy A5" | "Galaxy Note 10" | "Galaxy Note 10 Plus" | "Galaxy Note 2" | "Galaxy Note 3" | "Galaxy Note 4" | "Galaxy Note 8" | "Galaxy Note 9" | "Galaxy S3" | "Galaxy S5" | "Galaxy S8" | "Galaxy S8 Plus" | "Galaxy S9" | "Galaxy S9 Plus" | "Galaxy S10" | "Galaxy S10 Plus" | "Galaxy S20" | "Galaxy Tab S7" | "iPad" | "iPad 6th Gen" | "iPad 7th Gen" | "iPad Air 2" | "iPad Mini" | "iPad Pro" | "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone 4" | "iPhone 5/SE" | "iPhone 6/7/8" | "iPhone 6/7/8 Plus" | "iPhone X" | "iPhone XR" | "iPhone XS" | "iPhone XS Max" | "Kindle Fire HDX" | "Laptop with HiDPI screen" | "Laptop with MDPI screen" | "Laptop with touch" | "LG G6" | "LG Optimus L70" | "Microsoft Lumia 550" | "Microsoft Lumia 950" | "Nexus 10" | "Nexus 4" | "Nexus 5" | "Nexus 5X" | "Nexus 6" | "Nexus 6P" | "Nexus 7" | "Nokia Lumia 520" | "Nokia N9" | "OnePlus 7T" | "OnePlus 7T Pro" | "Pixel 2" | "Pixel 2 XL" | "Pixel 3" | "Pixel 3 XL" | "Pixel 4" | "Pixel 4 XL" | "Pixel 5";
51
670
  export enum DeviceName {
52
- BlackBerry_Z30 = 'BlackBerry Z30',
53
- Blackberry_PlayBook = 'Blackberry PlayBook',
54
- Galaxy_A5 = 'Galaxy A5',
55
- Galaxy_Note_10 = 'Galaxy Note 10',
56
- Galaxy_Note_10_Plus = 'Galaxy Note 10 Plus',
57
- Galaxy_Note_2 = 'Galaxy Note 2',
58
- Galaxy_Note_3 = 'Galaxy Note 3',
59
- Galaxy_Note_4 = 'Galaxy Note 4',
60
- Galaxy_Note_8 = 'Galaxy Note 8',
61
- Galaxy_Note_9 = 'Galaxy Note 9',
62
- Galaxy_S10 = 'Galaxy S10',
63
- Galaxy_S10_Plus = 'Galaxy S10 Plus',
64
- Galaxy_S3 = 'Galaxy S3',
65
- Galaxy_S5 = 'Galaxy S5',
66
- Galaxy_S8 = 'Galaxy S8',
67
- Galaxy_S8_Plus = 'Galaxy S8 Plus',
68
- Galaxy_S9 = 'Galaxy S9',
69
- Galaxy_S9_Plus = 'Galaxy S9 Plus',
70
- Kindle_Fire_HDX = 'Kindle Fire HDX',
71
- LG_G6 = 'LG G6',
72
- LG_Optimus_L70 = 'LG Optimus L70',
73
- Laptop_with_HiDPI_screen = 'Laptop with HiDPI screen',
74
- Laptop_with_MDPI_screen = 'Laptop with MDPI screen',
75
- Laptop_with_touch = 'Laptop with touch',
76
- Microsoft_Lumia_550 = 'Microsoft Lumia 550',
77
- Microsoft_Lumia_950 = 'Microsoft Lumia 950',
78
- Nexus_10 = 'Nexus 10',
79
- Nexus_4 = 'Nexus 4',
80
- Nexus_5 = 'Nexus 5',
81
- Nexus_5X = 'Nexus 5X',
82
- Nexus_6 = 'Nexus 6',
83
- Nexus_6P = 'Nexus 6P',
84
- Nexus_7 = 'Nexus 7',
85
- Nokia_Lumia_520 = 'Nokia Lumia 520',
86
- Nokia_N9 = 'Nokia N9',
87
- OnePlus_7T = 'OnePlus 7T',
88
- OnePlus_7T_Pro = 'OnePlus 7T Pro',
89
- Pixel_2 = 'Pixel 2',
90
- Pixel_2_XL = 'Pixel 2 XL',
91
- Pixel_3 = 'Pixel 3',
92
- Pixel_3_XL = 'Pixel 3 XL',
93
- Pixel_4 = 'Pixel 4',
94
- Pixel_4_XL = 'Pixel 4 XL',
95
- iPad = 'iPad',
96
- iPad_6th_Gen = 'iPad 6th Gen',
97
- iPad_7th_Gen = 'iPad 7th Gen',
98
- iPad_Air_2 = 'iPad Air 2',
99
- iPad_Mini = 'iPad Mini',
100
- iPad_Pro = 'iPad Pro',
101
- iPhone_11 = 'iPhone 11',
102
- iPhone_11_Pro = 'iPhone 11 Pro',
103
- iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
104
- iPhone_4 = 'iPhone 4',
105
- iPhone_5SE = 'iPhone 5/SE',
106
- iPhone_6_7_8 = 'iPhone 6/7/8',
107
- iPhone_6_7_8_Plus = 'iPhone 6/7/8 Plus',
108
- iPhone_X = 'iPhone X',
109
- iPhone_XR = 'iPhone XR',
110
- iPhone_XS = 'iPhone XS',
111
- iPhone_XS_Max = 'iPhone XS Max',
671
+ Blackberry_PlayBook = 'Blackberry PlayBook',
672
+ BlackBerry_Z30 = 'BlackBerry Z30',
673
+ Galaxy_A5 = 'Galaxy A5',
674
+ Galaxy_Note_10 = 'Galaxy Note 10',
675
+ Galaxy_Note_10_Plus = 'Galaxy Note 10 Plus',
676
+ Galaxy_Note_2 = 'Galaxy Note 2',
677
+ Galaxy_Note_3 = 'Galaxy Note 3',
678
+ Galaxy_Note_4 = 'Galaxy Note 4',
679
+ Galaxy_Note_8 = 'Galaxy Note 8',
680
+ Galaxy_Note_9 = 'Galaxy Note 9',
681
+ Galaxy_S3 = 'Galaxy S3',
682
+ Galaxy_S5 = 'Galaxy S5',
683
+ Galaxy_S8 = 'Galaxy S8',
684
+ Galaxy_S8_Plus = 'Galaxy S8 Plus',
685
+ Galaxy_S9 = 'Galaxy S9',
686
+ Galaxy_S9_Plus = 'Galaxy S9 Plus',
687
+ Galaxy_S10 = 'Galaxy S10',
688
+ Galaxy_S10_Plus = 'Galaxy S10 Plus',
689
+ Galaxy_S20 = 'Galaxy S20',
690
+ Galaxy_Tab_S7 = 'Galaxy Tab S7',
691
+ iPad = 'iPad',
692
+ iPad_6th_Gen = 'iPad 6th Gen',
693
+ iPad_7th_Gen = 'iPad 7th Gen',
694
+ iPad_Air_2 = 'iPad Air 2',
695
+ iPad_Mini = 'iPad Mini',
696
+ iPad_Pro = 'iPad Pro',
697
+ iPhone_11 = 'iPhone 11',
698
+ iPhone_11_Pro = 'iPhone 11 Pro',
699
+ iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
700
+ iPhone_4 = 'iPhone 4',
701
+ iPhone_5SE = 'iPhone 5/SE',
702
+ iPhone_6_7_8 = 'iPhone 6/7/8',
703
+ iPhone_6_7_8_Plus = 'iPhone 6/7/8 Plus',
704
+ iPhone_X = 'iPhone X',
705
+ iPhone_XR = 'iPhone XR',
706
+ iPhone_XS = 'iPhone XS',
707
+ iPhone_XS_Max = 'iPhone XS Max',
708
+ Kindle_Fire_HDX = 'Kindle Fire HDX',
709
+ Laptop_with_HiDPI_screen = 'Laptop with HiDPI screen',
710
+ Laptop_with_MDPI_screen = 'Laptop with MDPI screen',
711
+ Laptop_with_touch = 'Laptop with touch',
712
+ LG_G6 = 'LG G6',
713
+ LG_Optimus_L70 = 'LG Optimus L70',
714
+ Microsoft_Lumia_550 = 'Microsoft Lumia 550',
715
+ Microsoft_Lumia_950 = 'Microsoft Lumia 950',
716
+ Nexus_10 = 'Nexus 10',
717
+ Nexus_4 = 'Nexus 4',
718
+ Nexus_5 = 'Nexus 5',
719
+ Nexus_5X = 'Nexus 5X',
720
+ Nexus_6 = 'Nexus 6',
721
+ Nexus_6P = 'Nexus 6P',
722
+ Nexus_7 = 'Nexus 7',
723
+ Nokia_Lumia_520 = 'Nokia Lumia 520',
724
+ Nokia_N9 = 'Nokia N9',
725
+ OnePlus_7T = 'OnePlus 7T',
726
+ OnePlus_7T_Pro = 'OnePlus 7T Pro',
727
+ Pixel_2 = 'Pixel 2',
728
+ Pixel_2_XL = 'Pixel 2 XL',
729
+ Pixel_3 = 'Pixel 3',
730
+ Pixel_3_XL = 'Pixel 3 XL',
731
+ Pixel_4 = 'Pixel 4',
732
+ Pixel_4_XL = 'Pixel 4 XL',
733
+ Pixel_5 = 'Pixel 5'
112
734
  }
113
-
735
+ export type FailureReportPlain = "IMMEDIATE" | "ON_CLOSE";
114
736
  export enum FailureReport {
115
- IMMEDIATE = 'IMMEDIATE',
116
- ON_CLOSE = 'ON_CLOSE',
737
+ IMMEDIATE = 'IMMEDIATE',
738
+ ON_CLOSE = 'ON_CLOSE'
117
739
  }
118
-
740
+ export type IosDeviceNamePlain = "iPhone 11" | "iPhone 11 Pro" | "iPhone 11 Pro Max" | "iPhone X" | "iPhone XR" | "iPhone 13 Pro Max" | "iPhone 13 Pro" | "iPhone 13" | "iPhone 12 Pro Max" | "iPhone 12 Pro" | "iPhone 12" | "iPhone 12 mini" | "iPhone Xs" | "iPhone 8" | "iPhone 7" | "iPad Pro (12.9-inch) (3rd generation)" | "iPad (7th generation)" | "iPad (9th generation)" | "iPad Air (2nd generation)" | "iPad Air (4th generation)";
119
741
  export enum IosDeviceName {
120
- iPad_7 = 'iPad (7th generation)',
121
- iPad_Air_2 = 'iPad Air (2nd generation)',
122
- iPad_Pro_3 = 'iPad Pro (12.9-inch) (3rd generation)',
123
- iPhone_11 = 'iPhone 11',
124
- iPhone_11_Pro = 'iPhone 11 Pro',
125
- iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
126
- iPhone_7 = 'iPhone 7',
127
- iPhone_8 = 'iPhone 8',
128
- iPhone_X = 'iPhone X',
129
- iPhone_XR = 'iPhone XR',
130
- iPhone_XS = 'iPhone Xs',
742
+ iPhone_13_Pro_Max = 'iPhone 13 Pro Max',
743
+ iPhone_13_Pro = 'iPhone 13 Pro',
744
+ iPhone_13 = 'iPhone 13',
745
+ iPhone_12_Pro_Max = 'iPhone 12 Pro Max',
746
+ iPhone_12_Pro = 'iPhone 12 Pro',
747
+ iPhone_12 = 'iPhone 12',
748
+ iPhone_12_mini = 'iPhone 12 mini',
749
+ iPhone_11_Pro = 'iPhone 11 Pro',
750
+ iPhone_11_Pro_Max = 'iPhone 11 Pro Max',
751
+ iPhone_11 = 'iPhone 11',
752
+ iPhone_XR = 'iPhone XR',
753
+ iPhone_XS = 'iPhone Xs',
754
+ iPhone_X = 'iPhone X',
755
+ iPhone_8 = 'iPhone 8',
756
+ iPhone_7 = 'iPhone 7',
757
+ iPad_Pro_3 = 'iPad Pro (12.9-inch) (3rd generation)',
758
+ iPad_7 = 'iPad (7th generation)',
759
+ iPad_9 = 'iPad (9th generation)',
760
+ iPad_Air_2 = 'iPad Air (2nd generation)',
761
+ iPad_Air_4 = 'iPad Air (4th generation)'
131
762
  }
132
-
763
+ export type IosVersionPlain = "latest" | "latest-1";
133
764
  export enum IosVersion {
134
- LATEST = 'latest',
135
- /** @deprecated */
136
- LATEST_ONE_VERSION_BACK = 'latest-1',
137
- ONE_VERSION_BACK = 'latest-1',
765
+ LATEST = 'latest',
766
+ ONE_VERSION_BACK = 'latest-1',
767
+ LATEST_ONE_VERSION_BACK = 'latest-1'
138
768
  }
139
-
769
+ export type MatchLevelPlain = "None" | "Layout1" | "Layout" | "Layout2" | "Content" | "Strict" | "Exact";
140
770
  export enum MatchLevel {
141
- Content = 'Content',
142
- Exact = 'Exact',
143
- Layout = 'Layout',
144
- Layout2 = 'Layout2',
145
- LegacyLayout = 'Layout1',
146
- None = 'None',
147
- Strict = 'Strict',
771
+ None = 'None',
772
+ LegacyLayout = 'Layout1',
773
+ Layout = 'Layout',
774
+ Layout2 = 'Layout2',
775
+ Content = 'Content',
776
+ Strict = 'Strict',
777
+ Exact = 'Exact'
148
778
  }
149
-
779
+ export type ScreenOrientationPlain = "portrait" | "landscape";
150
780
  export enum ScreenOrientation {
151
- LANDSCAPE = 'landscape',
152
- PORTRAIT = 'portrait',
781
+ PORTRAIT = 'portrait',
782
+ LANDSCAPE = 'landscape'
153
783
  }
154
-
784
+ export type SessionTypePlain = "SEQUENTIAL" | "PROGRESSION";
155
785
  export enum SessionType {
156
- PROGRESSION = 'PROGRESSION',
157
- SEQUENTIAL = 'SEQUENTIAL',
786
+ SEQUENTIAL = 'SEQUENTIAL',
787
+ PROGRESSION = 'PROGRESSION'
158
788
  }
159
-
789
+ export type StitchModePlain = "Scroll" | "CSS";
160
790
  export enum StitchMode {
161
- CSS = 'CSS',
162
- SCROLL = 'Scroll',
791
+ SCROLL = 'Scroll',
792
+ CSS = 'CSS'
163
793
  }
164
-
794
+ export type TestResultsStatusPlain = "Passed" | "Failed" | "Unresolved";
165
795
  export enum TestResultsStatus {
166
- Failed = 'Failed',
167
- Passed = 'Passed',
168
- Unresolved = 'Unresolved',
169
- }
170
-
171
- export class AccessibilityMatchSettings implements Required<AccessibilityMatchSettingsPlain> {
172
- constructor(settings: AccessibilityMatchSettingsPlain);
173
- constructor(region: RegionPlain);
174
- constructor(
175
- x: number,
176
- y: number,
177
- width: number,
178
- height: number,
179
- type?: 'IgnoreContrast' | 'RegularText' | 'LargeText' | 'BoldText' | 'GraphicalObject',
180
- );
181
- get region(): RegionPlain;
182
- set region(region: RegionPlain);
183
- get type(): 'IgnoreContrast' | 'RegularText' | 'LargeText' | 'BoldText' | 'GraphicalObject';
184
- set type(type: 'IgnoreContrast' | 'RegularText' | 'LargeText' | 'BoldText' | 'GraphicalObject');
185
- getHeight(): number;
186
- getLeft(): number;
187
- getRegion(): Region;
188
- getTop(): number;
189
- getType(): AccessibilityRegionType;
190
- getWidth(): number;
191
- setHeight(height: number): void;
192
- setLeft(left: number): void;
193
- setRegion(region: RegionPlain): void;
194
- setTop(top: number): void;
195
- setType(type: AccessibilityRegionType): void;
196
- setWidth(width: number): void;
796
+ Passed = 'Passed',
797
+ Unresolved = 'Unresolved',
798
+ Failed = 'Failed'
197
799
  }
198
-
199
- export class ApiUrls implements Required<ApiUrlsPlain> {
200
- get baselineImage(): string;
201
- get checkpointImage(): string;
202
- get checkpointImageThumbnail(): string;
203
- get currentImage(): string;
204
- get diffImage(): string;
205
- getBaselineImage(): string;
206
- getCheckpointImage(): string;
207
- getCheckpointImageThumbnail(): string;
208
- getCurrentImage(): string;
209
- getDiffImage(): string;
210
- /** @deprecated */
211
- setBaselineImage(setBaselineImage: string): void;
212
- /** @deprecated */
213
- setCheckpointImage(checkpointImage: string): void;
214
- /** @deprecated */
215
- setCheckpointImageThumbnail(checkpointImageThumbnail: string): void;
216
- /** @deprecated */
217
- setCurrentImage(currentImage: string): void;
218
- /** @deprecated */
219
- setDiffImage(diffImage: string): void;
800
+ export class EyesError extends Error {
220
801
  }
221
-
222
- export class AppUrls implements Required<AppUrlsPlain> {
223
- get step(): string;
224
- get stepEditor(): string;
225
- getStep(): string;
226
- getStepEditor(): string;
227
- /** @deprecated */
228
- setStep(step: string): void;
229
- /** @deprecated */
230
- setStepEditor(stepEditor: string): void;
802
+ export class TestFailedError extends EyesError {
803
+ constructor(message: string, results?: TestResultsPlain);
804
+ constructor(results: TestResultsPlain);
805
+ get testResults(): TestResultsPlain;
806
+ getTestResults(): TestResults;
231
807
  }
232
-
233
- export class BatchClose {
234
- constructor(options?: {batchIds: string[]; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain});
235
- close(): Promise<void>;
236
- setApiKey(apiKey: string): this;
237
- setBatchIds(batchIds: string[]): this;
238
- setProxy(proxy: ProxySettingsPlain): this;
239
- setUrl(serverUrl: string): this;
240
- static close(options: {
241
- batchIds: string[];
242
- serverUrl?: string;
243
- apiKey?: string;
244
- proxy?: ProxySettingsPlain;
245
- }): Promise<void>;
808
+ export class DiffsFoundError extends TestFailedError {
809
+ constructor(message: string, results?: TestResultsPlain);
810
+ constructor(results: TestResultsPlain);
246
811
  }
247
-
248
- export class BatchInfo implements Required<BatchInfoPlain> {
249
- constructor();
250
- constructor(batch?: BatchInfoPlain);
251
- constructor(name?: string, startedAt?: string | Date, id?: string);
252
- get id(): string;
253
- set id(id: string);
254
- get name(): string;
255
- set name(name: string);
256
- get notifyOnCompletion(): boolean;
257
- set notifyOnCompletion(notifyOnCompletion: boolean);
258
- get properties(): PropertyDataPlain[];
259
- set properties(properties: PropertyDataPlain[]);
260
- get sequenceName(): string;
261
- set sequenceName(sequenceName: string);
262
- get startedAt(): string | Date;
263
- set startedAt(startedAt: string | Date);
264
- addProperty(property: PropertyDataPlain): this;
265
- getId(): string;
266
- getName(): string;
267
- getNotifyOnCompletion(): boolean;
268
- getProperties(): PropertyData[];
269
- getSequenceName(): string;
270
- getStartedAt(): Date | string;
271
- setId(id: string): this;
272
- setName(name: string): this;
273
- setNotifyOnCompletion(notifyOnCompletion: boolean): this;
274
- setProperties(properties: PropertyDataPlain[]): this;
275
- setSequenceName(sequenceName: string): this;
276
- setStartedAt(startedAt: Date): this;
277
- setStartedAt(startedAt: string): this;
812
+ export class NewTestError extends TestFailedError {
813
+ constructor(message: string, results?: TestResultsPlain);
814
+ constructor(results: TestResultsPlain);
278
815
  }
279
-
280
- export class CheckSettings {
281
- constructor(settings?: CheckSettingsPlain);
282
- accessibilityRegion(region: {region: RegionPlain | Element | Selector; type?: AccessibilityRegionTypePlain}): this;
283
- accessibilityRegion(region: RegionPlain, type?: AccessibilityRegionType): this;
284
- accessibilityRegion(region: Element, type?: AccessibilityRegionType): this;
285
- accessibilityRegion(region: Selector, type?: AccessibilityRegionType): this;
286
- accessibilityRegions(
287
- ...regions: (
288
- | {region: RegionPlain | Element | Selector; type?: AccessibilityRegionTypePlain}
289
- | RegionPlain
290
- | Element
291
- | Selector
292
- )[]
293
- ): this;
294
- accessibilityRegions(type: AccessibilityRegionType, ...regions: (RegionPlain | Element | Selector)[]): this;
295
- beforeRenderScreenshotHook(script: string): this;
296
- content(): this;
297
- contentRegion(region: RegionPlain): this;
298
- contentRegion(region: Element): this;
299
- contentRegion(region: Selector): this;
300
- contentRegions(...regions: (RegionPlain | Element | Selector)[]): this;
301
- disableBrowserFetching(disableBrowserFetching: boolean): this;
302
- enablePatterns(enablePatterns?: boolean): this;
303
- exact(): this;
304
- /** @deprecated */
305
- floating(region: {
306
- region: RegionPlain | Element | Selector;
307
- maxUpOffset?: number;
308
- maxDownOffset?: number;
309
- maxLeftOffset?: number;
310
- maxRightOffset?: number;
311
- }): this;
312
- /** @deprecated */
313
- floating(region: RegionPlain): this;
314
- /** @deprecated */
315
- floating(region: Element): this;
316
- /** @deprecated */
317
- floating(region: Selector): this;
318
- floatingRegion(region: {
319
- region: RegionPlain | Element | Selector;
320
- maxUpOffset?: number;
321
- maxDownOffset?: number;
322
- maxLeftOffset?: number;
323
- maxRightOffset?: number;
324
- }): this;
325
- floatingRegion(
326
- region: RegionPlain,
327
- maxUpOffset?: number,
328
- maxDownOffset?: number,
329
- maxLeftOffset?: number,
330
- maxRightOffset?: number,
331
- ): this;
332
- floatingRegion(
333
- region: Element,
334
- maxUpOffset?: number,
335
- maxDownOffset?: number,
336
- maxLeftOffset?: number,
337
- maxRightOffset?: number,
338
- ): this;
339
- floatingRegion(
340
- region: Selector,
341
- maxUpOffset?: number,
342
- maxDownOffset?: number,
343
- maxLeftOffset?: number,
344
- maxRightOffset?: number,
345
- ): this;
346
- floatingRegions(
347
- ...regions: (
348
- | {
349
- region: RegionPlain | Element | Selector;
350
- maxUpOffset?: number;
351
- maxDownOffset?: number;
352
- maxLeftOffset?: number;
353
- maxRightOffset?: number;
354
- }
355
- | RegionPlain
356
- | Element
357
- | Selector
358
- )[]
359
- ): this;
360
- floatingRegions(maxOffset: number, ...regions: (RegionPlain | Element | Selector)[]): this;
361
- /** @deprecated */
362
- floatings(
363
- ...regions: (
364
- | {
365
- region: RegionPlain | Element | Selector;
366
- maxUpOffset?: number;
367
- maxDownOffset?: number;
368
- maxLeftOffset?: number;
369
- maxRightOffset?: number;
370
- }
371
- | RegionPlain
372
- | Element
373
- | Selector
374
- )[]
375
- ): this;
376
- /** @deprecated */
377
- floatings(maxOffset: number, ...regions: (RegionPlain | Element | Selector)[]): this;
378
- frame(context: {frame: Element | Selector | string | number; scrollRootElement?: Element | Selector}): this;
379
- frame(frame: Element, scrollRootElement?: Element): this;
380
- frame(frame: Element, scrollRootElement?: Selector): this;
381
- frame(frame: Selector, scrollRootElement?: Element): this;
382
- frame(frame: Selector, scrollRootElement?: Selector): this;
383
- frame(frame: string, scrollRootElement?: Element): this;
384
- frame(frame: string, scrollRootElement?: Selector): this;
385
- frame(frame: number, scrollRootElement?: Element): this;
386
- frame(frame: number, scrollRootElement?: Selector): this;
387
- fully(fully?: boolean): this;
388
- hook(name: string, script: string): this;
389
- /** @deprecated */
390
- ignore(ignoreRegion: RegionPlain): this;
391
- /** @deprecated */
392
- ignore(ignoreRegion: Element): this;
393
- /** @deprecated */
394
- ignore(ignoreRegion: Selector): this;
395
- ignoreCaret(ignoreCaret?: boolean): this;
396
- ignoreDisplacements(ignoreDisplacements?: boolean): this;
397
- ignoreRegion(ignoreRegion: RegionPlain): this;
398
- ignoreRegion(ignoreRegion: Element): this;
399
- ignoreRegion(ignoreRegion: Selector): this;
400
- ignoreRegions(...ignoreRegions: (RegionPlain | Element | Selector)[]): this;
401
- /** @deprecated */
402
- ignores(...ignoreRegions: (RegionPlain | Element | Selector)[]): this;
403
- layout(): this;
404
- layoutBreakpoints(layoutBreakpoints?: boolean): this;
405
- layoutBreakpoints(layoutBreakpoints?: number[]): this;
406
- layoutRegion(layoutRegion: RegionPlain): this;
407
- layoutRegion(layoutRegion: Element): this;
408
- layoutRegion(layoutRegion: Selector): this;
409
- layoutRegions(...layoutRegions: (RegionPlain | Element | Selector)[]): this;
410
- matchLevel(matchLevel: MatchLevel): this;
411
- /** @undocumented */
412
- name(name: string): this;
413
- region(region: RegionPlain): this;
414
- region(region: Element): this;
415
- region(region: Selector): this;
416
- renderId(renderId: string): this;
417
- scrollRootElement(scrollRootElement: Element): this;
418
- scrollRootElement(scrollRootElement: Selector): this;
419
- sendDom(sendDom?: boolean): this;
420
- /** @deprecated */
421
- stitchContent(stitchContent?: boolean): this;
422
- strict(): this;
423
- strictRegion(strictRegion: RegionPlain): this;
424
- strictRegion(strictRegion: Element): this;
425
- strictRegion(strictRegion: Selector): this;
426
- strictRegions(...regions: (RegionPlain | Element | Selector)[]): this;
427
- timeout(timeout: number): this;
428
- useDom(useDom?: boolean): this;
429
- variationGroupId(variationGroupId: string): this;
430
- visualGridOption(key: string, value: any): this;
431
- visualGridOptions(options: {[key: string]: any}): this;
432
- /** @deprecated */
433
- webHook(script: string): this;
434
- withName(name: string): this;
816
+ export type AccessibilityMatchSettingsPlain = { region: RegionPlain; type?: AccessibilityRegionTypePlain; };
817
+ export class AccessibilityMatchSettings implements Required<AccessibilityMatchSettingsPlain> {
818
+ constructor(settings: AccessibilityMatchSettingsPlain);
819
+ constructor(region: RegionPlain);
820
+ constructor(x: number, y: number, width: number, height: number, type?: AccessibilityRegionTypePlain);
821
+ get region(): RegionPlain;
822
+ set region(region: RegionPlain);
823
+ getRegion(): Region;
824
+ setRegion(region: RegionPlain): void;
825
+ getLeft(): number;
826
+ setLeft(left: number): void;
827
+ getTop(): number;
828
+ setTop(top: number): void;
829
+ getWidth(): number;
830
+ setWidth(width: number): void;
831
+ getHeight(): number;
832
+ setHeight(height: number): void;
833
+ get type(): AccessibilityRegionTypePlain;
834
+ set type(type: AccessibilityRegionTypePlain);
835
+ getType(): AccessibilityRegionType;
836
+ setType(type: AccessibilityRegionTypePlain): void;
435
837
  }
436
-
437
- export class ClassicRunner extends EyesRunner {}
438
-
439
- export class Configuration {
440
- constructor(config?: ConfigurationPlain);
441
- get agentId(): string;
442
- set agentId(agentId: string);
443
- get apiKey(): string;
444
- set apiKey(apiKey: string);
445
- get appName(): string;
446
- set appName(appName: string);
447
- get baselineBranchName(): string;
448
- set baselineBranchName(baselineBranchName: string);
449
- get baselineEnvName(): string;
450
- set baselineEnvName(baselineEnvName: string);
451
- get batch(): BatchInfoPlain;
452
- set batch(batch: BatchInfoPlain);
453
- get branchName(): string;
454
- set branchName(branchName: string);
455
- get browsersInfo(): (DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo)[];
456
- set browsersInfo(browsersInfo: (DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo)[]);
457
- get compareWithParentBranch(): boolean;
458
- set compareWithParentBranch(compareWithParentBranch: boolean);
459
- /** @undocumented */
460
- get concurrentSessions(): number;
461
- /** @undocumented */
462
- set concurrentSessions(concurrentSessions: number);
463
- /** @undocumented */
464
- get connectionTimeout(): number;
465
- /** @undocumented */
466
- set connectionTimeout(connectionTimeout: number);
467
- get cut(): CutProviderPlain;
468
- set cut(cut: CutProviderPlain);
469
- /** @undocumented */
470
- get debugScreenshots(): {save: boolean; path?: string; prefix?: string};
471
- /** @undocumented */
472
- set debugScreenshots(debugScreenshots: {save: boolean; path?: string; prefix?: string});
473
- get defaultMatchSettings(): ImageMatchSettingsPlain;
474
- set defaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain);
475
- get deviceInfo(): string;
476
- set deviceInfo(deviceInfo: string);
477
- get disableBrowserFetching(): boolean;
478
- set disableBrowserFetching(disableBrowserFetching: boolean);
479
- get displayName(): string;
480
- set displayName(displayName: string);
481
- /** @undocumented */
482
- get dontCloseBatches(): boolean;
483
- /** @undocumented */
484
- set dontCloseBatches(dontCloseBatches: boolean);
485
- get environmentName(): string;
486
- set environmentName(environmentName: string);
487
- get forceFullPageScreenshot(): boolean;
488
- set forceFullPageScreenshot(forceFullPageScreenshot: boolean);
489
- get hideCaret(): boolean;
490
- set hideCaret(hideCaret: boolean);
491
- get hideScrollbars(): boolean;
492
- set hideScrollbars(hideScrollbars: boolean);
493
- get hostApp(): string;
494
- set hostApp(hostApp: string);
495
- get hostAppInfo(): string;
496
- set hostAppInfo(hostAppInfo: string);
497
- get hostOS(): string;
498
- set hostOS(hostOS: string);
499
- get hostOSInfo(): string;
500
- set hostOSInfo(hostOSInfo: string);
501
- get ignoreBaseline(): boolean;
502
- set ignoreBaseline(ignoreBaseline: boolean);
503
- get isDisabled(): boolean;
504
- set isDisabled(isDisabled: boolean);
505
- get layoutBreakpoints(): boolean | number[];
506
- set layoutBreakpoints(layoutBreakpoints: boolean | number[]);
507
- /** @undocumented */
508
- get logs(): LogHandlerPlain;
509
- /** @undocumented */
510
- set logs(logs: LogHandlerPlain);
511
- get matchTimeout(): number;
512
- set matchTimeout(matchTimeout: number);
513
- get parentBranchName(): string;
514
- set parentBranchName(parentBranchName: string);
515
- get properties(): PropertyDataPlain[];
516
- set properties(properties: PropertyDataPlain[]);
517
- get proxy(): ProxySettingsPlain;
518
- set proxy(proxy: ProxySettingsPlain);
519
- /** @undocumented */
520
- get remoteEvents(): {accessKey?: string; serverUrl: string; timeout?: number};
521
- /** @undocumented */
522
- set remoteEvents(remoteEvents: {accessKey?: string; serverUrl: string; timeout?: number});
523
- /** @undocumented */
524
- get removeSession(): boolean;
525
- /** @undocumented */
526
- set removeSession(removeSession: boolean);
527
- get rotation(): ImageRotationPlain;
528
- set rotation(rotation: ImageRotationPlain);
529
- get saveDiffs(): boolean;
530
- set saveDiffs(saveDiffs: boolean);
531
- get saveFailedTests(): boolean;
532
- set saveFailedTests(saveFailedTests: boolean);
533
- get saveNewTests(): boolean;
534
- set saveNewTests(saveNewTests: boolean);
535
- get scaleRatio(): number;
536
- set scaleRatio(scaleRatio: number);
537
- get scrollRootElement(): Element | Selector;
538
- set scrollRootElement(scrollRootElement: Element | Selector);
539
- get sendDom(): boolean;
540
- set sendDom(sendDom: boolean);
541
- get serverUrl(): string;
542
- set serverUrl(serverUrl: string);
543
- get sessionType(): 'SEQUENTIAL' | 'PROGRESSION';
544
- set sessionType(sessionType: 'SEQUENTIAL' | 'PROGRESSION');
545
- get stitchMode(): 'Scroll' | 'CSS';
546
- set stitchMode(stitchMode: 'Scroll' | 'CSS');
547
- get stitchOverlap(): number;
548
- set stitchOverlap(stitchOverlap: number);
549
- get testName(): string;
550
- set testName(testName: string);
551
- get viewportSize(): RectangleSizePlain;
552
- set viewportSize(viewportSize: RectangleSizePlain);
553
- get visualGridOptions(): {[key: string]: any};
554
- set visualGridOptions(visualGridOptions: {[key: string]: any});
555
- get waitBeforeScreenshots(): number;
556
- set waitBeforeScreenshots(waitBeforeScreenshots: number);
557
- addBrowser(browserInfo: DesktopBrowserInfo): this;
558
- addBrowser(browserInfo: ChromeEmulationInfo): this;
559
- addBrowser(browserInfo: IOSDeviceInfo): this;
560
- addBrowser(browserInfo: {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}): this;
561
- addBrowser(width: number, height: number, name?: BrowserType): this;
562
- addBrowsers(
563
- ...browsersInfo: (
564
- | DesktopBrowserInfo
565
- | ChromeEmulationInfo
566
- | IOSDeviceInfo
567
- | {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}
568
- )[]
569
- ): this;
570
- addDeviceEmulation(deviceName: DeviceName, screenOrientation?: ScreenOrientation): this;
571
- addProperty(name: string, value: string): this;
572
- addProperty(prop: PropertyDataPlain): this;
573
- clearProperties(): this;
574
- getAccessibilityValidation(): AccessibilitySettings;
575
- getAgentId(): string;
576
- getApiKey(): string;
577
- getAppName(): string;
578
- getBaselineBranchName(): string;
579
- getBaselineEnvName(): string;
580
- getBatch(): BatchInfo;
581
- getBranchName(): string;
582
- getBrowsersInfo(): (
583
- | DesktopBrowserInfo
584
- | ChromeEmulationInfo
585
- | IOSDeviceInfo
586
- | {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}
587
- )[];
588
- getCompareWithParentBranch(): boolean;
589
- /** @undocumented */
590
- getConcurrentSessions(): number;
591
- /** @undocumented */
592
- getConnectionTimeout(): number;
593
- getCut(): CutProviderPlain;
594
- /** @undocumented */
595
- getDebugScreenshotsPath(): string;
596
- /** @undocumented */
597
- getDebugScreenshotsPrefix(): string;
598
- getDefaultMatchSettings(): ImageMatchSettingsPlain;
599
- getDeviceInfo(): string;
600
- getDisableBrowserFetching(): boolean;
601
- getDisplayName(): string;
602
- /** @undocumented */
603
- getDontCloseBatches(): boolean;
604
- getEnablePatterns(): boolean;
605
- getEnvironmentName(): string;
606
- getForceFullPageScreenshot(): boolean;
607
- getHideCaret(): boolean;
608
- getHideScrollbars(): boolean;
609
- getHostApp(): string;
610
- getHostAppInfo(): string;
611
- getHostOS(): string;
612
- getHostOSInfo(): string;
613
- getIgnoreBaseline(): boolean;
614
- getIgnoreCaret(): boolean;
615
- getIgnoreDisplacements(): boolean;
616
- getIsDisabled(): boolean;
617
- getLayoutBreakpoints(): boolean | number[];
618
- /** @undocumented */
619
- getLogHandler(): LogHandlerPlain;
620
- getMatchLevel(): MatchLevel;
621
- getMatchTimeout(): number;
622
- getParentBranchName(): string;
623
- getProperties(): PropertyData[];
624
- getProxy(): ProxySettings;
625
- /** @undocumented */
626
- getRemoteEvents(): {serverUrl: string; accessKey?: string; timeout?: number};
627
- /** @undocumented */
628
- getRemoveSession(): boolean;
629
- getRotation(): ImageRotation;
630
- /** @undocumented */
631
- getSaveDebugScreenshots(): boolean;
632
- getSaveDiffs(): boolean;
633
- getSaveFailedTests(): boolean;
634
- getSaveNewTests(): boolean;
635
- getScaleRatio(): number;
636
- getScrollRootElement(): Element | Selector;
637
- getSendDom(): boolean;
638
- getServerUrl(): string;
639
- getSessionType(): SessionType;
640
- /** @undocumented */
641
- getShowLogs(): boolean;
642
- getStitchMode(): StitchMode;
643
- getStitchOverlap(): number;
644
- getTestName(): string;
645
- getUseDom(): boolean;
646
- getViewportSize(): RectangleSize;
647
- getVisualGridOptions(): {[key: string]: any};
648
- getWaitBeforeScreenshots(): number;
649
- setAccessibilityValidation(accessibilityValidation: AccessibilitySettings): this;
650
- setAgentId(agentId: string): this;
651
- setApiKey(apiKey: string): this;
652
- setAppName(appName: string): this;
653
- setBaselineBranchName(baselineBranchName: string): this;
654
- setBaselineEnvName(baselineEnvName: string): this;
655
- setBatch(batch: BatchInfoPlain): this;
656
- setBranchName(branchName: string): this;
657
- setBrowsersInfo(
658
- browsersInfo: (
659
- | DesktopBrowserInfo
660
- | ChromeEmulationInfo
661
- | IOSDeviceInfo
662
- | {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain}
663
- )[],
664
- ): this;
665
- setCompareWithParentBranch(compareWithParentBranch: boolean): this;
666
- /** @undocumented */
667
- setConcurrentSessions(concurrentSessions: number): this;
668
- /** @undocumented */
669
- setConnectionTimeout(connectionTimeout: number): this;
670
- setCut(cut: CutProviderPlain): this;
671
- /** @undocumented */
672
- setDebugScreenshotsPath(path: string): this;
673
- /** @undocumented */
674
- setDebugScreenshotsPrefix(prefix: string): this;
675
- setDefaultMatchSettings(defaultMatchSettings: ImageMatchSettingsPlain): this;
676
- setDeviceInfo(deviceInfo: string): this;
677
- setDisableBrowserFetching(disableBrowserFetching: boolean): this;
678
- setDisplayName(displayName: string): this;
679
- /** @undocumented */
680
- setDontCloseBatches(dontCloseBatches: boolean): this;
681
- setEnablePatterns(enablePatterns: boolean): this;
682
- setEnvironmentName(environmentName: string): this;
683
- setForceFullPageScreenshot(forceFullPageScreenshot: boolean): this;
684
- setHideCaret(hideCaret: boolean): this;
685
- setHideScrollbars(hideScrollbars: boolean): this;
686
- setHostApp(hostApp: string): this;
687
- setHostAppInfo(hostAppInfo: string): this;
688
- setHostOS(hostOS: string): this;
689
- setHostOSInfo(hostOSInfo: string): this;
690
- setIgnoreBaseline(ignoreBaseline: boolean): this;
691
- setIgnoreCaret(ignoreCaret: boolean): this;
692
- setIgnoreDisplacements(ignoreDisplacements: boolean): this;
693
- setIsDisabled(isDisabled: boolean): this;
694
- setLayoutBreakpoints(layoutBreakpoints: boolean): this;
695
- setLayoutBreakpoints(layoutBreakpoints: number[]): this;
696
- /** @undocumented */
697
- setLogHandler(handler: LogHandlerPlain): this;
698
- setMatchLevel(matchLevel: MatchLevel): this;
699
- setMatchTimeout(matchTimeout: number): this;
700
- setParentBranchName(parentBranchName: string): this;
701
- setProperties(properties: PropertyDataPlain[]): this;
702
- setProxy(proxy: ProxySettingsPlain): this;
703
- setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): this;
704
- setProxy(isEnabled: false): this;
705
- /** @undocumented */
706
- setRemoteEvents(remoteEvents: {serverUrl: string; accessKey?: string; timeout?: number}): this;
707
- /** @undocumented */
708
- setRemoveSession(removeSession: boolean): this;
709
- setRotation(rotation: ImageRotationPlain): this;
710
- setRotation(rotation: ImageRotation): this;
711
- /** @undocumented */
712
- setSaveDebugScreenshots(save: boolean): this;
713
- setSaveDiffs(saveDiffs: boolean): this;
714
- setSaveFailedTests(saveFailedTests: boolean): this;
715
- setSaveNewTests(saveNewTests: boolean): this;
716
- setScaleRatio(scaleRatio: number): this;
717
- setScrollRootElement(scrollRootElement: Element): this;
718
- setScrollRootElement(scrollRootElement: Selector): this;
719
- setSendDom(sendDom: boolean): this;
720
- setServerUrl(serverUrl: string): this;
721
- setSessionType(sessionType: SessionType): this;
722
- /** @undocumented */
723
- setShowLogs(show: boolean): this;
724
- setStitchMode(stitchMode: StitchMode): this;
725
- setStitchOverlap(stitchOverlap: number): this;
726
- setTestName(testName: string): this;
727
- setUseDom(useDom: boolean): this;
728
- setViewportSize(viewportSize: RectangleSizePlain): this;
729
- setVisualGridOption(key: string, value: any): this;
730
- setVisualGridOptions(visualGridOptions: {[key: string]: any}): this;
731
- setWaitBeforeScreenshots(waitBeforeScreenshots: number): this;
838
+ export type AccessibilitySettings = { level?: AccessibilityLevelPlain; guidelinesVersion?: AccessibilityGuidelinesVersionPlain; };
839
+ export type BatchInfoPlain = {
840
+ id?: string;
841
+ name?: string;
842
+ sequenceName?: string;
843
+ startedAt?: string | Date;
844
+ notifyOnCompletion?: boolean;
845
+ properties?: Array<PropertyDataPlain>;
846
+ };
847
+ export class BatchInfo implements Required<BatchInfoPlain> {
848
+ constructor();
849
+ constructor(batch?: BatchInfoPlain);
850
+ constructor(name?: string, startedAt?: string | Date, id?: string);
851
+ get id(): string;
852
+ set id(id: string);
853
+ getId(): string;
854
+ setId(id: string): BatchInfo;
855
+ get name(): string;
856
+ set name(name: string);
857
+ getName(): string;
858
+ setName(name: string): BatchInfo;
859
+ get sequenceName(): string;
860
+ set sequenceName(sequenceName: string);
861
+ getSequenceName(): string;
862
+ setSequenceName(sequenceName: string): BatchInfo;
863
+ get startedAt(): string | Date;
864
+ set startedAt(startedAt: string | Date);
865
+ getStartedAt(): string | Date;
866
+ setStartedAt(startedAt: string | Date): BatchInfo;
867
+ get notifyOnCompletion(): boolean;
868
+ set notifyOnCompletion(notifyOnCompletion: boolean);
869
+ getNotifyOnCompletion(): boolean;
870
+ setNotifyOnCompletion(notifyOnCompletion: boolean): BatchInfo;
871
+ get properties(): Array<PropertyDataPlain>;
872
+ set properties(properties: Array<PropertyDataPlain>);
873
+ getProperties(): Array<PropertyData>;
874
+ setProperties(properties: Array<PropertyDataPlain>): BatchInfo;
875
+ addProperty(name: string, value: string): BatchInfo;
876
+ addProperty(prop: PropertyDataPlain): BatchInfo;
732
877
  }
733
-
734
- export class ConsoleLogHandler extends LogHandler implements ConsoleLogHandlerPlain {
735
- readonly type: 'console';
736
- close(): void;
737
- onMessage(): void;
738
- open(): void;
878
+ export type CutProviderPlain = { top: number; right: number; bottom: number; left: number; } | { x: number; y: number; width: number; height: number; };
879
+ export class CutProvider implements Required<{
880
+ x: number;
881
+ y: number;
882
+ width: number;
883
+ height: number;
884
+ top: number;
885
+ right: number;
886
+ bottom: number;
887
+ left: number;
888
+ }> {
889
+ constructor(rectOrRegion: CutProviderPlain);
890
+ constructor(top: number, bottom: number, left: number, right: number);
891
+ get top(): number;
892
+ get right(): number;
893
+ get bottom(): number;
894
+ get left(): number;
895
+ get width(): number;
896
+ get height(): number;
897
+ get x(): number;
898
+ get y(): number;
899
+ scale(scaleRatio: number): CutProvider;
739
900
  }
740
-
741
- export class CutProvider
742
- implements
743
- Required<
744
- {x: number; y: number; width: number; height: number} & {top: number; right: number; bottom: number; left: number}
745
- > {
746
- constructor(rectOrRegion: CutProviderPlain);
747
- constructor(top: number, bottom: number, left: number, right: number);
748
- get bottom(): number;
749
- get height(): number;
750
- get left(): number;
751
- get right(): number;
752
- get top(): number;
753
- get width(): number;
754
- get x(): number;
755
- get y(): number;
756
- scale(scaleRatio: number): CutProvider;
901
+ export class FixedCutProvider extends CutProvider {
757
902
  }
758
-
759
- export class DiffsFoundError extends TestFailedError {
760
- constructor(message: string, results?: TestResultsPlain);
761
- constructor(results: TestResultsPlain);
903
+ export class UnscaledFixedCutProvider extends CutProvider {
904
+ scale(): UnscaledFixedCutProvider;
762
905
  }
763
-
764
- /** @undocumented */
906
+ export type ExactMatchSettingsPlain = { minDiffIntensity: number; minDiffWidth: number; minDiffHeight: number; matchThreshold: number; };
765
907
  export class ExactMatchSettings implements Required<ExactMatchSettingsPlain> {
766
- constructor(settings: ExactMatchSettingsPlain);
767
- get matchThreshold(): number;
768
- set matchThreshold(matchThreshold: number);
769
- get minDiffHeight(): number;
770
- set minDiffHeight(minDiffHeight: number);
771
- get minDiffIntensity(): number;
772
- set minDiffIntensity(minDiffIntensity: number);
773
- get minDiffWidth(): number;
774
- set minDiffWidth(minDiffWidth: number);
775
- getMatchThreshold(): number;
776
- getMinDiffHeight(): number;
777
- getMinDiffIntensity(): number;
778
- getMinDiffWidth(): number;
779
- setMatchThreshold(value: number): void;
780
- setMinDiffHeight(value: number): void;
781
- setMinDiffIntensity(value: number): void;
782
- setMinDiffWidth(value: number): void;
783
- }
784
-
785
- export class Eyes {
786
- constructor(runner?: EyesRunner, config?: ConfigurationPlain);
787
- constructor(config?: ConfigurationPlain, runner?: EyesRunner);
788
- /** @undocumented */
789
- constructor(options?: {configPath: string; runner?: EyesRunner});
790
- static setViewportSize(driver: Driver, viewportSize: RectangleSize): Promise<void>;
791
- get configuration(): ConfigurationPlain;
792
- set configuration(config: ConfigurationPlain);
793
- get driver(): TestController;
794
- get isOpen(): boolean;
795
- get logger(): Logger;
796
- get runner(): EyesRunner;
797
- abort(): Promise<TestResults>;
798
- /** @deprecated */
799
- abortAsync(): Promise<void>;
800
- /** @deprecated */
801
- abortIfNotClosed(): Promise<TestResultsPlain>;
802
- addProperty(name: string, value: string): Configuration;
803
- /**
804
- * @undocumented
805
- * @deprecated
806
- */
807
- addSessionEventHandler(handler: SessionEventHandler): void;
808
- check(name: string, checkSettings: CheckSettings): Promise<MatchResult>;
809
- check(checkSettings?: CheckSettingsPlain): Promise<MatchResult>;
810
- /** @deprecated */
811
- checkElement(element: Element, timeout?: number, name?: string): Promise<MatchResult>;
812
- /** @deprecated */
813
- checkElementBy(selector: Selector, timeout?: number, name?: string): Promise<MatchResult>;
814
- /** @deprecated */
815
- checkFrame(element: Element, timeout?: number, name?: string): Promise<MatchResult>;
816
- /** @deprecated */
817
- checkFrame(element: Selector, timeout?: number, name?: string): Promise<MatchResult>;
818
- /** @deprecated */
819
- checkFrame(element: string, timeout?: number, name?: string): Promise<MatchResult>;
820
- /** @deprecated */
821
- checkFrame(element: number, timeout?: number, name?: string): Promise<MatchResult>;
822
- /** @deprecated */
823
- checkRegion(region?: RegionPlain, name?: string, timeout?: number): Promise<MatchResult>;
824
- /** @deprecated */
825
- checkRegionBy(selector: Selector, name?: string, timeout?: number, fully?: boolean): Promise<MatchResult>;
826
- /** @deprecated */
827
- checkRegionByElement(element: Element, name?: string, timeout?: number): Promise<MatchResult>;
828
- /** @deprecated */
829
- checkRegionInFrame(
830
- frame: Element,
831
- selector: Selector,
832
- timeout?: number,
833
- name?: string,
834
- fully?: boolean,
835
- ): Promise<MatchResult>;
836
- /** @deprecated */
837
- checkRegionInFrame(
838
- frame: Selector,
839
- selector: Selector,
840
- timeout?: number,
841
- name?: string,
842
- fully?: boolean,
843
- ): Promise<MatchResult>;
844
- /** @deprecated */
845
- checkRegionInFrame(
846
- frame: string,
847
- selector: Selector,
848
- timeout?: number,
849
- name?: string,
850
- fully?: boolean,
851
- ): Promise<MatchResult>;
852
- /** @deprecated */
853
- checkRegionInFrame(
854
- frame: number,
855
- selector: Selector,
856
- timeout?: number,
857
- name?: string,
858
- fully?: boolean,
859
- ): Promise<MatchResult>;
860
- checkWindow(name?: string, timeout?: number, fully?: boolean): Promise<MatchResult>;
861
- /** @undocumented */
862
- checkWindow(settings: TestCafeCheckSettings<Selector>): Promise<MatchResult>;
863
- clearProperties(): Configuration;
864
- /**
865
- * @undocumented
866
- * @deprecated
867
- */
868
- clearSessionEventHandlers(): void;
869
- close(throwErr?: boolean): Promise<TestResults>;
870
- /** @deprecated */
871
- closeAsync(): Promise<void>;
872
- extractText(regions: OCRRegion[]): Promise<string[]>;
873
- extractTextRegions<TPattern extends string>(settings: OCRSettings<TPattern>): Promise<Record<TPattern, TextRegion[]>>;
874
- getApiKey(): string;
875
- getAppName(): string;
876
- getBaselineBranchName(): string;
877
- getBaselineEnvName(): string;
878
- /** @deprecated */
879
- getBaselineName(): string;
880
- getBatch(): BatchInfo;
881
- getBranchName(): string;
882
- getConfiguration(): Configuration;
883
- getDebugScreenshotsPath(): string;
884
- getDebugScreenshotsPrefix(): string;
885
- getDeviceInfo(): string;
886
- getDriver(): TestController;
887
- getForceFullPageScreenshot(): boolean;
888
- getHideCaret(): boolean;
889
- getHideScrollbars(): boolean;
890
- getHostApp(): string;
891
- getHostAppInfo(): string;
892
- getHostOS(): string;
893
- getHostOSInfo(): string;
894
- getIgnoreCaret(): boolean;
895
- getIsCutProviderExplicitlySet(): boolean;
896
- getIsDisabled(): boolean;
897
- getIsOpen(): boolean;
898
- getLogHandler(): LogHandler;
899
- getLogger(): Logger;
900
- getMatchLevel(): MatchLevel;
901
- getMatchTimeout(): number;
902
- getParentBranchName(): string;
903
- getProxy(): ProxySettings;
904
- getRotation(): ImageRotation;
905
- getRunner(): EyesRunner;
906
- getSaveDebugScreenshots(): boolean;
907
- getSaveDiffs(): boolean;
908
- getSaveNewTests(): boolean;
909
- getScaleRatio(): number;
910
- getScrollRootElement(): Element | Selector;
911
- getSendDom(): boolean;
912
- getServerUrl(): string;
913
- /**
914
- * @undocumented
915
- * @deprecated
916
- */
917
- getSessionEventHandlers(): SessionEventHandlers;
918
- getStitchMode(): StitchMode;
919
- getStitchOverlap(): number;
920
- getTestName(): string;
921
- getViewportSize(): Promise<RectangleSize>;
922
- getWaitBeforeScreenshots(): number;
923
- locate<TLocator extends string>(settings: VisualLocatorSettings<TLocator>): Promise<Record<TLocator, RegionPlain[]>>;
924
- /** @undocumented */
925
- off(event: string): void;
926
- /** @undocumented */
927
- off(handler: {(...args: any[]): any}): void;
928
- /** @undocumented */
929
- on(handler: {(event: string, data?: Record<string, any>): any}): {(): void};
930
- /** @undocumented */
931
- on(event: 'setSizeWillStart', handler: {(data: {viewportSize: RectangleSizePlain}): any}): {(): void};
932
- /** @undocumented */
933
- on(event: 'setSizeEnded', handler: {(): any}): {(): void};
934
- /** @undocumented */
935
- on(event: 'initStarted', handler: {(): any}): {(): void};
936
- /** @undocumented */
937
- on(event: 'initEnded', handler: {(): any}): {(): void};
938
- /** @undocumented */
939
- on(event: 'testStarted', handler: {(data: {sessionId: string}): any}): {(): void};
940
- /** @undocumented */
941
- on(
942
- event: 'validationWillStart',
943
- handler: {(data: {sessionId: string; validationInfo: ValidationInfoPlain}): any},
944
- ): {(): void};
945
- /** @undocumented */
946
- on(
947
- event: 'validationEnded',
948
- handler: {(data: {sessionId: string; validationId: number; validationResult: ValidationResultPlain}): any},
949
- ): {(): void};
950
- /** @undocumented */
951
- on(event: 'testEnded', handler: {(data: {sessionId: string; testResults: TestResultsPlain}): any}): {(): void};
952
- open(driver: TestController, config?: ConfigurationPlain): Promise<TestController>;
953
- open(
954
- driver: TestController,
955
- appName?: string,
956
- testName?: string,
957
- viewportSize?: RectangleSizePlain,
958
- sessionType?: SessionType,
959
- ): Promise<TestController>;
960
- /** @undocumented */
961
- open(options: {t: TestController} & TestCafeConfiguration): Promise<TestController>;
962
- /**
963
- * @undocumented
964
- * @deprecated
965
- */
966
- removeSessionEventHandler(handler: SessionEventHandler): void;
967
- setApiKey(apiKey: string): void;
968
- setAppName(appName: string): void;
969
- setBaselineBranchName(baselineBranchName: string): void;
970
- setBaselineEnvName(baselineEnvName: string): void;
971
- /** @deprecated */
972
- setBaselineName(baselineName: string): void;
973
- setBatch(batch: BatchInfoPlain): void;
974
- setBatch(name: string, id?: string, startedAt?: Date): void;
975
- setBatch(name: string, id?: string, startedAt?: string): void;
976
- setBranchName(branchName: string): void;
977
- setConfiguration(config: ConfigurationPlain): void;
978
- setCutProvider(cutProvider: CutProvider): void;
979
- setDebugScreenshotsPath(path: string): void;
980
- setDebugScreenshotsPrefix(prefix: string): void;
981
- setDeviceInfo(deviceInfo: string): void;
982
- setForceFullPageScreenshot(forceFullPageScreenshot: boolean): void;
983
- setHideCaret(hideCaret: boolean): void;
984
- setHideScrollbars(hideScrollbars: boolean): void;
985
- setHostApp(hostApp: string): void;
986
- setHostAppInfo(hostAppInfo: string): void;
987
- setHostOS(hostOS: string): void;
988
- setHostOSInfo(hostOSInfo: string): void;
989
- setIgnoreCaret(ignoreCaret: boolean): void;
990
- setImageCut(cutProvider: CutProvider): void;
991
- setIsDisabled(isDisabled: boolean): void;
992
- setLogHandler(handler: LogHandler): void;
993
- setMatchLevel(matchLevel: MatchLevel): void;
994
- setMatchTimeout(matchTimeout: number): void;
995
- setParentBranchName(parentBranchName: string): void;
996
- setProxy(proxy: ProxySettingsPlain): void;
997
- setProxy(url: string, username?: string, password?: string, isHttpOnly?: boolean): void;
998
- setProxy(isEnabled: false): void;
999
- setRotation(rotation: ImageRotationPlain): void;
1000
- setRotation(rotation: ImageRotation): void;
1001
- setSaveDebugScreenshots(save: boolean): void;
1002
- setSaveDiffs(saveDiffs: boolean): void;
1003
- setSaveNewTests(saveNewTests: boolean): void;
1004
- setScaleRatio(scaleRatio: number): void;
1005
- setScrollRootElement(scrollRootElement: Element): void;
1006
- setScrollRootElement(scrollRootElement: Selector): void;
1007
- setSendDom(sendDom: boolean): void;
1008
- setServerUrl(serverUrl: string): void;
1009
- setStitchMode(stitchMode: StitchMode): void;
1010
- setStitchOverlap(stitchOverlap: number): void;
1011
- setTestName(testName: string): void;
1012
- setViewportSize(size: RectangleSizePlain): Promise<void>;
1013
- setWaitBeforeScreenshots(waitBeforeScreenshots: number): void;
1014
- /** @undocumented */
1015
- waitForResults(throwErr?: boolean): any;
1016
- }
1017
-
1018
- export class EyesError extends Error {}
1019
-
1020
- export abstract class EyesRunner {
1021
- constructor();
1022
- getAllTestResults(throwErr?: boolean): Promise<TestResultsSummary>;
1023
- }
1024
-
1025
- export class FileLogHandler extends LogHandler implements FileLogHandlerPlain {
1026
- constructor(verbose?: boolean, filename?: string, append?: boolean);
1027
- readonly append: boolean;
1028
- readonly filename: string;
1029
- readonly type: 'file';
1030
- close(): void;
1031
- onMessage(): void;
1032
- open(): void;
908
+ constructor(settings: ExactMatchSettingsPlain);
909
+ get minDiffIntensity(): number;
910
+ set minDiffIntensity(minDiffIntensity: number);
911
+ getMinDiffIntensity(): number;
912
+ setMinDiffIntensity(value: number): void;
913
+ get minDiffWidth(): number;
914
+ set minDiffWidth(minDiffWidth: number);
915
+ getMinDiffWidth(): number;
916
+ setMinDiffWidth(value: number): void;
917
+ get minDiffHeight(): number;
918
+ set minDiffHeight(minDiffHeight: number);
919
+ getMinDiffHeight(): number;
920
+ setMinDiffHeight(value: number): void;
921
+ get matchThreshold(): number;
922
+ set matchThreshold(matchThreshold: number);
923
+ getMatchThreshold(): number;
924
+ setMatchThreshold(value: number): void;
1033
925
  }
1034
-
1035
- export class FixedCutProvider extends CutProvider {}
1036
-
1037
- /** @undocumented */
926
+ export type FloatingMatchSettingsPlain = {
927
+ region: RegionPlain;
928
+ maxUpOffset?: number;
929
+ maxDownOffset?: number;
930
+ maxLeftOffset?: number;
931
+ maxRightOffset?: number;
932
+ };
1038
933
  export class FloatingMatchSettings implements Required<FloatingMatchSettingsPlain> {
1039
- constructor(settings: FloatingMatchSettingsPlain);
1040
- constructor(
1041
- x: number,
1042
- y: number,
1043
- width: number,
1044
- height: number,
1045
- maxUpOffset: number,
1046
- maxDownOffset: number,
1047
- maxLeftOffset: number,
1048
- maxRightOffset: number,
1049
- );
1050
- get maxDownOffset(): number;
1051
- set maxDownOffset(maxDownOffset: number);
1052
- get maxLeftOffset(): number;
1053
- set maxLeftOffset(maxLeftOffset: number);
1054
- get maxRightOffset(): number;
1055
- set maxRightOffset(maxRightOffset: number);
1056
- get maxUpOffset(): number;
1057
- set maxUpOffset(maxUpOffset: number);
1058
- get region(): RegionPlain;
1059
- set region(region: RegionPlain);
1060
- getHeight(): number;
1061
- getLeft(): number;
1062
- getMaxDownOffset(): number;
1063
- getMaxLeftOffset(): number;
1064
- getMaxRightOffset(): number;
1065
- getMaxUpOffset(): number;
1066
- getRegion(): Region;
1067
- getTop(): number;
1068
- getWidth(): number;
1069
- setHeight(height: number): void;
1070
- setLeft(left: number): void;
1071
- setMaxDownOffset(maxDownOffset: number): void;
1072
- setMaxLeftOffset(maxLeftOffset: number): void;
1073
- setMaxRightOffset(maxRightOffset: number): void;
1074
- setMaxUpOffset(maxUpOffset: number): void;
1075
- setRegion(region: RegionPlain): void;
1076
- setTop(top: number): void;
1077
- setWidth(width: number): void;
934
+ constructor(settings: FloatingMatchSettingsPlain);
935
+ constructor(region: RegionPlain);
936
+ constructor(x: number, y: number, width: number, height: number, maxUpOffset?: number, maxDownOffset?: number, maxLeftOffset?: number, maxRightOffset?: number);
937
+ get region(): RegionPlain;
938
+ set region(region: RegionPlain);
939
+ getRegion(): Region;
940
+ setRegion(region: RegionPlain): void;
941
+ getLeft(): number;
942
+ setLeft(left: number): void;
943
+ getTop(): number;
944
+ setTop(top: number): void;
945
+ getWidth(): number;
946
+ setWidth(width: number): void;
947
+ getHeight(): number;
948
+ setHeight(height: number): void;
949
+ get maxUpOffset(): number;
950
+ set maxUpOffset(maxUpOffset: number);
951
+ getMaxUpOffset(): number;
952
+ setMaxUpOffset(maxUpOffset: number): void;
953
+ get maxDownOffset(): number;
954
+ set maxDownOffset(maxDownOffset: number);
955
+ getMaxDownOffset(): number;
956
+ setMaxDownOffset(maxDownOffset: number): void;
957
+ get maxLeftOffset(): number;
958
+ set maxLeftOffset(maxLeftOffset: number);
959
+ getMaxLeftOffset(): number;
960
+ setMaxLeftOffset(maxLeftOffset: number): void;
961
+ get maxRightOffset(): number;
962
+ set maxRightOffset(maxRightOffset: number);
963
+ getMaxRightOffset(): number;
964
+ setMaxRightOffset(maxRightOffset: number): void;
1078
965
  }
1079
-
1080
- /** @undocumented */
966
+ export type ImageMatchSettingsPlain = {
967
+ exact?: ExactMatchSettingsPlain;
968
+ matchLevel?: MatchLevelPlain;
969
+ ignoreCaret?: boolean;
970
+ useDom?: boolean;
971
+ enablePatterns?: boolean;
972
+ ignoreDisplacements?: boolean;
973
+ ignoreRegions?: Array<RegionPlain>;
974
+ layoutRegions?: Array<RegionPlain>;
975
+ strictRegions?: Array<RegionPlain>;
976
+ contentRegions?: Array<RegionPlain>;
977
+ floatingRegions?: Array<FloatingMatchSettingsPlain | RegionPlain>;
978
+ accessibilityRegions?: Array<AccessibilityMatchSettingsPlain | RegionPlain>;
979
+ accessibilitySettings?: AccessibilitySettings;
980
+ };
1081
981
  export class ImageMatchSettings implements Required<ImageMatchSettingsPlain> {
1082
- constructor(settings?: ImageMatchSettingsPlain);
1083
- get accessibility(): (RegionPlain | AccessibilityMatchSettingsPlain)[];
1084
- set accessibility(accessibilityRegions: (RegionPlain | AccessibilityMatchSettingsPlain)[]);
1085
- get accessibilityRegions(): (RegionPlain | AccessibilityMatchSettingsPlain)[];
1086
- set accessibilityRegions(accessibilityRegions: (RegionPlain | AccessibilityMatchSettingsPlain)[]);
1087
- get accessibilitySettings(): AccessibilitySettings;
1088
- set accessibilitySettings(accessibilitySettings: AccessibilitySettings);
1089
- get content(): RegionPlain[];
1090
- set content(contentRegions: RegionPlain[]);
1091
- get contentRegions(): RegionPlain[];
1092
- set contentRegions(contentRegions: RegionPlain[]);
1093
- get enablePatterns(): boolean;
1094
- set enablePatterns(enablePatterns: boolean);
1095
- get exact(): ExactMatchSettingsPlain;
1096
- set exact(exact: ExactMatchSettingsPlain);
1097
- get floating(): (RegionPlain | FloatingMatchSettingsPlain)[];
1098
- set floating(floatingRegions: (RegionPlain | FloatingMatchSettingsPlain)[]);
1099
- get floatingRegions(): (RegionPlain | FloatingMatchSettingsPlain)[];
1100
- set floatingRegions(floatingRegions: (RegionPlain | FloatingMatchSettingsPlain)[]);
1101
- get ignoreCaret(): boolean;
1102
- set ignoreCaret(ignoreCaret: boolean);
1103
- get ignoreDisplacements(): boolean;
1104
- set ignoreDisplacements(ignoreDisplacements: boolean);
1105
- get ignoreRegions(): RegionPlain[];
1106
- set ignoreRegions(ignoreRegions: RegionPlain[]);
1107
- get layout(): RegionPlain[];
1108
- set layout(layoutRegions: RegionPlain[]);
1109
- get layoutRegions(): RegionPlain[];
1110
- set layoutRegions(layoutRegions: RegionPlain[]);
1111
- get matchLevel(): 'None' | 'Layout1' | 'Layout' | 'Layout2' | 'Content' | 'Strict' | 'Exact';
1112
- set matchLevel(matchLevel: 'None' | 'Layout1' | 'Layout' | 'Layout2' | 'Content' | 'Strict' | 'Exact');
1113
- get strict(): RegionPlain[];
1114
- set strict(strictRegions: RegionPlain[]);
1115
- get strictRegions(): RegionPlain[];
1116
- set strictRegions(strictRegions: RegionPlain[]);
1117
- get useDom(): boolean;
1118
- set useDom(useDom: boolean);
1119
- getAccessibilityRegions(): AccessibilityMatchSettings[];
1120
- getAccessibilitySettings(): AccessibilitySettings;
1121
- getContentRegions(): Region[];
1122
- getEnablePatterns(): boolean;
1123
- getExact(): ExactMatchSettings;
1124
- getFloatingRegions(): FloatingMatchSettings[];
1125
- getIgnoreCaret(): boolean;
1126
- getIgnoreDisplacements(): boolean;
1127
- getIgnoreRegions(): Region[];
1128
- getLayoutRegions(): Region[];
1129
- getMatchLevel(): MatchLevel;
1130
- getStrictRegions(): Region[];
1131
- getUseDom(): boolean;
1132
- setAccessibilityRegions(accessibilityRegions: AccessibilityMatchSettingsPlain[]): void;
1133
- setAccessibilitySettings(accessibilitySettings: AccessibilitySettings): void;
1134
- setContentRegions(contentRegions: RegionPlain[]): void;
1135
- setEnablePatterns(enablePatterns: boolean): void;
1136
- setExact(exact: ExactMatchSettingsPlain): void;
1137
- setFloatingRegions(floatingRegions: FloatingMatchSettingsPlain[]): void;
1138
- setIgnoreCaret(ignoreCaret: boolean): void;
1139
- setIgnoreDisplacements(ignoreDisplacements: boolean): void;
1140
- setIgnoreRegions(ignoreRegions: RegionPlain[]): void;
1141
- setLayoutRegions(layoutRegions: RegionPlain[]): void;
1142
- setMatchLevel(matchLevel: MatchLevel): void;
1143
- setStrictRegions(strictRegions: RegionPlain[]): void;
1144
- setUseDom(useDom: boolean): void;
982
+ constructor(settings?: ImageMatchSettingsPlain);
983
+ get exact(): ExactMatchSettingsPlain;
984
+ set exact(exact: ExactMatchSettingsPlain);
985
+ getExact(): ExactMatchSettings;
986
+ setExact(exact: ExactMatchSettingsPlain): void;
987
+ get matchLevel(): MatchLevelPlain;
988
+ set matchLevel(matchLevel: MatchLevelPlain);
989
+ getMatchLevel(): MatchLevel;
990
+ setMatchLevel(matchLevel: MatchLevelPlain): void;
991
+ get ignoreCaret(): boolean;
992
+ set ignoreCaret(ignoreCaret: boolean);
993
+ getIgnoreCaret(): boolean;
994
+ setIgnoreCaret(ignoreCaret: boolean): void;
995
+ get useDom(): boolean;
996
+ set useDom(useDom: boolean);
997
+ getUseDom(): boolean;
998
+ setUseDom(useDom: boolean): void;
999
+ get enablePatterns(): boolean;
1000
+ set enablePatterns(enablePatterns: boolean);
1001
+ getEnablePatterns(): boolean;
1002
+ setEnablePatterns(enablePatterns: boolean): void;
1003
+ get ignoreDisplacements(): boolean;
1004
+ set ignoreDisplacements(ignoreDisplacements: boolean);
1005
+ getIgnoreDisplacements(): boolean;
1006
+ setIgnoreDisplacements(ignoreDisplacements: boolean): void;
1007
+ get ignoreRegions(): Array<RegionPlain>;
1008
+ set ignoreRegions(ignoreRegions: Array<RegionPlain>);
1009
+ getIgnoreRegions(): Array<Region>;
1010
+ setIgnoreRegions(ignoreRegions: Array<RegionPlain>): void;
1011
+ get layoutRegions(): Array<RegionPlain>;
1012
+ set layoutRegions(layoutRegions: Array<RegionPlain>);
1013
+ get layout(): Array<RegionPlain>;
1014
+ set layout(layout: Array<RegionPlain>);
1015
+ getLayoutRegions(): Array<Region>;
1016
+ setLayoutRegions(layoutRegions: Array<RegionPlain>): void;
1017
+ get strictRegions(): Array<RegionPlain>;
1018
+ set strictRegions(strictRegions: Array<RegionPlain>);
1019
+ get strict(): Array<RegionPlain>;
1020
+ set strict(strict: Array<RegionPlain>);
1021
+ getStrictRegions(): Array<Region>;
1022
+ setStrictRegions(strictRegions: Array<RegionPlain>): void;
1023
+ get contentRegions(): Array<RegionPlain>;
1024
+ set contentRegions(contentRegions: Array<RegionPlain>);
1025
+ get content(): Array<RegionPlain>;
1026
+ set content(content: Array<RegionPlain>);
1027
+ getContentRegions(): Array<Region>;
1028
+ setContentRegions(contentRegions: Array<RegionPlain>): void;
1029
+ get floatingRegions(): Array<FloatingMatchSettingsPlain | RegionPlain>;
1030
+ set floatingRegions(floatingRegions: Array<FloatingMatchSettingsPlain | RegionPlain>);
1031
+ get floating(): Array<FloatingMatchSettingsPlain | RegionPlain>;
1032
+ set floating(floating: Array<FloatingMatchSettingsPlain | RegionPlain>);
1033
+ getFloatingRegions(): Array<FloatingMatchSettings>;
1034
+ setFloatingRegions(floatingRegions: Array<FloatingMatchSettingsPlain>): void;
1035
+ get accessibilityRegions(): Array<AccessibilityMatchSettingsPlain | RegionPlain>;
1036
+ set accessibilityRegions(accessibilityRegions: Array<AccessibilityMatchSettingsPlain | RegionPlain>);
1037
+ get accessibility(): Array<AccessibilityMatchSettingsPlain | RegionPlain>;
1038
+ set accessibility(accessibility: Array<AccessibilityMatchSettingsPlain | RegionPlain>);
1039
+ getAccessibilityRegions(): Array<AccessibilityMatchSettings>;
1040
+ setAccessibilityRegions(accessibilityRegions: Array<AccessibilityMatchSettingsPlain>): void;
1041
+ get accessibilitySettings(): AccessibilitySettings;
1042
+ set accessibilitySettings(accessibilitySettings: AccessibilitySettings);
1043
+ getAccessibilitySettings(): AccessibilitySettings;
1044
+ setAccessibilitySettings(accessibilitySettings: AccessibilitySettings): void;
1145
1045
  }
1146
-
1046
+ export type ImageRotationPlain = 0 | 270 | -270 | 180 | -180 | 90 | -90;
1147
1047
  export class ImageRotation {
1148
- constructor(rotation: ImageRotationPlain);
1149
- get rotation(): ImageRotationPlain;
1150
- set rotation(rotation: ImageRotationPlain);
1151
- getRotation(): ImageRotationPlain;
1152
- setRotation(rotation: ImageRotationPlain): void;
1048
+ constructor(rotation: ImageRotationPlain);
1049
+ get rotation(): ImageRotationPlain;
1050
+ set rotation(rotation: ImageRotationPlain);
1051
+ getRotation(): ImageRotationPlain;
1052
+ setRotation(rotation: ImageRotationPlain): void;
1153
1053
  }
1154
-
1054
+ export type LocationPlain = { x: number; y: number; };
1155
1055
  export class Location implements Required<LocationPlain> {
1156
- constructor(location: LocationPlain);
1157
- constructor(x: number, y: number);
1158
- get x(): number;
1159
- set x(x: number);
1160
- get y(): number;
1161
- set y(y: number);
1162
- getX(): number;
1163
- getY(): number;
1164
- setX(x: number): void;
1165
- setY(y: number): void;
1056
+ constructor(location: LocationPlain);
1057
+ constructor(x: number, y: number);
1058
+ get x(): number;
1059
+ set x(x: number);
1060
+ getX(): number;
1061
+ setX(x: number): void;
1062
+ get y(): number;
1063
+ set y(y: number);
1064
+ getY(): number;
1065
+ setY(y: number): void;
1166
1066
  }
1167
-
1067
+ export type LogHandlerPlain = CustomLogHandlerPlain | FileLogHandlerPlain | ConsoleLogHandlerPlain;
1068
+ export type CustomLogHandlerPlain = {
1069
+ log(message: any): void;
1070
+ warn?(message: any): void;
1071
+ error?(message: any): void;
1072
+ fatal?(message: any): void;
1073
+ open?(): void;
1074
+ close?(): void;
1075
+ };
1076
+ export type FileLogHandlerPlain = { type: "file"; filename?: string; append?: boolean; };
1077
+ export type ConsoleLogHandlerPlain = { type: "console"; };
1168
1078
  export abstract class LogHandler implements CustomLogHandlerPlain {
1169
- constructor(verbose?: boolean);
1170
- get verbose(): boolean;
1171
- set verbose(verbose: boolean);
1172
- abstract close(): void;
1173
- getIsVerbose(): boolean;
1174
- log(message: string): void;
1175
- abstract onMessage(message: string): void;
1176
- abstract open(): void;
1177
- setIsVerbose(verbose: boolean): void;
1178
- }
1179
-
1180
- export class Logger {
1181
- constructor(options?: {handler?: LogHandlerPlain; label?: string; show?: boolean});
1182
- constructor(show?: boolean);
1183
- close(): void;
1184
- error(...messages: any[]): void;
1185
- extend(label?: string, color?: string): Logger;
1186
- extend(label?: string, color?: string[]): Logger;
1187
- fatal(...messages: any[]): void;
1188
- getLogHandler(): LogHandler;
1189
- log(...messages: any[]): void;
1190
- open(): void;
1191
- setLogHandler(handler: LogHandlerPlain): void;
1192
- verbose(...messages: any[]): void;
1193
- warn(...messages: any[]): void;
1079
+ constructor(verbose?: boolean);
1080
+ get verbose(): boolean;
1081
+ set verbose(verbose: boolean);
1082
+ getIsVerbose(): boolean;
1083
+ setIsVerbose(verbose: boolean): void;
1084
+ log(message: string): void;
1085
+ abstract onMessage(message: string): void;
1086
+ abstract open(): void;
1087
+ abstract close(): void;
1194
1088
  }
1195
-
1196
- export class MatchResult implements Required<MatchResultPlain> {
1197
- get asExpected(): boolean;
1198
- get windowId(): number;
1199
- getAsExpected(): boolean;
1200
- getWindowId(): number;
1201
- /** @deprecated */
1202
- setAsExpected(asExpected: boolean): void;
1203
- /** @deprecated */
1204
- setWindowId(windowId: number): void;
1089
+ export class FileLogHandler extends LogHandler implements FileLogHandlerPlain {
1090
+ constructor(verbose?: boolean, filename?: string, append?: boolean);
1091
+ readonly type: "file";
1092
+ readonly filename: string;
1093
+ readonly append: boolean;
1094
+ onMessage(): void;
1095
+ open(): void;
1096
+ close(): void;
1205
1097
  }
1206
-
1207
- export class NewTestError extends TestFailedError {
1208
- constructor(message: string, results?: TestResultsPlain);
1209
- constructor(results: TestResultsPlain);
1098
+ export class ConsoleLogHandler extends LogHandler implements ConsoleLogHandlerPlain {
1099
+ readonly type: "console";
1100
+ onMessage(): void;
1101
+ open(): void;
1102
+ close(): void;
1210
1103
  }
1211
-
1212
1104
  export class NullLogHandler extends LogHandler {
1213
- close(): void;
1214
- onMessage(): void;
1215
- open(): void;
1105
+ onMessage(): void;
1106
+ open(): void;
1107
+ close(): void;
1216
1108
  }
1217
-
1109
+ export type OCRSettings<TPattern extends string = string> = { patterns: Array<TPattern>; ignoreCase?: boolean; firstOnly?: boolean; language?: string; };
1110
+ export type PropertyDataPlain = { name: string; value: string; };
1218
1111
  export class PropertyData implements Required<PropertyDataPlain> {
1219
- constructor(property: PropertyDataPlain);
1220
- constructor(name: string, value: string);
1221
- get name(): string;
1222
- set name(name: string);
1223
- get value(): string;
1224
- set value(value: string);
1225
- getName(): string;
1226
- getValue(): string;
1227
- setName(name: string): void;
1228
- setValue(value: string): void;
1112
+ constructor(property: PropertyDataPlain);
1113
+ constructor(name: string, value: string);
1114
+ get name(): string;
1115
+ set name(name: string);
1116
+ getName(): string;
1117
+ setName(name: string): void;
1118
+ get value(): string;
1119
+ set value(value: string);
1120
+ getValue(): string;
1121
+ setValue(value: string): void;
1229
1122
  }
1230
-
1123
+ export type ProxySettingsPlain = { url: string; username?: string; password?: string; isHttpOnly?: boolean; };
1231
1124
  export class ProxySettings implements Required<ProxySettingsPlain> {
1232
- constructor(proxy: ProxySettingsPlain);
1233
- constructor(url: string, username?: string, password?: string, isHttpOnly?: boolean);
1234
- get isHttpOnly(): boolean;
1235
- get password(): string;
1236
- get url(): string;
1237
- get username(): string;
1238
- getIsHttpOnly(): boolean;
1239
- getPassword(): string;
1240
- getUri(): string;
1241
- getUrl(): string;
1242
- getUsername(): string;
1125
+ constructor(proxy: ProxySettingsPlain);
1126
+ constructor(url: string, username?: string, password?: string, isHttpOnly?: boolean);
1127
+ get url(): string;
1128
+ getUri(): string;
1129
+ getUrl(): string;
1130
+ get username(): string;
1131
+ getUsername(): string;
1132
+ get password(): string;
1133
+ getPassword(): string;
1134
+ get isHttpOnly(): boolean;
1135
+ getIsHttpOnly(): boolean;
1243
1136
  }
1244
-
1137
+ export type RectangleSizePlain = { width: number; height: number; };
1245
1138
  export class RectangleSize implements Required<RectangleSizePlain> {
1246
- constructor(size: RectangleSizePlain);
1247
- constructor(width: number, height: number);
1248
- get height(): number;
1249
- set height(height: number);
1250
- get width(): number;
1251
- set width(width: number);
1252
- getHeight(): number;
1253
- getWidth(): number;
1254
- setHeight(height: number): void;
1255
- setWidth(width: number): void;
1139
+ constructor(size: RectangleSizePlain);
1140
+ constructor(width: number, height: number);
1141
+ get width(): number;
1142
+ set width(width: number);
1143
+ getWidth(): number;
1144
+ setWidth(width: number): void;
1145
+ get height(): number;
1146
+ set height(height: number);
1147
+ getHeight(): number;
1148
+ setHeight(height: number): void;
1256
1149
  }
1257
-
1150
+ export type RegionPlain = LocationPlain & RectangleSizePlain;
1151
+ export type LegacyRegionPlain = { left: number; top: number; width: number; height: number; };
1258
1152
  export class Region implements Required<RegionPlain> {
1259
- constructor(region: RegionPlain);
1260
- constructor(location: LocationPlain, size: RectangleSizePlain);
1261
- constructor(x: number, y: number, width: number, height: number);
1262
- get height(): number;
1263
- set height(height: number);
1264
- get left(): number;
1265
- set left(left: number);
1266
- get top(): number;
1267
- set top(top: number);
1268
- get width(): number;
1269
- set width(width: number);
1270
- get x(): number;
1271
- set x(x: number);
1272
- get y(): number;
1273
- set y(y: number);
1274
- getHeight(): number;
1275
- getLeft(): number;
1276
- getTop(): number;
1277
- getWidth(): number;
1278
- getX(): number;
1279
- getY(): number;
1280
- setHeight(height: number): void;
1281
- setLeft(left: number): void;
1282
- setTop(top: number): void;
1283
- setWidth(width: number): void;
1284
- setX(x: number): void;
1285
- setY(y: number): void;
1153
+ constructor(region: RegionPlain);
1154
+ constructor(location: LocationPlain, size: RectangleSizePlain);
1155
+ constructor(x: number, y: number, width: number, height: number);
1156
+ get x(): number;
1157
+ set x(x: number);
1158
+ get left(): number;
1159
+ set left(left: number);
1160
+ getX(): number;
1161
+ setX(x: number): void;
1162
+ getLeft(): number;
1163
+ setLeft(left: number): void;
1164
+ get y(): number;
1165
+ set y(y: number);
1166
+ get top(): number;
1167
+ set top(top: number);
1168
+ getY(): number;
1169
+ setY(y: number): void;
1170
+ getTop(): number;
1171
+ setTop(top: number): void;
1172
+ get width(): number;
1173
+ set width(width: number);
1174
+ getWidth(): number;
1175
+ setWidth(width: number): void;
1176
+ get height(): number;
1177
+ set height(height: number);
1178
+ getHeight(): number;
1179
+ setHeight(height: number): void;
1286
1180
  }
1287
-
1288
- /**
1289
- * @undocumented
1290
- * @deprecated
1291
- */
1292
- export class RemoteSessionEventHandler extends SessionEventHandler {
1293
- constructor(options: {accessKey?: string; serverUrl: string; timeout?: number});
1294
- constructor(serverUrl: string, accessKey?: string, timeout?: number);
1295
- get accessKey(): string;
1296
- set accessKey(accessKey: string);
1297
- get serverUrl(): string;
1298
- set serverUrl(serverUrl: string);
1299
- get timeout(): number;
1300
- set timeout(timeout: number);
1301
- getAccessKey(): string;
1302
- getServerUrl(): string;
1303
- getTimeout(): number;
1304
- initEnded(): void;
1305
- initStarted(): void;
1306
- setAccessKey(accessKey: string): void;
1307
- setServerUrl(serverUrl: string): void;
1308
- setSizeEnded(): void;
1309
- setSizeWillStart(): void;
1310
- setTimeout(timeout: number): void;
1311
- testEnded(): void;
1312
- testStarted(): void;
1313
- validationEnded(): void;
1314
- validationWillStart(): void;
1315
- }
1316
-
1317
- /** @deprecated */
1181
+ export type DesktopBrowserInfo = { name?: BrowserTypePlain; width: number; height: number; };
1182
+ export type ChromeEmulationInfo = { chromeEmulationInfo: { deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain; }; };
1183
+ export type IOSDeviceInfo = { iosDeviceInfo: { deviceName: IosDeviceNamePlain; iosVersion?: IosVersionPlain; screenOrientation?: ScreenOrientationPlain; }; };
1184
+ export type RunnerOptionsPlain = { testConcurrency?: number; };
1318
1185
  export class RunnerOptionsFluent {
1319
- constructor();
1320
- testConcurrency(concurrency: number): this;
1186
+ testConcurrency(concurrency: number): RunnerOptionsFluent;
1321
1187
  }
1322
-
1323
- /** @deprecated */
1324
- export abstract class SessionEventHandler {
1325
- constructor();
1326
- abstract initEnded(): any;
1327
- abstract initStarted(): any;
1328
- abstract setSizeEnded(): any;
1329
- abstract setSizeWillStart(viewportSize: RectangleSize): any;
1330
- abstract testEnded(sessionId: string, testResults: TestResults): any;
1331
- abstract testStarted(sessionId: string): any;
1332
- abstract validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): any;
1333
- abstract validationWillStart(sessionId: string, validationInfo: ValidationInfo): any;
1188
+ export function RunnerOptions(): RunnerOptionsFluent;
1189
+ export type VisualLocatorSettings<TLocator extends string = string> = { locatorNames: Array<TLocator>; firstOnly: boolean; };
1190
+ export type ApiUrlsPlain = {
1191
+ readonly baselineImage?: string;
1192
+ readonly currentImage?: string;
1193
+ readonly checkpointImage?: string;
1194
+ readonly checkpointImageThumbnail?: string;
1195
+ readonly diffImage?: string;
1196
+ };
1197
+ export class ApiUrls implements Required<ApiUrlsPlain> {
1198
+ get baselineImage(): string;
1199
+ getBaselineImage(): string;
1200
+ setBaselineImage(setBaselineImage: string): void;
1201
+ get currentImage(): string;
1202
+ getCurrentImage(): string;
1203
+ setCurrentImage(currentImage: string): void;
1204
+ get checkpointImage(): string;
1205
+ getCheckpointImage(): string;
1206
+ setCheckpointImage(checkpointImage: string): void;
1207
+ get checkpointImageThumbnail(): string;
1208
+ getCheckpointImageThumbnail(): string;
1209
+ setCheckpointImageThumbnail(checkpointImageThumbnail: string): void;
1210
+ get diffImage(): string;
1211
+ getDiffImage(): string;
1212
+ setDiffImage(diffImage: string): void;
1334
1213
  }
1335
-
1336
- /** @deprecated */
1337
- export class SessionEventHandlers extends SessionEventHandler {
1338
- addEventHandler(handler: SessionEventHandler): void;
1339
- clearEventHandlers(): void;
1340
- initEnded(): void;
1341
- initStarted(): void;
1342
- removeEventHandler(handler: SessionEventHandler): void;
1343
- setSizeEnded(): void;
1344
- setSizeWillStart(viewportSize: RectangleSize): void;
1345
- testEnded(sessionId: string, testResults: TestResults): void;
1346
- testStarted(sessionId: string): void;
1347
- validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): void;
1348
- validationWillStart(sessionId: string, validationInfo: ValidationInfo): void;
1214
+ export type AppUrlsPlain = { readonly step?: string; readonly stepEditor?: string; };
1215
+ export class AppUrls implements Required<AppUrlsPlain> {
1216
+ get step(): string;
1217
+ getStep(): string;
1218
+ setStep(step: string): void;
1219
+ get stepEditor(): string;
1220
+ getStepEditor(): string;
1221
+ setStepEditor(stepEditor: string): void;
1222
+ }
1223
+ export type MatchResultPlain = { readonly asExpected?: boolean; readonly windowId?: number; };
1224
+ export class MatchResult implements Required<MatchResultPlain> {
1225
+ get asExpected(): boolean;
1226
+ getAsExpected(): boolean;
1227
+ setAsExpected(asExpected: boolean): void;
1228
+ get windowId(): number;
1229
+ getWindowId(): number;
1230
+ setWindowId(windowId: number): void;
1349
1231
  }
1350
-
1232
+ export type SessionUrlsPlain = { readonly batch?: string; readonly session?: string; };
1351
1233
  export class SessionUrls implements Required<SessionUrlsPlain> {
1352
- get batch(): string;
1353
- get session(): string;
1354
- getBatch(): string;
1355
- getSession(): string;
1356
- /** @deprecated */
1357
- setBatch(batch: string): void;
1358
- /** @deprecated */
1359
- setSession(session: string): void;
1234
+ get batch(): string;
1235
+ getBatch(): string;
1236
+ setBatch(batch: string): void;
1237
+ get session(): string;
1238
+ getSession(): string;
1239
+ setSession(session: string): void;
1360
1240
  }
1361
-
1241
+ export type StepInfoPlain = {
1242
+ readonly name?: string;
1243
+ readonly isDifferent?: boolean;
1244
+ readonly hasBaselineImage?: boolean;
1245
+ readonly hasCurrentImage?: boolean;
1246
+ readonly appUrls?: AppUrlsPlain;
1247
+ readonly apiUrls?: ApiUrlsPlain;
1248
+ readonly renderId?: Array<string>;
1249
+ };
1362
1250
  export class StepInfo implements Required<StepInfoPlain> {
1363
- get apiUrls(): ApiUrlsPlain;
1364
- get appUrls(): AppUrlsPlain;
1365
- get hasBaselineImage(): boolean;
1366
- get hasCurrentImage(): boolean;
1367
- get isDifferent(): boolean;
1368
- get name(): string;
1369
- get renderId(): string[];
1370
- getApiUrls(): ApiUrls;
1371
- getAppUrls(): AppUrls;
1372
- getHasBaselineImage(): boolean;
1373
- getHasCurrentImage(): boolean;
1374
- getIsDifferent(): boolean;
1375
- getName(): string;
1376
- getRenderId(): string[];
1377
- /** @deprecated */
1378
- setApiUrls(apiUrls: ApiUrlsPlain): void;
1379
- /** @deprecated */
1380
- setAppUrls(appUrls: AppUrlsPlain): void;
1381
- /** @deprecated */
1382
- setHasBaselineImage(value: boolean): void;
1383
- /** @deprecated */
1384
- setHasCurrentImage(hasCurrentImage: boolean): void;
1385
- /** @deprecated */
1386
- setIsDifferent(value: boolean): void;
1387
- /** @deprecated */
1388
- setName(value: string): void;
1389
- /** @deprecated */
1390
- setRenderId(renderId: string[]): void;
1251
+ get name(): string;
1252
+ getName(): string;
1253
+ setName(value: string): void;
1254
+ get isDifferent(): boolean;
1255
+ getIsDifferent(): boolean;
1256
+ setIsDifferent(value: boolean): void;
1257
+ get hasBaselineImage(): boolean;
1258
+ getHasBaselineImage(): boolean;
1259
+ setHasBaselineImage(value: boolean): void;
1260
+ get hasCurrentImage(): boolean;
1261
+ getHasCurrentImage(): boolean;
1262
+ setHasCurrentImage(hasCurrentImage: boolean): void;
1263
+ get appUrls(): AppUrlsPlain;
1264
+ getAppUrls(): AppUrls;
1265
+ setAppUrls(appUrls: AppUrlsPlain): void;
1266
+ get apiUrls(): ApiUrlsPlain;
1267
+ getApiUrls(): ApiUrls;
1268
+ setApiUrls(apiUrls: ApiUrlsPlain): void;
1269
+ get renderId(): Array<string>;
1270
+ getRenderId(): Array<string>;
1271
+ setRenderId(renderId: Array<string>): void;
1391
1272
  }
1392
-
1393
- export class TestFailedError extends EyesError {
1394
- constructor(message: string, results?: TestResultsPlain);
1395
- constructor(results: TestResultsPlain);
1396
- get testResults(): TestResultsPlain;
1397
- getTestResults(): TestResults;
1273
+ export type TestAccessibilityStatus = { readonly status: AccessibilityStatusPlain; readonly level: AccessibilityLevelPlain; readonly version: AccessibilityGuidelinesVersionPlain; };
1274
+ export type TestResultsPlain = {
1275
+ readonly id?: string;
1276
+ readonly name?: string;
1277
+ readonly secretToken?: string;
1278
+ readonly status?: TestResultsStatusPlain;
1279
+ readonly appName?: string;
1280
+ readonly batchId?: string;
1281
+ readonly batchName?: string;
1282
+ readonly branchName?: string;
1283
+ readonly hostOS?: string;
1284
+ readonly hostApp?: string;
1285
+ readonly hostDisplaySize?: RectangleSizePlain;
1286
+ readonly accessibilityStatus?: TestAccessibilityStatus;
1287
+ readonly startedAt?: string | Date;
1288
+ readonly duration?: number;
1289
+ readonly isNew?: boolean;
1290
+ readonly isDifferent?: boolean;
1291
+ readonly isAborted?: boolean;
1292
+ readonly appUrls?: SessionUrlsPlain;
1293
+ readonly apiUrls?: SessionUrlsPlain;
1294
+ readonly stepsInfo?: Array<StepInfoPlain>;
1295
+ readonly steps?: number;
1296
+ readonly matches?: number;
1297
+ readonly mismatches?: number;
1298
+ readonly missing?: number;
1299
+ readonly exactMatches?: number;
1300
+ readonly strictMatches?: number;
1301
+ readonly contentMatches?: number;
1302
+ readonly layoutMatches?: number;
1303
+ readonly noneMatches?: number;
1304
+ readonly url?: string;
1305
+ };
1306
+ export class TestResults implements Required<TestResultsPlain> {
1307
+ get id(): string;
1308
+ getId(): string;
1309
+ setId(id: string): void;
1310
+ get name(): string;
1311
+ getName(): string;
1312
+ setName(name: string): void;
1313
+ get secretToken(): string;
1314
+ getSecretToken(): string;
1315
+ setSecretToken(secretToken: string): void;
1316
+ get status(): TestResultsStatusPlain;
1317
+ getStatus(): TestResultsStatus;
1318
+ setStatus(status: TestResultsStatus): void;
1319
+ get appName(): string;
1320
+ getAppName(): string;
1321
+ setAppName(appName: string): void;
1322
+ get batchName(): string;
1323
+ getBatchName(): string;
1324
+ setBatchName(batchName: string): void;
1325
+ get batchId(): string;
1326
+ getBatchId(): string;
1327
+ setBatchId(batchId: string): void;
1328
+ get branchName(): string;
1329
+ getBranchName(): string;
1330
+ setBranchName(branchName: string): void;
1331
+ get hostOS(): string;
1332
+ getHostOS(): string;
1333
+ setHostOS(hostOS: string): void;
1334
+ get hostApp(): string;
1335
+ getHostApp(): string;
1336
+ setHostApp(hostApp: string): void;
1337
+ get hostDisplaySize(): RectangleSizePlain;
1338
+ getHostDisplaySize(): RectangleSize;
1339
+ setHostDisplaySize(hostDisplaySize: RectangleSizePlain): void;
1340
+ get accessibilityStatus(): TestAccessibilityStatus;
1341
+ getAccessibilityStatus(): TestAccessibilityStatus;
1342
+ setAccessibilityStatus(accessibilityStatus: TestAccessibilityStatus): void;
1343
+ get startedAt(): string | Date;
1344
+ getStartedAt(): Date;
1345
+ setStartedAt(startedAt: string | Date): void;
1346
+ get duration(): number;
1347
+ getDuration(): number;
1348
+ setDuration(duration: number): void;
1349
+ get isNew(): boolean;
1350
+ getIsNew(): boolean;
1351
+ setIsNew(isNew: boolean): void;
1352
+ get isDifferent(): boolean;
1353
+ getIsDifferent(): boolean;
1354
+ setIsDifferent(isDifferent: boolean): void;
1355
+ get isAborted(): boolean;
1356
+ getIsAborted(): boolean;
1357
+ setIsAborted(isAborted: boolean): void;
1358
+ get appUrls(): SessionUrlsPlain;
1359
+ getAppUrls(): SessionUrls;
1360
+ setAppUrls(appUrls: SessionUrlsPlain): void;
1361
+ get apiUrls(): SessionUrlsPlain;
1362
+ getApiUrls(): SessionUrls;
1363
+ setApiUrls(apiUrls: SessionUrlsPlain): void;
1364
+ get stepsInfo(): Array<StepInfoPlain>;
1365
+ getStepsInfo(): Array<StepInfo>;
1366
+ setStepsInfo(stepInfo: Array<StepInfoPlain>): void;
1367
+ get steps(): number;
1368
+ getSteps(): number;
1369
+ setSteps(steps: number): void;
1370
+ get matches(): number;
1371
+ getMatches(): number;
1372
+ setMatches(matches: number): void;
1373
+ get mismatches(): number;
1374
+ getMismatches(): number;
1375
+ setMismatches(mismatches: number): void;
1376
+ get missing(): number;
1377
+ getMissing(): number;
1378
+ setMissing(missing: number): void;
1379
+ get exactMatches(): number;
1380
+ getExactMatches(): number;
1381
+ setExactMatches(exactMatches: number): void;
1382
+ get strictMatches(): number;
1383
+ getStrictMatches(): number;
1384
+ setStrictMatches(strictMatches: number): void;
1385
+ get contentMatches(): number;
1386
+ getContentMatches(): number;
1387
+ setContentMatches(contentMatches: number): void;
1388
+ get layoutMatches(): number;
1389
+ getLayoutMatches(): number;
1390
+ setLayoutMatches(layoutMatches: number): void;
1391
+ get noneMatches(): number;
1392
+ getNoneMatches(): number;
1393
+ setNoneMatches(noneMatches: number): void;
1394
+ get url(): string;
1395
+ getUrl(): string;
1396
+ setUrl(url: string): void;
1397
+ isPassed(): boolean;
1398
+ delete(): Promise<void>;
1399
+ deleteSession(): Promise<void>;
1398
1400
  }
1399
-
1401
+ export type TestResultContainerPlain = { readonly exception: Error; readonly testResults: TestResultsPlain; };
1400
1402
  export class TestResultContainer implements Required<TestResultContainerPlain> {
1401
- get exception(): EyesError;
1402
- get testResults(): TestResultsPlain;
1403
- getException(): EyesError;
1404
- getTestResults(): TestResults;
1405
- }
1406
-
1407
- export class TestResults implements Required<TestResultsPlain> {
1408
- get accessibilityStatus(): TestAccessibilityStatus;
1409
- get apiUrls(): SessionUrlsPlain;
1410
- get appName(): string;
1411
- get appUrls(): SessionUrlsPlain;
1412
- get batchId(): string;
1413
- get batchName(): string;
1414
- get branchName(): string;
1415
- get contentMatches(): number;
1416
- get duration(): number;
1417
- get exactMatches(): number;
1418
- get hostApp(): string;
1419
- get hostDisplaySize(): RectangleSizePlain;
1420
- get hostOS(): string;
1421
- get isAborted(): boolean;
1422
- get isDifferent(): boolean;
1423
- get isNew(): boolean;
1424
- get layoutMatches(): number;
1425
- get matches(): number;
1426
- get mismatches(): number;
1427
- get missing(): number;
1428
- get name(): string;
1429
- get noneMatches(): number;
1430
- get secretToken(): string;
1431
- get startedAt(): string | Date;
1432
- get status(): 'Passed' | 'Failed' | 'Unresolved';
1433
- get steps(): number;
1434
- get stepsInfo(): StepInfoPlain[];
1435
- get strictMatches(): number;
1436
- get testId(): string;
1437
- get url(): string;
1438
- delete(): Promise<void>;
1439
- /** @deprecated */
1440
- deleteSession(): Promise<void>;
1441
- getAccessibilityStatus(): TestAccessibilityStatus;
1442
- getApiUrls(): SessionUrls;
1443
- getAppName(): string;
1444
- getAppUrls(): SessionUrls;
1445
- getBatchId(): string;
1446
- getBatchName(): string;
1447
- getBranchName(): string;
1448
- getContentMatches(): number;
1449
- getDuration(): number;
1450
- getExactMatches(): number;
1451
- getHostApp(): string;
1452
- getHostDisplaySize(): RectangleSize;
1453
- getHostOS(): string;
1454
- getId(): string;
1455
- getIsAborted(): boolean;
1456
- getIsDifferent(): boolean;
1457
- getIsNew(): boolean;
1458
- getLayoutMatches(): number;
1459
- getMatches(): number;
1460
- getMismatches(): number;
1461
- getMissing(): number;
1462
- getName(): string;
1463
- getNoneMatches(): number;
1464
- getSecretToken(): string;
1465
- getStartedAt(): Date;
1466
- getStatus(): TestResultsStatus;
1467
- getSteps(): number;
1468
- getStepsInfo(): StepInfo[];
1469
- getStrictMatches(): number;
1470
- getUrl(): string;
1471
- isPassed(): boolean;
1472
- /** @deprecated */
1473
- setAccessibilityStatus(accessibilityStatus: TestAccessibilityStatus): void;
1474
- /** @deprecated */
1475
- setApiUrls(apiUrls: SessionUrlsPlain): void;
1476
- /** @deprecated */
1477
- setAppName(appName: string): void;
1478
- /** @deprecated */
1479
- setAppUrls(appUrls: SessionUrlsPlain): void;
1480
- /** @deprecated */
1481
- setBatchId(batchId: string): void;
1482
- /** @deprecated */
1483
- setBatchName(batchName: string): void;
1484
- /** @deprecated */
1485
- setBranchName(branchName: string): void;
1486
- /** @deprecated */
1487
- setContentMatches(contentMatches: number): void;
1488
- /** @deprecated */
1489
- setDuration(duration: number): void;
1490
- /** @deprecated */
1491
- setExactMatches(exactMatches: number): void;
1492
- /** @deprecated */
1493
- setHostApp(hostApp: string): void;
1494
- /** @deprecated */
1495
- setHostDisplaySize(hostDisplaySize: RectangleSizePlain): void;
1496
- /** @deprecated */
1497
- setHostOS(hostOS: string): void;
1498
- /** @deprecated */
1499
- setId(id: string): void;
1500
- /** @deprecated */
1501
- setIsAborted(isAborted: boolean): void;
1502
- /** @deprecated */
1503
- setIsDifferent(isDifferent: boolean): void;
1504
- /** @deprecated */
1505
- setIsNew(isNew: boolean): void;
1506
- /** @deprecated */
1507
- setLayoutMatches(layoutMatches: number): void;
1508
- /** @deprecated */
1509
- setMatches(matches: number): void;
1510
- /** @deprecated */
1511
- setMismatches(mismatches: number): void;
1512
- /** @deprecated */
1513
- setMissing(missing: number): void;
1514
- /** @deprecated */
1515
- setName(name: string): void;
1516
- /** @deprecated */
1517
- setNoneMatches(noneMatches: number): void;
1518
- /** @deprecated */
1519
- setSecretToken(secretToken: string): void;
1520
- /** @deprecated */
1521
- setStartedAt(startedAt: Date): void;
1522
- /** @deprecated */
1523
- setStartedAt(startedAt: string): void;
1524
- /** @deprecated */
1525
- setStatus(status: TestResultsStatus): void;
1526
- /** @deprecated */
1527
- setSteps(steps: number): void;
1528
- /** @deprecated */
1529
- setStepsInfo(stepInfo: StepInfoPlain[]): void;
1530
- /** @deprecated */
1531
- setStrictMatches(strictMatches: number): void;
1532
- /** @deprecated */
1533
- setUrl(url: string): void;
1403
+ get testResults(): TestResultsPlain;
1404
+ getTestResults(): TestResults;
1405
+ get exception(): Error;
1406
+ getException(): Error;
1534
1407
  }
1535
-
1408
+ export type TestResultsSummaryPlain = Iterable<TestResultContainerPlain>;
1536
1409
  export class TestResultsSummary implements TestResultsSummaryPlain {
1537
- [Symbol.iterator](): Iterator<TestResultContainer>;
1538
- getAllResults(): TestResultContainer[];
1539
- }
1540
-
1541
- /** @undocumented */
1542
- export class UnscaledFixedCutProvider extends CutProvider {
1543
- scale(): UnscaledFixedCutProvider;
1410
+ getAllResults(): Array<TestResultContainer>;
1411
+ [Symbol.iterator](): Iterator<TestResultContainer, any, undefined>;
1544
1412
  }
1545
-
1546
- /** @undocumented */
1413
+ export type TextRegion = {
1414
+ x: number;
1415
+ y: number;
1416
+ width: number;
1417
+ height: number;
1418
+ text: string;
1419
+ };
1420
+ export type ValidationInfoPlain = { readonly validationId: number; readonly tag: string; };
1547
1421
  export class ValidationInfo implements Required<ValidationInfoPlain> {
1548
- get tag(): string;
1549
- get validationId(): number;
1550
- getTag(): string;
1551
- getValidationId(): number;
1422
+ get validationId(): number;
1423
+ getValidationId(): number;
1424
+ get tag(): string;
1425
+ getTag(): string;
1552
1426
  }
1553
-
1554
- /** @undocumented */
1427
+ export type ValidationResultPlain = { readonly asExpected: boolean; };
1555
1428
  export class ValidationResult implements Required<ValidationResultPlain> {
1556
- get asExpected(): boolean;
1557
- getAsExpected(): boolean;
1429
+ get asExpected(): boolean;
1430
+ getAsExpected(): boolean;
1431
+ }
1432
+ export type EyesSelector<TSelector = never> = string | TSelector | { selector: string | TSelector; type?: string; shadow?: EyesSelector<TSelector>; frame?: EyesSelector<TSelector>; };
1433
+ export class Logger {
1434
+ constructor(options?: { show?: boolean; label?: string; handler?: LogHandlerPlain; });
1435
+ constructor(show?: boolean);
1436
+ getLogHandler(): LogHandler;
1437
+ setLogHandler(handler: LogHandlerPlain): void;
1438
+ verbose(...messages: Array<any>): void;
1439
+ log(...messages: Array<any>): void;
1440
+ warn(...messages: Array<any>): void;
1441
+ error(...messages: Array<any>): void;
1442
+ fatal(...messages: Array<any>): void;
1443
+ open(): void;
1444
+ close(): void;
1445
+ extend(options?: Omit<{
1446
+ handler?: CustomLogHandlerPlain | FileLogHandlerPlain | ConsoleLogHandlerPlain | {
1447
+ type: "rolling file";
1448
+ dirname?: string;
1449
+ name?: string;
1450
+ maxFileLength?: number;
1451
+ maxFileNumber?: number;
1452
+ };
1453
+ format?: (message: any, options: {
1454
+ formatting?: boolean;
1455
+ label?: string;
1456
+ timestamp?: Date;
1457
+ level?: "silent" | "fatal" | "error" | "warn" | "info";
1458
+ tags?: Record<string, unknown>;
1459
+ color?: string | Array<string>;
1460
+ colors?: { timestamp?: string | Array<string>; level?: {
1461
+ silent?: string | Array<string>;
1462
+ fatal?: string | Array<string>;
1463
+ error?: string | Array<string>;
1464
+ warn?: string | Array<string>;
1465
+ info?: string | Array<string>;
1466
+ }; tags?: string | Array<string>; message?: string | Array<string>; };
1467
+ }) => string;
1468
+ label?: string;
1469
+ timestamp?: false;
1470
+ level?: number | ("silent" | "fatal" | "error" | "warn" | "info");
1471
+ colors?: boolean | { timestamp?: string | Array<string>; level?: {
1472
+ silent?: string | Array<string>;
1473
+ fatal?: string | Array<string>;
1474
+ error?: string | Array<string>;
1475
+ warn?: string | Array<string>;
1476
+ info?: string | Array<string>;
1477
+ }; tags?: string | Array<string>; message?: string | Array<string>; };
1478
+ console?: boolean | CustomLogHandlerPlain;
1479
+ }, "handler">): Logger;
1480
+ extend(label?: string): Logger;
1481
+ }
1482
+ export function closeBatch(spec: { closeBatches(options: { settings: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }; }): Promise<void>; }): (options: { batchIds: Array<string>; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain; }) => Promise<void>;
1483
+ export abstract class EyesRunner {
1484
+ getAllTestResults(throwErr?: boolean): Promise<TestResultsSummary>;
1485
+ }
1486
+ export class ClassicRunner extends EyesRunner {
1558
1487
  }
1559
-
1560
1488
  export class VisualGridRunner extends EyesRunner {
1561
- constructor(options?: RunnerOptionsPlain);
1562
- /** @deprecated */
1563
- constructor(options?: RunnerOptionsFluent);
1564
- /** @deprecated */
1565
- constructor(legacyConcurrency?: number);
1566
- /** @deprecated */
1567
- get legacyConcurrency(): number;
1568
- get testConcurrency(): number;
1569
- /** @deprecated */
1570
- getConcurrentSessions(): number;
1489
+ constructor(options?: RunnerOptionsPlain);
1490
+ constructor(options?: RunnerOptionsFluent);
1491
+ constructor(legacyConcurrency?: number);
1492
+ get testConcurrency(): number;
1493
+ get legacyConcurrency(): number;
1494
+ getConcurrentSessions(): number;
1495
+ }
1496
+ export abstract class SessionEventHandler {
1497
+ abstract initStarted(): any;
1498
+ abstract initEnded(): any;
1499
+ abstract setSizeWillStart(viewportSize: RectangleSize): any;
1500
+ abstract setSizeEnded(): any;
1501
+ abstract testStarted(sessionId: string): any;
1502
+ abstract testEnded(sessionId: string, testResults: TestResults): any;
1503
+ abstract validationWillStart(sessionId: string, validationInfo: ValidationInfo): any;
1504
+ abstract validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): any;
1505
+ }
1506
+ export class SessionEventHandlers extends SessionEventHandler {
1507
+ addEventHandler(handler: SessionEventHandler): void;
1508
+ removeEventHandler(handler: SessionEventHandler): void;
1509
+ clearEventHandlers(): void;
1510
+ initStarted(): void;
1511
+ initEnded(): void;
1512
+ setSizeWillStart(viewportSize: RectangleSize): void;
1513
+ setSizeEnded(): void;
1514
+ testStarted(sessionId: string): void;
1515
+ testEnded(sessionId: string, testResults: TestResults): void;
1516
+ validationWillStart(sessionId: string, validationInfo: ValidationInfo): void;
1517
+ validationEnded(sessionId: string, validationId: number, validationResult: ValidationResult): void;
1518
+ }
1519
+ export class RemoteSessionEventHandler extends SessionEventHandler {
1520
+ constructor(options: { serverUrl: string; accessKey?: string; timeout?: number; });
1521
+ constructor(serverUrl: string, accessKey?: string, timeout?: number);
1522
+ get serverUrl(): string;
1523
+ set serverUrl(serverUrl: string);
1524
+ getServerUrl(): string;
1525
+ setServerUrl(serverUrl: string): void;
1526
+ get accessKey(): string;
1527
+ set accessKey(accessKey: string);
1528
+ getAccessKey(): string;
1529
+ setAccessKey(accessKey: string): void;
1530
+ get timeout(): number;
1531
+ set timeout(timeout: number);
1532
+ setTimeout(timeout: number): void;
1533
+ getTimeout(): number;
1534
+ initStarted(): void;
1535
+ initEnded(): void;
1536
+ setSizeWillStart(): void;
1537
+ setSizeEnded(): void;
1538
+ testStarted(): void;
1539
+ testEnded(): void;
1540
+ validationWillStart(): void;
1541
+ validationEnded(): void;
1571
1542
  }
1572
-
1573
- export default Eyes;
1574
-
1575
- export type AccessibilityGuidelinesVersionPlain = 'WCAG_2_0' | 'WCAG_2_1';
1576
-
1577
- export type AccessibilityLevelPlain = 'AA' | 'AAA';
1578
-
1579
- export type AccessibilityMatchSettingsPlain = {region: RegionPlain; type?: AccessibilityRegionTypePlain};
1580
-
1581
- export type AccessibilityRegionTypePlain =
1582
- | 'BoldText'
1583
- | 'GraphicalObject'
1584
- | 'IgnoreContrast'
1585
- | 'LargeText'
1586
- | 'RegularText';
1587
-
1588
- export type AccessibilitySettings = {
1589
- guidelinesVersion?: AccessibilityGuidelinesVersionPlain;
1590
- level?: AccessibilityLevelPlain;
1591
- };
1592
-
1593
- export type AccessibilityStatusPlain = 'Failed' | 'Passed';
1594
-
1595
- export type ApiUrlsPlain = {
1596
- readonly baselineImage?: string;
1597
- readonly checkpointImage?: string;
1598
- readonly checkpointImageThumbnail?: string;
1599
- readonly currentImage?: string;
1600
- readonly diffImage?: string;
1601
- };
1602
-
1603
- export type AppUrlsPlain = {readonly step?: string; readonly stepEditor?: string};
1604
-
1605
- export type BatchInfoPlain = {
1606
- id?: string;
1607
- name?: string;
1608
- notifyOnCompletion?: boolean;
1609
- properties?: PropertyDataPlain[];
1610
- sequenceName?: string;
1611
- startedAt?: Date | string;
1612
- };
1613
-
1614
- export type BrowserTypePlain =
1615
- | 'chrome'
1616
- | 'chrome-one-version-back'
1617
- | 'chrome-two-versions-back'
1618
- | 'edge'
1619
- | 'edgechromium'
1620
- | 'edgechromium-one-version-back'
1621
- | 'edgechromium-two-versions-back'
1622
- | 'edgelegacy'
1623
- | 'firefox'
1624
- | 'firefox-one-version-back'
1625
- | 'firefox-two-versions-back'
1626
- | 'ie10'
1627
- | 'ie'
1628
- | 'safari'
1629
- | 'safari-earlyaccess'
1630
- | 'safari-one-version-back'
1631
- | 'safari-two-versions-back';
1632
-
1633
- export type CheckSettingsPlain = {
1634
- name?: string;
1635
- region?: RegionPlain | Element | Selector;
1636
- frames?: (
1637
- | {frame: Element | Selector | string | number; scrollRootElement?: Element | Selector}
1638
- | Element
1639
- | Selector
1640
- | string
1641
- | number
1642
- )[];
1643
- scrollRootElement?: Element | Selector;
1644
- fully?: boolean;
1645
- matchLevel?: MatchLevelPlain;
1646
- useDom?: boolean;
1647
- sendDom?: boolean;
1648
- enablePatterns?: boolean;
1649
- ignoreDisplacements?: boolean;
1650
- ignoreCaret?: boolean;
1651
- ignoreRegions?: (RegionPlain | Element | Selector)[];
1652
- layoutRegions?: (RegionPlain | Element | Selector)[];
1653
- strictRegions?: (RegionPlain | Element | Selector)[];
1654
- contentRegions?: (RegionPlain | Element | Selector)[];
1655
- floatingRegions?: (
1656
- | {
1657
- region: RegionPlain | Element | Selector;
1658
- maxUpOffset?: number;
1659
- maxDownOffset?: number;
1660
- maxLeftOffset?: number;
1661
- maxRightOffset?: number;
1662
- }
1663
- | RegionPlain
1664
- | Element
1665
- | Selector
1666
- )[];
1667
- accessibilityRegions?: (
1668
- | {region: RegionPlain | Element | Selector; type?: AccessibilityRegionTypePlain}
1669
- | RegionPlain
1670
- | Element
1671
- | Selector
1672
- )[];
1673
- disableBrowserFetching?: boolean;
1674
- layoutBreakpoints?: boolean | number[];
1675
- visualGridOptions?: {[key: string]: any};
1676
- hooks?: {beforeCaptureScreenshot: string};
1677
- renderId?: string;
1678
- variationGroupId?: string;
1679
- timeout?: number;
1680
- };
1681
-
1682
- export type ChromeEmulationInfo = {
1683
- chromeEmulationInfo: {deviceName: DeviceNamePlain; screenOrientation?: ScreenOrientationPlain};
1684
- };
1685
-
1686
- export type ConfigurationPlain = {
1687
- /** @undocumented */ logs?: LogHandlerPlain /** @undocumented */;
1688
- debugScreenshots?: {save: boolean; path?: string; prefix?: string};
1689
- agentId?: string;
1690
- apiKey?: string;
1691
- serverUrl?: string;
1692
- proxy?: ProxySettingsPlain;
1693
- isDisabled?: boolean /** @undocumented */;
1694
- connectionTimeout?: number /** @undocumented */;
1695
- removeSession?: boolean /** @undocumented */;
1696
- remoteEvents?: {serverUrl: string; accessKey?: string; timeout?: number};
1697
- } & {
1698
- appName?: string;
1699
- testName?: string;
1700
- displayName?: string;
1701
- viewportSize?: RectangleSizePlain;
1702
- sessionType?: SessionTypePlain;
1703
- properties?: PropertyDataPlain[];
1704
- batch?: BatchInfoPlain;
1705
- defaultMatchSettings?: ImageMatchSettingsPlain;
1706
- hostApp?: string;
1707
- hostOS?: string;
1708
- hostAppInfo?: string;
1709
- hostOSInfo?: string;
1710
- deviceInfo?: string;
1711
- baselineEnvName?: string;
1712
- environmentName?: string;
1713
- branchName?: string;
1714
- parentBranchName?: string;
1715
- baselineBranchName?: string;
1716
- compareWithParentBranch?: boolean;
1717
- ignoreBaseline?: boolean;
1718
- saveFailedTests?: boolean;
1719
- saveNewTests?: boolean;
1720
- saveDiffs?: boolean /** @undocumented */;
1721
- dontCloseBatches?: boolean;
1722
- } & {sendDom?: boolean; matchTimeout?: number; forceFullPageScreenshot?: boolean} & {
1723
- waitBeforeScreenshots?: number;
1724
- stitchMode?: StitchModePlain;
1725
- hideScrollbars?: boolean;
1726
- hideCaret?: boolean;
1727
- stitchOverlap?: number;
1728
- scrollRootElement?: Element | Selector;
1729
- cut?: CutProviderPlain;
1730
- rotation?: ImageRotationPlain;
1731
- scaleRatio?: number;
1732
- } & {
1733
- /** @undocumented */ concurrentSessions?: number;
1734
- browsersInfo?: (DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo)[];
1735
- visualGridOptions?: Record<string, any>;
1736
- layoutBreakpoints?: boolean | number[];
1737
- disableBrowserFetching?: boolean;
1738
- };
1739
-
1740
- export type ConsoleLogHandlerPlain = {type: 'console'};
1741
-
1742
- export type CorsIframeHandlePlain = 'BLANK' | 'KEEP' | 'SNAPSHOT';
1743
-
1744
- export type CustomLogHandlerPlain = {
1745
- log(message: any): void;
1746
- warn?(message: any): void;
1747
- error?(message: any): void;
1748
- fatal?(message: any): void;
1749
- open?(): void;
1750
- close?(): void;
1751
- };
1752
-
1753
- export type CutProviderPlain =
1754
- | {top: number; right: number; bottom: number; left: number}
1755
- | {x: number; y: number; width: number; height: number};
1756
-
1757
- export type DesktopBrowserInfo = {height: number; name?: BrowserTypePlain; width: number};
1758
-
1759
- export type DeviceNamePlain =
1760
- | 'BlackBerry Z30'
1761
- | 'Blackberry PlayBook'
1762
- | 'Galaxy A5'
1763
- | 'Galaxy Note 10'
1764
- | 'Galaxy Note 10 Plus'
1765
- | 'Galaxy Note 2'
1766
- | 'Galaxy Note 3'
1767
- | 'Galaxy Note 4'
1768
- | 'Galaxy Note 8'
1769
- | 'Galaxy Note 9'
1770
- | 'Galaxy S10'
1771
- | 'Galaxy S10 Plus'
1772
- | 'Galaxy S3'
1773
- | 'Galaxy S5'
1774
- | 'Galaxy S8'
1775
- | 'Galaxy S8 Plus'
1776
- | 'Galaxy S9'
1777
- | 'Galaxy S9 Plus'
1778
- | 'Kindle Fire HDX'
1779
- | 'LG G6'
1780
- | 'LG Optimus L70'
1781
- | 'Laptop with HiDPI screen'
1782
- | 'Laptop with MDPI screen'
1783
- | 'Laptop with touch'
1784
- | 'Microsoft Lumia 550'
1785
- | 'Microsoft Lumia 950'
1786
- | 'Nexus 10'
1787
- | 'Nexus 4'
1788
- | 'Nexus 5'
1789
- | 'Nexus 5X'
1790
- | 'Nexus 6'
1791
- | 'Nexus 6P'
1792
- | 'Nexus 7'
1793
- | 'Nokia Lumia 520'
1794
- | 'Nokia N9'
1795
- | 'OnePlus 7T'
1796
- | 'OnePlus 7T Pro'
1797
- | 'Pixel 2'
1798
- | 'Pixel 2 XL'
1799
- | 'Pixel 3'
1800
- | 'Pixel 3 XL'
1801
- | 'Pixel 4'
1802
- | 'Pixel 4 XL'
1803
- | 'iPad'
1804
- | 'iPad 6th Gen'
1805
- | 'iPad 7th Gen'
1806
- | 'iPad Air 2'
1807
- | 'iPad Mini'
1808
- | 'iPad Pro'
1809
- | 'iPhone 11'
1810
- | 'iPhone 11 Pro'
1811
- | 'iPhone 11 Pro Max'
1812
- | 'iPhone 4'
1813
- | 'iPhone 5/SE'
1814
- | 'iPhone 6/7/8'
1815
- | 'iPhone 6/7/8 Plus'
1816
- | 'iPhone X'
1817
- | 'iPhone XR'
1818
- | 'iPhone XS'
1819
- | 'iPhone XS Max';
1820
-
1821
- export type Driver = globalThis.TestController;
1822
-
1823
- export type Element = globalThis.Selector | globalThis.NodeSnapshot;
1824
-
1825
- /** @undocumented */
1826
- export type ExactMatchSettingsPlain = {
1827
- matchThreshold: number;
1828
- minDiffHeight: number;
1829
- minDiffIntensity: number;
1830
- minDiffWidth: number;
1831
- };
1832
-
1833
- export type FailureReportPlain = 'IMMEDIATE' | 'ON_CLOSE';
1834
-
1835
- export type FileLogHandlerPlain = {type: 'file'; filename?: string; append?: boolean};
1836
-
1837
- /** @undocumented */
1838
- export type FloatingMatchSettingsPlain = {
1839
- maxDownOffset?: number;
1840
- maxLeftOffset?: number;
1841
- maxRightOffset?: number;
1842
- maxUpOffset?: number;
1843
- region: RegionPlain;
1844
- };
1845
-
1846
- export type IOSDeviceInfo = {
1847
- iosDeviceInfo: {
1848
- deviceName: IosDeviceNamePlain;
1849
- iosVersion?: IosVersionPlain;
1850
- screenOrientation?: ScreenOrientationPlain;
1851
- };
1852
- };
1853
-
1854
- /** @undocumented */
1855
- export type ImageMatchSettingsPlain = {
1856
- accessibilityRegions?: (RegionPlain | AccessibilityMatchSettingsPlain)[];
1857
- accessibilitySettings?: AccessibilitySettings;
1858
- contentRegions?: RegionPlain[];
1859
- enablePatterns?: boolean;
1860
- exact?: ExactMatchSettingsPlain;
1861
- floatingRegions?: (RegionPlain | FloatingMatchSettingsPlain)[];
1862
- ignoreCaret?: boolean;
1863
- ignoreDisplacements?: boolean;
1864
- ignoreRegions?: RegionPlain[];
1865
- layoutRegions?: RegionPlain[];
1866
- matchLevel?: MatchLevelPlain;
1867
- strictRegions?: RegionPlain[];
1868
- useDom?: boolean;
1869
- };
1870
-
1871
- export type ImageRotationPlain = -270 | -180 | -90 | 0 | 90 | 180 | 270;
1872
-
1873
- export type IosDeviceNamePlain =
1874
- | 'iPad (7th generation)'
1875
- | 'iPad Air (2nd generation)'
1876
- | 'iPad Pro (12.9-inch) (3rd generation)'
1877
- | 'iPhone 11'
1878
- | 'iPhone 11 Pro'
1879
- | 'iPhone 11 Pro Max'
1880
- | 'iPhone 7'
1881
- | 'iPhone 8'
1882
- | 'iPhone X'
1883
- | 'iPhone XR'
1884
- | 'iPhone Xs';
1885
-
1886
- export type IosVersionPlain = 'latest' | 'latest-1';
1887
-
1888
- export type LocationPlain = {x: number; y: number};
1889
-
1890
- export type LogHandlerPlain = CustomLogHandlerPlain | FileLogHandlerPlain | ConsoleLogHandlerPlain;
1891
-
1892
- export type MatchLevelPlain = 'Content' | 'Exact' | 'Layout' | 'Layout2' | 'Layout1' | 'None' | 'Strict';
1893
-
1894
- export type MatchResultPlain = {readonly asExpected?: boolean; readonly windowId?: number};
1895
-
1896
- export type OCRRegion = {target: RegionPlain | Element | Selector; hint?: string; minMatch?: number; language?: string};
1897
-
1898
- export type OCRSettings<TPattern extends string = string> = {
1899
- firstOnly?: boolean;
1900
- ignoreCase?: boolean;
1901
- language?: string;
1902
- patterns: TPattern[];
1903
- };
1904
-
1905
- export type PropertyDataPlain = {name: string; value: string};
1906
-
1907
- export type ProxySettingsPlain = {isHttpOnly?: boolean; password?: string; url: string; username?: string};
1908
-
1909
- export type RectangleSizePlain = {height: number; width: number};
1910
-
1911
- export type RegionPlain = LocationPlain & RectangleSizePlain;
1912
-
1913
- export type RunnerOptionsPlain = {testConcurrency?: number};
1914
-
1915
- export type ScreenOrientationPlain = 'landscape' | 'portrait';
1916
-
1917
- export type Selector = globalThis.Selector | {selector: string; type: string} | string;
1918
-
1919
- export type SessionTypePlain = 'PROGRESSION' | 'SEQUENTIAL';
1920
-
1921
- export type SessionUrlsPlain = {readonly batch?: string; readonly session?: string};
1922
-
1923
- export type StepInfoPlain = {
1924
- readonly apiUrls?: ApiUrlsPlain;
1925
- readonly appUrls?: AppUrlsPlain;
1926
- readonly hasBaselineImage?: boolean;
1927
- readonly hasCurrentImage?: boolean;
1928
- readonly isDifferent?: boolean;
1929
- readonly name?: string;
1930
- readonly renderId?: string[];
1931
- };
1932
-
1933
- export type StitchModePlain = 'CSS' | 'Scroll';
1934
-
1935
- export type TestAccessibilityStatus = {
1936
- readonly level: AccessibilityLevelPlain;
1937
- readonly status: AccessibilityStatusPlain;
1938
- readonly version: AccessibilityGuidelinesVersionPlain;
1939
- };
1940
-
1941
- /** @undocumented */
1942
- export type TestCafeCheckSettings<TSelector> = {
1943
- accessibility?:
1944
- | (RegionPlain | TSelector | ({selector: TSelector} & {accessibilityType: AccessibilityRegionType}))
1945
- | (RegionPlain | TSelector | ({selector: TSelector} & {accessibilityType: AccessibilityRegionType}))[];
1946
- content?: RegionPlain | TSelector | {selector: TSelector} | (RegionPlain | TSelector | {selector: TSelector})[];
1947
- floating?:
1948
- | (
1949
- | RegionPlain
1950
- | TSelector
1951
- | ({selector: TSelector} & {
1952
- maxUpOffset?: number;
1953
- maxDownOffset?: number;
1954
- maxLeftOffset?: number;
1955
- maxRightOffset?: number;
1956
- })
1957
- )
1958
- | (
1959
- | RegionPlain
1960
- | TSelector
1961
- | ({selector: TSelector} & {
1962
- maxUpOffset?: number;
1963
- maxDownOffset?: number;
1964
- maxLeftOffset?: number;
1965
- maxRightOffset?: number;
1966
- })
1967
- )[];
1968
- fully?: boolean;
1969
- ignore?: RegionPlain | TSelector | {selector: TSelector} | (RegionPlain | TSelector | {selector: TSelector})[];
1970
- ignoreDisplacements?: boolean;
1971
- layout?: RegionPlain | TSelector | {selector: TSelector} | (RegionPlain | TSelector | {selector: TSelector})[];
1972
- region?: RegionPlain;
1973
- scriptHooks?: {beforeCaptureScreenshot: string};
1974
- selector?: TSelector;
1975
- sendDom?: boolean;
1976
- strict?: RegionPlain | TSelector | {selector: TSelector} | (RegionPlain | TSelector | {selector: TSelector})[];
1977
- tag?: string;
1978
- target?: 'window' | 'region';
1979
- };
1980
-
1981
- /** @undocumented */
1982
- export type TestCafeConfiguration = {
1983
- accessibilityValidation?: AccessibilitySettings;
1984
- appName?: string;
1985
- baselineBranch?: string;
1986
- baselineBranchName?: string;
1987
- baselineEnvName?: string;
1988
- batchId?: string;
1989
- batchName?: string;
1990
- batchNotify?: boolean;
1991
- batchSequence?: string;
1992
- batchSequenceName?: string;
1993
- branch?: string;
1994
- branchName?: string;
1995
- browser?:
1996
- | DesktopBrowserInfo
1997
- | ChromeEmulationInfo
1998
- | IOSDeviceInfo
1999
- | (DesktopBrowserInfo | ChromeEmulationInfo | IOSDeviceInfo)[];
2000
- compareWithParentBranch?: boolean;
2001
- concurrency?: number;
2002
- envName?: string;
2003
- failTestcafeOnDiff?: boolean;
2004
- ignoreBaseline?: boolean;
2005
- ignoreCaret?: boolean;
2006
- ignoreDisplacements?: boolean;
2007
- isDisabled?: boolean;
2008
- matchLevel?: MatchLevel;
2009
- notifyOnCompletion?: boolean;
2010
- parentBranch?: string;
2011
- parentBranchName?: string;
2012
- properties?: {name: string; value: any}[];
2013
- proxy?: string | ProxySettingsPlain;
2014
- saveDiffs?: boolean;
2015
- saveFailedTests?: boolean;
2016
- saveNewTests?: boolean;
2017
- tapDirPath?: string;
2018
- testName?: string;
2019
- };
2020
-
2021
- export type TestResultContainerPlain = {readonly exception: EyesError; readonly testResults: TestResultsPlain};
2022
-
2023
- export type TestResultsPlain = {
2024
- readonly accessibilityStatus?: TestAccessibilityStatus;
2025
- readonly apiUrls?: SessionUrlsPlain;
2026
- readonly appName?: string;
2027
- readonly appUrls?: SessionUrlsPlain;
2028
- readonly batchId?: string;
2029
- readonly batchName?: string;
2030
- readonly branchName?: string;
2031
- readonly contentMatches?: number;
2032
- readonly duration?: number;
2033
- readonly exactMatches?: number;
2034
- readonly hostApp?: string;
2035
- readonly hostDisplaySize?: RectangleSizePlain;
2036
- readonly hostOS?: string;
2037
- readonly isAborted?: boolean;
2038
- readonly isDifferent?: boolean;
2039
- readonly isNew?: boolean;
2040
- readonly layoutMatches?: number;
2041
- readonly matches?: number;
2042
- readonly mismatches?: number;
2043
- readonly missing?: number;
2044
- readonly name?: string;
2045
- readonly noneMatches?: number;
2046
- readonly secretToken?: string;
2047
- readonly startedAt?: Date | string;
2048
- readonly status?: TestResultsStatusPlain;
2049
- readonly steps?: number;
2050
- readonly stepsInfo?: StepInfoPlain[];
2051
- readonly strictMatches?: number;
2052
- readonly testId?: string;
2053
- readonly url?: string;
2054
- };
2055
-
2056
- export type TestResultsStatusPlain = 'Failed' | 'Passed' | 'Unresolved';
2057
-
2058
- export type TestResultsSummaryPlain = Iterable<TestResultContainerPlain>;
2059
-
2060
- export type TextRegion = {height: number; text: string; width: number; x: number; y: number};
2061
-
2062
- /** @undocumented */
2063
- export type ValidationInfoPlain = {readonly tag: string; readonly validationId: number};
2064
-
2065
- /** @undocumented */
2066
- export type ValidationResultPlain = {readonly asExpected: boolean};
2067
-
2068
- export type VisualLocatorSettings<TLocator extends string = string> = {firstOnly: boolean; locatorNames: TLocator[]};
2069
-
2070
- export const Target: {
2071
- window(): CheckSettings;
2072
- region(region: RegionPlain): CheckSettings;
2073
- region(region: Element): CheckSettings;
2074
- region(region: Selector): CheckSettings;
2075
- frame(context: {frame: Element | Selector | string | number; scrollRootElement?: Element | Selector}): CheckSettings;
2076
- frame(frame: Element, scrollRootElement?: Element): CheckSettings;
2077
- frame(frame: Element, scrollRootElement?: Selector): CheckSettings;
2078
- frame(frame: Selector, scrollRootElement?: Element): CheckSettings;
2079
- frame(frame: Selector, scrollRootElement?: Selector): CheckSettings;
2080
- frame(frame: string, scrollRootElement?: Element): CheckSettings;
2081
- frame(frame: string, scrollRootElement?: Selector): CheckSettings;
2082
- frame(frame: number, scrollRootElement?: Element): CheckSettings;
2083
- frame(frame: number, scrollRootElement?: Selector): CheckSettings;
2084
- };
2085
-
2086
- /** @deprecated */
2087
- export function RunnerOptions(): RunnerOptionsFluent;
2088
-
2089
- export function closeBatch(spec: {
2090
- closeBatches(options: {
2091
- batchIds: string[];
2092
- serverUrl?: string;
2093
- apiKey?: string;
2094
- proxy?: ProxySettingsPlain;
2095
- }): Promise<void>;
2096
- }): {(options: {batchIds: string[]; serverUrl?: string; apiKey?: string; proxy?: ProxySettingsPlain}): Promise<void>};