@applitools/eyes-testcafe 1.15.0 → 1.15.1

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