d5-testing-library 2.0.0-alpha.1 → 2.0.0-alpha.11

package/dist/cjs/d5-testing-library.cjs

@@ -76,11 +76,14 @@ var init_AbstractElement = __esm({
       joinRelativeCssSelectors(selectors) {
         return selectors.join(" ");
       }
-      getLocator() {
+      syncLocator() {
         return this.page.locator(`css=${this.getFullCssSelector()}`);
       }
+      getLocator() {
+        return this.syncLocator();
+      }
       async getAttribute(attr) {
-        const locator = this.getLocator();
+        const locator = this.syncLocator();
         if (await locator.isVisible()) {
           return locator.getAttribute(attr);
         }
@@ -329,7 +332,7 @@ var init_AbstractEditor = __esm({
       async setInputValue(value) {
         const input = this.getInputLocator();
         await input.click();
-        await input.fill(value + "");
+        await input.pressSequentially(value + "");
         await input.press("Enter");
       }
       async clear() {
@@ -403,6 +406,7 @@ var init_types = __esm({
       ControlClass2["BooleanSelector"] = "buttons-group";
       ControlClass2["ButtonGroup"] = "button-group-field";
       ControlClass2["HeaderFilterDictionary"] = "header-filter-dictionary";
+      ControlClass2["FileUploader"] = "file-uploader";
       return ControlClass2;
     })(ControlClass || {});
   }
@@ -453,7 +457,7 @@ var init_xpathHelper = __esm({
     "use strict";
     XPathHelper = class {
       static getClassAndValueXpath(cssClass, value) {
-        return `div[contains(@class, '${cssClass}') and contains(.,'${value}')]`;
+        return `div[contains(@class, '${cssClass}') and .='${value}']`;
       }
     };
   }
@@ -470,7 +474,7 @@ function isEmptyValue(value) {
   }
   return false;
 }
-var types, isObject, isEmptyObject, type, isNull, isArray, isDefined, isString, isDate, isArrayOfDates, isUndefined;
+var types, isObject, isEmptyObject, type, isNull, isArray, isDefined, isString, isNumeric, isDate, isArrayOfDates, isUndefined;
 var init_typesUtil = __esm({
   "src/utils/typesUtil.ts"() {
     "use strict";
@@ -503,6 +507,9 @@ var init_typesUtil = __esm({
     isString = function(object) {
       return typeof object === "string";
     };
+    isNumeric = function(object) {
+      return typeof object === "number" && isFinite(object) || !isNaN(object - parseFloat(object));
+    };
     isDate = function(object) {
       return type(object) === "date";
     };
@@ -552,7 +559,7 @@ var init_SelectBoxEditor = __esm({
         const inputEl = this.getInputLocator();
         await inputEl.click();
         try {
-          await inputEl.fill(value);
+          await inputEl.pressSequentially(value + "");
           await inputEl.press("Enter");
           await dropDownOptionClick(value, this.page, false);
         } catch {
@@ -655,12 +662,12 @@ var init_TagBox = __esm({
         try {
           await dropDownOptionClick(value, this.page, false);
         } catch {
-          await input.fill(value);
+          await input.pressSequentially(value + "");
           await dropDownOptionClick(value, this.page, true);
         }
         await this.waitOptionSelection(value);
         if (value !== lastElement) {
-          await input.fill("");
+          await input.pressSequentially("");
         }
       }
       async confirmSelection() {
@@ -1057,7 +1064,6 @@ var init_SingleDateEditor = __esm({
     init_BaseDateEditor();
     init_utils();
     init_ClearButtonStrategy();
-    init_src();
     SingleDateEditor = class extends BaseDateEditor {
       constructor(parentCssSelector, elementCssSelector, page) {
         super(parentCssSelector, elementCssSelector, page);
@@ -1080,11 +1086,7 @@ var init_SingleDateEditor = __esm({
       }
       async setValue(value) {
         if (value instanceof Date) {
-          await wait(async () => {
-            await this.setDateValue(value);
-            const updatedValue = await this.getValue();
-            return updatedValue.toDateString() === value.toDateString();
-          }, this.page);
+          await this.setDateValue(value);
         } else {
           throw new Error(`Value is incorrect. It should be a Date object`);
         }
@@ -1180,7 +1182,7 @@ var init_DateEditor = __esm({
 });
 
 // src/pageObjects/elements/Editors/HeaderFilterDictionary.ts
-var TAGS_SELECTOR2, DX_TAG_CONTAINER2, DX_TEXTEDITOR_EMPTY3, CUSTOM_OPTION_LIST_SELECTOR, SELECT_BOX_OPTION_TEXT_CONTAINER_CLASS2, TAG_BOX_LIST_ITEM_SELECTOR, combinedOptionHeaderFilterDictValueXpath, dropDownHeaderFilterDictionaryOptionClick, HeaderFilterDictionary;
+var TAGS_SELECTOR2, DX_TAG_CONTAINER2, DX_TEXTEDITOR_EMPTY3, CUSTOM_OPTION_LIST_SELECTOR, SELECT_BOX_OPTION_TEXT_CONTAINER_CLASS2, TAG_BOX_LIST_ITEM_SELECTOR, dropDownHeaderFilterDictionaryOptionClick, HeaderFilterDictionary;
 var init_HeaderFilterDictionary = __esm({
   "src/pageObjects/elements/Editors/HeaderFilterDictionary.ts"() {
     "use strict";
@@ -1193,12 +1195,11 @@ var init_HeaderFilterDictionary = __esm({
     CUSTOM_OPTION_LIST_SELECTOR = "custom-list";
     SELECT_BOX_OPTION_TEXT_CONTAINER_CLASS2 = "d5-multi-select-item";
     TAG_BOX_LIST_ITEM_SELECTOR = '.dx-overlay-wrapper .dx-list-item[aria-selected="true"]';
-    combinedOptionHeaderFilterDictValueXpath = (value) => `//div[contains(@class, '${SELECT_BOX_OPTION_TEXT_CONTAINER_CLASS2}') and contains(text(), '${value}')]`;
     dropDownHeaderFilterDictionaryOptionClick = async (optionValue, page, dataTEST = "", delay = true) => {
       const calendarPopoverSelector = byTestIdCssSelector(`${dataTEST}`);
       const calendarPopover = page.locator(calendarPopoverSelector);
       const customOptionList = calendarPopover.locator(`.${CUSTOM_OPTION_LIST_SELECTOR}`);
-      const optElement = customOptionList.locator(`xpath=${combinedOptionHeaderFilterDictValueXpath(optionValue)}`);
+      const optElement = customOptionList.locator(`.${SELECT_BOX_OPTION_TEXT_CONTAINER_CLASS2}`, { hasText: optionValue });
       try {
         await optElement.waitFor({ state: "visible", timeout: delay ? void 0 : 600 });
         await optElement.click();
@@ -1222,28 +1223,28 @@ var init_HeaderFilterDictionary = __esm({
           await this.selectOption(inputEl, value, lastElement);
         }
       }
-      async waitOptionSelection() {
-        const selectedItem = this.page.locator(TAG_BOX_LIST_ITEM_SELECTOR);
-        await selectedItem.waitFor({ state: "visible" });
+      async waitOptionSelection(value) {
+        await this.page.locator(`${TAG_BOX_LIST_ITEM_SELECTOR}`).filter({ hasText: value }).first().waitFor({ state: "visible" });
       }
       async selectOption(inputEl, value, lastElement) {
         try {
-          await inputEl.fill(value);
+          await inputEl.pressSequentially(value + "");
           const dataTEST = await this.getDataTestId();
           await dropDownHeaderFilterDictionaryOptionClick(value, this.page, dataTEST);
           if (value !== lastElement) {
-            await inputEl.fill("");
+            await inputEl.pressSequentially("");
           }
         } catch (error) {
           throw error;
         }
-        await this.waitOptionSelection();
+        await this.waitOptionSelection(value);
       }
       async getHeaderFilterDictionaryInputValue() {
         if (await this.isHeaderFilterDictionaryEmpty()) {
           return [];
         }
         const tags = this.page.locator(`${this.getFullCssSelector()} .${DX_TAG_CONTAINER2} ${TAGS_SELECTOR2}`);
+        await tags.first().waitFor({ state: "visible" });
         const count = await tags.count();
         const values = [];
         for (let i = 0; i < count; i++) {
@@ -1269,6 +1270,130 @@ var init_HeaderFilterDictionary = __esm({
   }
 });
 
+// src/pageObjects/elements/Editors/FileUploader.ts
+var FILE_NAME_SELECTOR, FILE_SIZE_ATTRIBUTE, FILE_DATE_ATTRIBUTE, FILE_TYPE_ATTRIBUTE, SELECT_FILE_BUTTON_SELECTOR, DOWNLOAD_FILE_BUTTON_SELECTOR, METADATA_SELECTOR, CLEAR_BUTTON_SELECTOR, FileUploader;
+var init_FileUploader = __esm({
+  "src/pageObjects/elements/Editors/FileUploader.ts"() {
+    "use strict";
+    init_AbstractElementWithParent();
+    init_typesUtil();
+    FILE_NAME_SELECTOR = ".file-text";
+    FILE_SIZE_ATTRIBUTE = "data-filesize";
+    FILE_DATE_ATTRIBUTE = "data-moddate";
+    FILE_TYPE_ATTRIBUTE = "data-filetype";
+    SELECT_FILE_BUTTON_SELECTOR = ".select-file-button";
+    DOWNLOAD_FILE_BUTTON_SELECTOR = ".download-file-button";
+    METADATA_SELECTOR = ".file-text-file-info-wrapper";
+    CLEAR_BUTTON_SELECTOR = ".clear-button";
+    FileUploader = class extends AbstractElementWithParent {
+      constructor(parentCssSelector, elementCssSelector, page) {
+        super(parentCssSelector, elementCssSelector, page);
+      }
+      /**
+       * Returns the metadata container element for the uploaded file.
+       * Returns null when metadata is not rendered or not visible.
+       */
+      async getMedataElement() {
+        const root = this.getFullCssSelector();
+        const locator = this.page.locator(`${root} ${METADATA_SELECTOR}`);
+        if (!await locator.isVisible()) return null;
+        return locator;
+      }
+      /**
+       * Returns the name of the uploaded file, or null if not present.
+       */
+      async getFileName() {
+        const root = this.getFullCssSelector();
+        const locator = this.page.locator(`${root} ${FILE_NAME_SELECTOR}`);
+        if (!await locator.isVisible()) return null;
+        const text = await locator.innerText();
+        return text?.trim() || null;
+      }
+      /**
+       * Returns the size of the uploaded file, or null if not present.
+       */
+      async getFileSize() {
+        const element = await this.getMedataElement();
+        if (!element) return null;
+        const result = (await element.getAttribute(FILE_SIZE_ATTRIBUTE))?.trim();
+        return isNaN(+result) ? null : +result;
+      }
+      /**
+       * Returns the upload/modification date of the file, or null if not present.
+       */
+      async getFileDate() {
+        const element = await this.getMedataElement();
+        if (!element) return null;
+        const fileModDate = (await element.getAttribute(FILE_DATE_ATTRIBUTE))?.trim();
+        if (isNumeric(+fileModDate)) {
+          const dateString = (/* @__PURE__ */ new Date(+fileModDate)).toISOString();
+          return new Date(dateString.split("T")[0]);
+        }
+        return fileModDate ? new Date(fileModDate.split("T")[0]) : null;
+      }
+      /**
+       * Returns the MIME/content type of the uploaded file from metadata.
+       * Returns null when the type attribute is absent or empty.
+       */
+      async getFileType() {
+        const element = await this.getMedataElement();
+        if (!element) return null;
+        const fileType = (await element.getAttribute(FILE_TYPE_ATTRIBUTE))?.trim();
+        return fileType || null;
+      }
+      /**
+       * Returns current file information: name, size and upload/modification date.
+       * Returns null if no file is uploaded.
+       */
+      async getValue() {
+        const name = await this.getFileName();
+        const size = await this.getFileSize();
+        const date = await this.getFileDate();
+        const type2 = await this.getFileType();
+        if (!name && !size && !date && !type2) return null;
+        return { FileName: name, FileSize: size, FileType: type2, ModDate: date };
+      }
+      /**
+       * Uploads a file by clicking the select-file-button and providing the file path.
+       * @param filePath - Absolute or relative path to the file on disk.
+       */
+      async setValue(filePath) {
+        const root = this.getFullCssSelector();
+        const fileChooserPromise = this.page.waitForEvent("filechooser");
+        await this.page.locator(`${root} ${SELECT_FILE_BUTTON_SELECTOR}`).click();
+        const fileChooser = await fileChooserPromise;
+        await fileChooser.setFiles(filePath);
+      }
+      /**
+       * Downloads the currently uploaded file by clicking the download-file-button.
+       * Returns the suggested file name of the downloaded file.
+       */
+      async download() {
+        const root = this.getFullCssSelector();
+        const buttonLocator = this.page.locator(
+          `${root} ${DOWNLOAD_FILE_BUTTON_SELECTOR}`
+        );
+        if (await buttonLocator.isHidden()) return "";
+        const downloadPromise = this.page.waitForEvent("download");
+        await buttonLocator.click();
+        const download = await downloadPromise;
+        return download.suggestedFilename();
+      }
+      /**
+       * Removes the currently uploaded file by clicking the delete-file-button.
+       * Does nothing if no file is uploaded.
+       */
+      async clear() {
+        if (await this.getValue() === null) return;
+        const root = this.getFullCssSelector();
+        const deleteButton = this.page.locator(`${root} ${CLEAR_BUTTON_SELECTOR}`);
+        if (await deleteButton.isHidden()) return;
+        await deleteButton.click();
+      }
+    };
+  }
+});
+
 // src/pageObjects/elements/Editors/editorFactory.ts
 var editorFactory;
 var init_editorFactory = __esm({
@@ -1286,6 +1411,7 @@ var init_editorFactory = __esm({
     init_ButtonGroup();
     init_DateEditor();
     init_HeaderFilterDictionary();
+    init_FileUploader();
     editorFactory = async (parentCssSelector, elementCssSelector, page) => {
       const elementInstance = new AbstractFormElement(parentCssSelector, elementCssSelector, page);
       const classString = await elementInstance.getClasses();
@@ -1306,6 +1432,8 @@ var init_editorFactory = __esm({
         return new ButtonGroup(parentCssSelector, elementCssSelector, page);
       if (classString.includes("header-filter-dictionary" /* HeaderFilterDictionary */))
         return new HeaderFilterDictionary(parentCssSelector, elementCssSelector, page);
+      if (classString.includes("file-uploader" /* FileUploader */))
+        return new FileUploader(parentCssSelector, elementCssSelector, page);
       throw new Error("Unknown type of editor. Please write ticket to the support");
     };
   }
@@ -1385,6 +1513,15 @@ function createSubSystemTestId(itemName) {
 function createEditorButtonTestId(itemName) {
   return `${"editor-button" /* EDITOR_BUTTON */}-${itemName}`;
 }
+function createLabelFieldTestId(formName, itemName) {
+  return `${"label" /* LABEL */}-${createFieldTestId(formName, itemName)}`;
+}
+function createLabelDocFilterTestId(formName, itemName) {
+  return `${"label" /* LABEL */}-${createDocFilterTestId(formName, itemName)}`;
+}
+function createLabelLayoutFilterTestId(formName, itemName) {
+  return `${"label" /* LABEL */}-${createLayoutFilterTestId(formName, itemName)}`;
+}
 var init_createDataTestId = __esm({
   "src/utils/createDataTestId.ts"() {
     "use strict";
@@ -1863,7 +2000,7 @@ var init_AbstractForm = __esm({
       async exists() {
         try {
           const container = this.page.locator(this.containerCssSelector);
-          await waitElementIsVisible_default({ locator: container });
+          await waitElementIsVisible_default({ locator: container, timeout: 3e3 });
           return true;
         } catch (error) {
           return false;
@@ -1996,14 +2133,14 @@ var init_Cell = __esm({
         }
         return getDate(value);
       }
-      async element() {
+      async getLocator() {
         if (this._index == null) {
           this.index = await this.getCellIndex();
         }
-        return this.getLocator();
+        return this.syncLocator();
       }
       async getValue() {
-        const cellEl = await this.element();
+        const cellEl = await this.getLocator();
         const cellElClass = await cellEl.getAttribute("class") ?? "";
         if (cellElClass.includes("boolean-column" /* Boolean */)) return this.getBooleanValue(cellEl);
         if (cellElClass.includes("tags-column" /* Tags */)) return this.getTagsValue(cellEl);
@@ -2151,9 +2288,9 @@ var init_Column = __esm({
       constructor({ parentCssSelector, headerCssSelector, name, caption, index, page }) {
         super(parentCssSelector, "", page);
         this._name = name;
+        this.headerCssSelector = headerCssSelector;
         this.index = index;
         this._caption = caption;
-        this.headerCssSelector = headerCssSelector;
       }
       set index(index) {
         this._index = index;
@@ -2162,9 +2299,9 @@ var init_Column = __esm({
       get index() {
         return this._index;
       }
-      async element() {
+      async getLocator() {
         await this.getIndex();
-        return this.getLocator();
+        return this.syncLocator();
       }
       async getColumnHeaderIndexBy(cssSelector) {
         const column = this.page.locator(`${this.parentCssSelector} ${this.headerCssSelector} ${cssSelector}`);
@@ -2177,7 +2314,7 @@ var init_Column = __esm({
         return this.getColumnHeaderIndexBy(getColumnByNameCssSelector(this._name));
       }
       async caption() {
-        const el = await this.element();
+        const el = await this.getLocator();
         const text = await el.innerText();
         return text?.trim() ?? null;
       }
@@ -2230,6 +2367,25 @@ var init_EditorButton = __esm({
   }
 });
 
+// src/pageObjects/elements/EditorTitle.ts
+var CAPTION_TEXT_CLASS, EditorTitle;
+var init_EditorTitle = __esm({
+  "src/pageObjects/elements/EditorTitle.ts"() {
+    "use strict";
+    init_AbstractElementWithParent();
+    CAPTION_TEXT_CLASS = " .caption-text";
+    EditorTitle = class extends AbstractElementWithParent {
+      constructor({ parentCssSelector, elementCssSelector, page }) {
+        super(parentCssSelector, elementCssSelector, page);
+      }
+      async getTitle() {
+        const captionElement = this.getLocator().locator(CAPTION_TEXT_CLASS);
+        return captionElement.innerText();
+      }
+    };
+  }
+});
+
 // src/pageObjects/elements/AbstractEditor.ts
 var AbstractEditor;
 var init_AbstractEditor2 = __esm({
@@ -2238,10 +2394,13 @@ var init_AbstractEditor2 = __esm({
     init_AbstractElementWithParent();
     init_Editors();
     init_EditorButton();
+    init_EditorTitle();
     AbstractEditor = class extends AbstractElementWithParent {
       editor;
-      constructor(parentCssSelector, elementCssSelector, page) {
+      _titleCssSelector;
+      constructor({ parentCssSelector, elementCssSelector, titleCssSelector, page }) {
         super(parentCssSelector, elementCssSelector, page);
+        this._titleCssSelector = titleCssSelector;
       }
       async initEditor() {
         if (!this.editor) {
@@ -2337,6 +2496,32 @@ var init_AbstractEditor2 = __esm({
       button(name) {
         return new EditorButton(this.getFullCssSelector(), name, this.page);
       }
+      /**
+       * Повертає загловок едітора
+       * @example
+       * expect(await formEdit.field('NumberFld').title()).toBe('Title1');
+       * expect(await formEdit.field('TextFld').title()).toBe('Title2`);
+       */
+      async title() {
+        return new EditorTitle({
+          elementCssSelector: this._titleCssSelector,
+          parentCssSelector: this.parentCssSelector,
+          page: this.page
+        }).getTitle();
+      }
+      /**
+       * Вивантажує файл і повертає назву файла. Доступний тільки для поля FileUploader.
+       * @example
+       * const fileName = await formEdit.field('FileField').downloadFile();
+       * expect(filename()).toBe('file.pdf');
+       */
+      async download() {
+        await this.initEditor();
+        if (!this.editor.download) {
+          throw new Error("download is only available for the FileUploader field type.");
+        }
+        return this.editor.download();
+      }
     };
   }
 });
@@ -2351,7 +2536,12 @@ var init_FormField = __esm({
     init_AbstractEditor2();
     FormField = class extends AbstractEditor {
       constructor(parentCssSelector, formName, name, page) {
-        super(parentCssSelector, byTestIdCssSelector(createFieldTestId(formName, name)), page);
+        super({
+          parentCssSelector,
+          elementCssSelector: byTestIdCssSelector(createFieldTestId(formName, name)),
+          titleCssSelector: byTestIdCssSelector(createLabelFieldTestId(formName, name)),
+          page
+        });
       }
     };
   }
@@ -2525,6 +2715,7 @@ var init_Table = __esm({
         this.getRowByIndex(index);
         return new Column({
           parentCssSelector: this.getFullCssSelector(),
+          headerCssSelector: this.headerCssSelector,
           page: this.page,
           index
         });
@@ -2637,7 +2828,7 @@ var init_Table = __esm({
             [row] = await this.getSelectedRows();
           }
           if (!row) throw new Error("No row available row for context menu");
-          const cellElement = await row.getCell(fieldName).element();
+          const cellElement = await row.getCell(fieldName).getLocator();
           await cellElement.click({ button: "right" });
         });
       }
@@ -2696,10 +2887,14 @@ var init_Table = __esm({
        * console.log('Таблиця містить 5 рядків');
        */
       async waitRowsCount(count) {
-        await wait(async () => {
-          const rowsCount = await this.getRowElements().count();
-          return rowsCount === count;
-        }, this.page, `Rows count not equal: ${count}`);
+        await wait(
+          async () => {
+            const rowsCount = await this.getRowElements().count();
+            return rowsCount === count;
+          },
+          this.page,
+          `Rows count not equal: ${count}`
+        );
       }
     };
   }
@@ -2951,6 +3146,7 @@ var init_ToolbarItem = __esm({
     init_locators();
     init_ToolbarMenu();
     init_waitElementIsVisible();
+    init_wait();
     GROUP_BUTTON_CLASS = "toolbar-group-button";
     toolbarItemSelector = (form, name) => byTestIdCssSelector(`ftb-${form}-${name}`);
     ToolbarItem = class extends AbstractElementWithParent {
@@ -2974,7 +3170,10 @@ var init_ToolbarItem = __esm({
       async click() {
         try {
           await this.init();
-          await waitElementIsVisible_default({ locator: this._button.getLocator() });
+          await wait(async () => {
+            const element = this._button.getLocator();
+            return await element.isEnabled() && await element.isVisible();
+          }, this.page);
           await this._button.click();
         } catch (error) {
           throw new Error(`Cannot click on toolbar item: ${this._itemName}`);
@@ -3149,7 +3348,12 @@ var init_FormFilterField = __esm({
       formName;
       name;
       constructor(parentCssSelector, formName, name, page) {
-        super(parentCssSelector, byTestIdCssSelector(createLayoutFilterTestId(formName, name)), page);
+        super({
+          parentCssSelector,
+          elementCssSelector: byTestIdCssSelector(createLayoutFilterTestId(formName, name)),
+          titleCssSelector: byTestIdCssSelector(createLabelLayoutFilterTestId(formName, name)),
+          page
+        });
         this.formName = formName;
         this.name = name;
       }
@@ -3263,7 +3467,12 @@ var init_PanelFilterField = __esm({
       formName;
       name;
       constructor(parentCssSelector, formName, name, page) {
-        super(parentCssSelector, byTestIdCssSelector(createDocFilterTestId(formName, name)), page);
+        super({
+          parentCssSelector,
+          elementCssSelector: byTestIdCssSelector(createDocFilterTestId(formName, name)),
+          titleCssSelector: byTestIdCssSelector(createLabelDocFilterTestId(formName, name)),
+          page
+        });
         this.formName = formName;
         this.name = name;
       }
@@ -3431,7 +3640,12 @@ var init_HeaderFilterField = __esm({
     init_AbstractEditor2();
     HeaderFilterField = class extends AbstractEditor {
       constructor(parentCssSelector, formName, name, page) {
-        super(parentCssSelector, byTestIdCssSelector(createHeaderFilterTestId(formName, name)), page);
+        super({
+          parentCssSelector,
+          elementCssSelector: byTestIdCssSelector(createHeaderFilterTestId(formName, name)),
+          titleCssSelector: "",
+          page
+        });
       }
       async getValue() {
         return super.getValue();
@@ -3493,7 +3707,7 @@ var init_ColumnFilter = __esm({
         await this.getCancelButton().click();
       }
       async initFilter() {
-        const columnEl = await this._column.element();
+        const columnEl = await this._column.getLocator();
         await columnEl.hover();
         const headerFilterIcon = columnEl.locator(HEADER_FILTER_ICON);
         await headerFilterIcon.waitFor({ state: "visible" });

package/dist/cjs/d5-testing-library.d.ts

@@ -1,4 +1,4 @@
-import { Page, Locator } from '@playwright/test';
+import { Locator, Page } from '@playwright/test';
 import * as playwright_core from 'playwright-core';
 
 type IConfig = {
@@ -9,13 +9,14 @@ type IConfig = {
 };
 declare function config(cfg?: IConfig): IConfig;
 
-declare abstract class AbstractElement {
+declare abstract class AbstractElement<TLocator extends Locator | Promise<Locator> = Locator> {
     page: Page;
     protected elementCssSelector: string;
     protected constructor(page: Page, elementCssSelector?: string);
     protected getFullCssSelector(): string;
     protected joinRelativeCssSelectors(selectors: string[]): string;
-    getLocator(): Locator;
+    protected syncLocator(): Locator;
+    getLocator(): TLocator;
     getAttribute(attr: string): Promise<string>;
     getClasses(): Promise<string>;
     getDataTestId(): Promise<string>;
@@ -95,6 +96,7 @@ interface Editor {
     clear?(): Promise<void>;
     isReadonly?(): Promise<boolean>;
     isDisabled?(): Promise<boolean>;
+    download?(): Promise<string>;
 }
 declare enum ControlClass {
     Text = "text-control",
@@ -108,14 +110,15 @@ declare enum ControlClass {
     SingleDateRange = "single-date-range-control",
     BooleanSelector = "buttons-group",
     ButtonGroup = "button-group-field",
-    HeaderFilterDictionary = "header-filter-dictionary"
+    HeaderFilterDictionary = "header-filter-dictionary",
+    FileUploader = "file-uploader"
 }
 
 interface ClearStrategy {
     clear(editor: Editor): Promise<void>;
 }
 
-declare abstract class AbstractElementWithParent extends AbstractElement {
+declare abstract class AbstractElementWithParent<TLocator extends Locator | Promise<Locator> = Locator> extends AbstractElement<TLocator> {
     protected parentCssSelector: string;
     constructor(parentCssSelector: string, elementCssSelector: string, page: Page);
     protected getFullCssSelector(): string;
@@ -347,7 +350,13 @@ declare class EditorButton extends AbstractElementWithParent {
 
 declare class AbstractEditor extends AbstractElementWithParent implements Editor {
     protected editor: Editor;
-    constructor(parentCssSelector: string, elementCssSelector: string, page: Page);
+    protected _titleCssSelector: string;
+    constructor({ parentCssSelector, elementCssSelector, titleCssSelector, page }: {
+        parentCssSelector: string;
+        elementCssSelector: string;
+        titleCssSelector: string;
+        page: Page;
+    });
     protected initEditor(): Promise<void>;
     /**
      * Возвращает значение в поле
@@ -404,6 +413,20 @@ declare class AbstractEditor extends AbstractElementWithParent implements Editor
      * await form.field('Name').button('editorButton).click()
      */
     button(name: string): EditorButton;
+    /**
+     * Повертає загловок едітора
+     * @example
+     * expect(await formEdit.field('NumberFld').title()).toBe('Title1');
+     * expect(await formEdit.field('TextFld').title()).toBe('Title2`);
+     */
+    title(): Promise<string>;
+    /**
+     * Вивантажує файл і повертає назву файла. Доступний тільки для поля FileUploader.
+     * @example
+     * const fileName = await formEdit.field('FileField').downloadFile();
+     * expect(filename()).toBe('file.pdf');
+     */
+    download(): Promise<string>;
 }
 
 declare class FormField extends AbstractEditor {
@@ -500,7 +523,7 @@ declare class ToolbarItem extends AbstractElementWithParent implements Button {
     get menu(): ToolbarMenu;
 }
 
-declare class Cell extends AbstractElementWithParent {
+declare class Cell extends AbstractElementWithParent<Promise<Locator>> {
     private _index;
     private readonly getCellIndex;
     constructor(parentCssSelector: string, getCellIndex: () => Promise<number>, page: Page, index?: number);
@@ -509,7 +532,7 @@ declare class Cell extends AbstractElementWithParent {
     private getTagsValue;
     private getNumberValue;
     private getDateValue;
-    element(): Promise<Locator>;
+    getLocator(): Promise<Locator>;
     getValue(): Promise<string | number | 1 | 0 | string[] | Date | Date[] | null>;
     getIndex(): number;
 }
@@ -522,7 +545,7 @@ interface ConstructorParams$1 {
     index?: number;
     page: Page;
 }
-declare class Column extends AbstractElementWithParent {
+declare class Column extends AbstractElementWithParent<Promise<Locator>> {
     private _index;
     private _caption;
     private _name;
@@ -530,7 +553,7 @@ declare class Column extends AbstractElementWithParent {
     constructor({ parentCssSelector, headerCssSelector, name, caption, index, page }: ConstructorParams$1);
     private set index(value);
     private get index();
-    element(): Promise<Locator>;
+    getLocator(): Promise<Locator>;
     private getColumnHeaderIndexBy;
     private getIndexByCaption;
     private getIndexByName;