@skbkontur/playwright-react-ui-components 1.13.0 → 1.13.2

package/build/src/components/ComponentList.d.ts

@@ -9,12 +9,31 @@ export declare class ComponentList<TItem extends BaseComponent> extends BaseComp
     readonly itemsLocator: Locator;
     constructor(rootLocator: Locator, itemsLocator: (rootLocator: Locator) => Locator, itemFactory: (locator: Locator) => TItem);
     isVisible(options?: IsVisibleOptions): Promise<boolean>;
+    /**
+     * Поведение метода идентично вызову locator.all()
+     *
+     * getItems не ждет появления элементов, соответствующих локатору, а сразу возвращает всё, что есть на странице в данный момент.
+     * Когда список элементов меняется динамически, использование getItems приведёт к непредсказуемым и нестабильным результатам.
+     * Когда список элементов стабилен, но загружается динамически, необходимо дождаться полной загрузки списка перед вызовом getItems
+     */
     getItems(): Promise<TItem[]>;
+    /**
+     * Поведение метода идентично вызову locator.nth(0)
+     */
     getFirstItem(): Promise<TItem>;
+    /**
+     * Поведение метода идентично вызову locator.nth(-1)
+     */
     getLastItem(): Promise<TItem>;
+    /**
+     * Поведение метода идентично вызову locator.nth(index)
+     */
     getItemByIndex(index: number): Promise<TItem>;
     getFirstItemByPredicate(predicate: (item: TItem) => Promise<boolean>): Promise<TItem>;
     getItemsByPredicate(predicate: (item: TItem) => Promise<boolean>): Promise<TItem[]>;
+    /**
+     * Поведение метода идентично вызову locator.count()
+     */
     count(): Promise<number>;
     getTooltip(type: TooltipType): Promise<import("./Tooltip").Tooltip>;
     expect(): ComponentListAssertions<TItem>;

package/build/src/components/ComponentList.js

@@ -75,6 +75,13 @@ var ComponentList = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Поведение метода идентично вызову locator.all()
+     *
+     * getItems не ждет появления элементов, соответствующих локатору, а сразу возвращает всё, что есть на странице в данный момент.
+     * Когда список элементов меняется динамически, использование getItems приведёт к непредсказуемым и нестабильным результатам.
+     * Когда список элементов стабилен, но загружается динамически, необходимо дождаться полной загрузки списка перед вызовом getItems
+     */
     ComponentList.prototype.getItems = function () {
         return __awaiter(this, void 0, void 0, function () {
             var itemsLocators;
@@ -92,6 +99,9 @@ var ComponentList = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Поведение метода идентично вызову locator.nth(0)
+     */
     ComponentList.prototype.getFirstItem = function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -99,6 +109,9 @@ var ComponentList = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Поведение метода идентично вызову locator.nth(-1)
+     */
     ComponentList.prototype.getLastItem = function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -106,6 +119,9 @@ var ComponentList = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Поведение метода идентично вызову locator.nth(index)
+     */
     ComponentList.prototype.getItemByIndex = function (index) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
@@ -175,6 +191,9 @@ var ComponentList = /** @class */ (function (_super) {
             });
         });
     };
+    /**
+     * Поведение метода идентично вызову locator.count()
+     */
     ComponentList.prototype.count = function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {

package/build/src/components/Loader.d.ts

@@ -5,7 +5,11 @@ import type { InnerTextOptions } from '../options';
 export declare class Loader extends BaseComponent {
     constructor(rootLocator: Locator);
     getText(options?: InnerTextOptions): Promise<string>;
-    waitLoading(): Promise<void>;
-    waitLoaded(): Promise<void>;
+    waitLoading(options?: {
+        timeout?: number;
+    }): Promise<void>;
+    waitLoaded(options?: {
+        timeout?: number;
+    }): Promise<void>;
     expect(): LoaderAssertions;
 }

package/build/src/components/Loader.js

@@ -71,11 +71,11 @@ var Loader = /** @class */ (function (_super) {
             });
         });
     };
-    Loader.prototype.waitLoading = function () {
+    Loader.prototype.waitLoading = function (options) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.waitFor()];
+                    case 0: return [4 /*yield*/, this.waitFor(options)];
                     case 1:
                         _a.sent();
                         return [2 /*return*/];
@@ -83,11 +83,11 @@ var Loader = /** @class */ (function (_super) {
             });
         });
     };
-    Loader.prototype.waitLoaded = function () {
+    Loader.prototype.waitLoaded = function (options) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.waitFor({ state: 'hidden' })];
+                    case 0: return [4 /*yield*/, this.waitFor({ state: 'hidden', timeout: options === null || options === void 0 ? void 0 : options.timeout })];
                     case 1:
                         _a.sent();
                         return [2 /*return*/];

package/build/src/components/Spinner.d.ts

@@ -6,7 +6,11 @@ export declare class Spinner extends BaseComponent {
     readonly rootLocator: Locator;
     constructor(rootLocator: Locator);
     getText(options?: InnerTextOptions): Promise<string>;
-    waitLoading(): Promise<void>;
-    waitLoaded(): Promise<void>;
+    waitLoading(options?: {
+        timeout?: number;
+    }): Promise<void>;
+    waitLoaded(options?: {
+        timeout?: number;
+    }): Promise<void>;
     expect(): SpinnerAssertions;
 }

package/build/src/components/Spinner.js

@@ -71,11 +71,11 @@ var Spinner = /** @class */ (function (_super) {
             });
         });
     };
-    Spinner.prototype.waitLoading = function () {
+    Spinner.prototype.waitLoading = function (options) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.waitFor()];
+                    case 0: return [4 /*yield*/, this.waitFor(options)];
                     case 1:
                         _a.sent();
                         return [2 /*return*/];
@@ -83,11 +83,11 @@ var Spinner = /** @class */ (function (_super) {
             });
         });
     };
-    Spinner.prototype.waitLoaded = function () {
+    Spinner.prototype.waitLoaded = function (options) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.waitFor({ state: 'hidden' })];
+                    case 0: return [4 /*yield*/, this.waitFor({ state: 'hidden', timeout: options === null || options === void 0 ? void 0 : options.timeout })];
                     case 1:
                         _a.sent();
                         return [2 /*return*/];

package/build/src/matchers/formattedMatchers.d.ts

@@ -12,7 +12,7 @@ export declare const formattedMatchers: import("@playwright/test").Expect<{
         pass: boolean;
         name: string;
         expected: string;
-        actual: any;
+        actual: unknown;
     }>;
     toHaveFormattedText(this: ExpectMatcherState, locator: Locator, expected: string, options?: {
         timeout?: number;
@@ -22,7 +22,7 @@ export declare const formattedMatchers: import("@playwright/test").Expect<{
         pass: boolean;
         name: string;
         expected: string;
-        actual: any;
+        actual: unknown;
     }>;
     toContainFormattedText(this: ExpectMatcherState, locator: Locator, expected: string, options?: {
         timeout?: number;
@@ -32,6 +32,6 @@ export declare const formattedMatchers: import("@playwright/test").Expect<{
         pass: boolean;
         name: string;
         expected: string;
-        actual: any;
+        actual: unknown;
     }>;
 }>;

package/build/src/matchers/formattedMatchers.js

@@ -72,28 +72,28 @@ function toHaveFormatted(getter, assertionName, context, strictExpect) {
                 });
             });
         }
-        var _a, timeout, _b, transform, pass, actual, e_1, message;
-        return __generator(this, function (_c) {
-            switch (_c.label) {
+        var _a, timeout, _b, transform, pass, actual, _c, message;
+        return __generator(this, function (_d) {
+            switch (_d.label) {
                 case 0:
                     _a = options || {}, timeout = _a.timeout, _b = _a.transform, transform = _b === void 0 ? removeSpaces : _b;
-                    _c.label = 1;
+                    _d.label = 1;
                 case 1:
-                    _c.trys.push([1, 6, , 7]);
+                    _d.trys.push([1, 6, , 7]);
                     if (!strictExpect) return [3 /*break*/, 3];
                     return [4 /*yield*/, test_1.expect.poll(pollAndTransform, { timeout: timeout }).toEqual(transform(expected))];
                 case 2:
-                    _c.sent();
+                    _d.sent();
                     return [3 /*break*/, 5];
                 case 3: return [4 /*yield*/, test_1.expect.poll(pollAndTransform, { timeout: timeout }).toContain(transform(expected))];
                 case 4:
-                    _c.sent();
-                    _c.label = 5;
+                    _d.sent();
+                    _d.label = 5;
                 case 5:
                     pass = true;
                     return [3 /*break*/, 7];
                 case 6:
-                    e_1 = _c.sent();
+                    _c = _d.sent();
                     pass = false;
                     return [3 /*break*/, 7];
                 case 7:

package/build/src/matchers/mergedExpects.d.ts

@@ -1,25 +1,15 @@
 import { type Expect, type Locator } from '@playwright/test';
 import type { TransformOptions } from '../options';
-export declare const mergedExpects: Expect<{
-    toHaveFormattedValue(locator: Locator, expected: string, options?: TransformOptions): Promise<{
-        message: () => string;
-        pass: boolean;
-        name: string;
-        expected: string;
-        actual: any;
-    }>;
-    toHaveFormattedText(locator: Locator, expected: string, options?: TransformOptions): Promise<{
-        message: () => string;
-        pass: boolean;
-        name: string;
-        expected: string;
-        actual: any;
-    }>;
-    toContainFormattedText(locator: Locator, expected: string, options?: TransformOptions): Promise<{
-        message: () => string;
-        pass: boolean;
-        name: string;
-        expected: string;
-        actual: any;
-    }>;
+export interface FormattedMatcherResult {
+    message: () => string;
+    pass: boolean;
+    name: string;
+    expected: string;
+    actual: unknown;
+}
+export type ExtendedExpect = Expect<{
+    toHaveFormattedValue(locator: Locator, expected: string, options?: TransformOptions): Promise<FormattedMatcherResult>;
+    toHaveFormattedText(locator: Locator, expected: string, options?: TransformOptions): Promise<FormattedMatcherResult>;
+    toContainFormattedText(locator: Locator, expected: string, options?: TransformOptions): Promise<FormattedMatcherResult>;
 }>;
+export declare const mergedExpects: ExtendedExpect;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skbkontur/playwright-react-ui-components",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "description": "Пакет для взаимодействия с компонентами @skbkontur/react-ui при тестировании с помощью Playwright",
   "main": "build/index.js",
   "files": [
@@ -9,8 +9,9 @@
   "scripts": {
     "prepare": "npm run build",
     "build": "tsc",
-    "lint:eslint": "run -T eslint --ext .ts,.tsx src --quiet",
-    "lint:types": "run -T tsc --noEmit"
+    "lint:eslint": "eslint --ext .ts,.tsx src --quiet",
+    "lint:types": "tsc --noEmit",
+    "test": "echo 'no tests in components package'"
   },
   "author": "Evgeniy Ivanov (https://staff.skbkontur.ru/profile/sephiroth) & Fintech",
   "repository": {