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

package/README.md

@@ -1 +1 @@
-//
+//.

package/dist/{FormEdit-I63LWQEH.mjs → FormEdit-XTRS74QI.mjs}

@@ -1,6 +1,6 @@
 import {
   FormEdit
-} from "./chunk-75NROWLM.mjs";
+} from "./chunk-I5BQCTAW.mjs";
 export {
   FormEdit as default
 };

package/dist/{ListForm-NEBCZD4X.mjs → ListForm-DSQ4LR7B.mjs}

@@ -1,6 +1,6 @@
 import {
   ListForm
-} from "./chunk-75NROWLM.mjs";
+} from "./chunk-I5BQCTAW.mjs";
 export {
   ListForm as default
 };

package/dist/{TreeView-T3PIDSZQ.mjs → TreeView-HFUTD2JY.mjs}

@@ -1,6 +1,6 @@
 import {
   TreeView
-} from "./chunk-75NROWLM.mjs";
+} from "./chunk-I5BQCTAW.mjs";
 export {
   TreeView as default
 };

package/dist/{chunk-75NROWLM.mjs → chunk-I5BQCTAW.mjs}

@@ -2859,11 +2859,14 @@ var AbstractElement = class {
   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);
     }
@@ -2941,6 +2944,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)}`;
+}
 
 // src/pageObjects/AbstractElementWithParent.ts
 var AbstractElementWithParent = class extends AbstractElement {
@@ -3263,7 +3275,7 @@ var AbstractForm = class extends AbstractPage {
   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;
@@ -3308,15 +3320,15 @@ async function classDependencyInjector(formType) {
   let SubFormFactoryClass;
   switch (formType) {
     case "1" /* LIST */:
-      SubFormFactoryClass = (await import("./ListForm-NEBCZD4X.mjs")).default;
+      SubFormFactoryClass = (await import("./ListForm-DSQ4LR7B.mjs")).default;
       break;
     case "3" /* TREE */:
-      SubFormFactoryClass = (await import("./TreeView-T3PIDSZQ.mjs")).default;
+      SubFormFactoryClass = (await import("./TreeView-HFUTD2JY.mjs")).default;
       break;
     case "2" /* EDIT */:
     case "99" /* FREE_FORM */:
     case "4" /* REPORT */:
-      SubFormFactoryClass = (await import("./FormEdit-I63LWQEH.mjs")).default;
+      SubFormFactoryClass = (await import("./FormEdit-XTRS74QI.mjs")).default;
       break;
     default:
       throw new Error(`Unsupported form type ${formType}`);
@@ -3478,14 +3490,14 @@ var Cell = class extends AbstractElementWithParent {
     }
     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);
@@ -3632,9 +3644,9 @@ var Column = class extends AbstractElementWithParent {
   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;
@@ -3643,9 +3655,9 @@ var Column = class extends AbstractElementWithParent {
   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}`);
@@ -3658,7 +3670,7 @@ var Column = class extends AbstractElementWithParent {
     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;
   }
@@ -3723,7 +3735,7 @@ var AbstractDXEditorWithInput = class extends AbstractElementWithParent {
   async setInputValue(value) {
     const input = this.getInputLocator();
     await input.click();
-    await input.fill(value + "");
+    await input.pressSequentially(value + "");
     await input.press("Enter");
   }
   async clear() {
@@ -3775,6 +3787,7 @@ var ControlClass = /* @__PURE__ */ ((ControlClass2) => {
   ControlClass2["BooleanSelector"] = "buttons-group";
   ControlClass2["ButtonGroup"] = "button-group-field";
   ControlClass2["HeaderFilterDictionary"] = "header-filter-dictionary";
+  ControlClass2["FileUploader"] = "file-uploader";
   return ControlClass2;
 })(ControlClass || {});
 
@@ -3798,7 +3811,7 @@ var CheckBox = class extends AbstractElementWithParent {
 // src/utils/xpathHelper.ts
 var XPathHelper = class {
   static getClassAndValueXpath(cssClass, value) {
-    return `div[contains(@class, '${cssClass}') and contains(.,'${value}')]`;
+    return `div[contains(@class, '${cssClass}') and .='${value}']`;
   }
 };
 
@@ -4157,7 +4170,12 @@ var FormFilterField = class extends AbstractEditor {
   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;
   }
@@ -4261,7 +4279,12 @@ var PanelFilterField = class extends AbstractEditor {
   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;
   }
@@ -4510,6 +4533,9 @@ var isDefined = function(value) {
 var isString = function(object) {
   return typeof object === "string";
 };
+var isNumeric = function(object) {
+  return typeof object === "number" && isFinite(object) || !isNaN(object - parseFloat(object));
+};
 var isDate = function(object) {
   return type(object) === "date";
 };
@@ -4548,7 +4574,7 @@ var SelectBoxEditor = class extends AbstractDXEditorWithInput {
     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 {
@@ -4632,12 +4658,12 @@ var TagBox = class extends AbstractDXEditorWithInput {
     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() {
@@ -5001,11 +5027,7 @@ var SingleDateEditor = class extends BaseDateEditor {
   }
   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`);
     }
@@ -5085,12 +5107,11 @@ var DX_TEXTEDITOR_EMPTY3 = "dx-texteditor-empty";
 var CUSTOM_OPTION_LIST_SELECTOR = "custom-list";
 var SELECT_BOX_OPTION_TEXT_CONTAINER_CLASS2 = "d5-multi-select-item";
 var TAG_BOX_LIST_ITEM_SELECTOR = '.dx-overlay-wrapper .dx-list-item[aria-selected="true"]';
-var combinedOptionHeaderFilterDictValueXpath = (value) => `//div[contains(@class, '${SELECT_BOX_OPTION_TEXT_CONTAINER_CLASS2}') and contains(text(), '${value}')]`;
 var 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();
@@ -5114,28 +5135,28 @@ var HeaderFilterDictionary = class extends AbstractDXEditorWithInput {
       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++) {
@@ -5159,6 +5180,122 @@ var HeaderFilterDictionary = class extends AbstractDXEditorWithInput {
   }
 };
 
+// src/pageObjects/elements/Editors/FileUploader.ts
+var FILE_NAME_SELECTOR = ".file-text";
+var FILE_SIZE_ATTRIBUTE = "data-filesize";
+var FILE_DATE_ATTRIBUTE = "data-moddate";
+var FILE_TYPE_ATTRIBUTE = "data-filetype";
+var SELECT_FILE_BUTTON_SELECTOR = ".select-file-button";
+var DOWNLOAD_FILE_BUTTON_SELECTOR = ".download-file-button";
+var METADATA_SELECTOR = ".file-text-file-info-wrapper";
+var CLEAR_BUTTON_SELECTOR = ".clear-button";
+var 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 = async (parentCssSelector, elementCssSelector, page) => {
   const elementInstance = new AbstractFormElement(parentCssSelector, elementCssSelector, page);
@@ -5180,6 +5317,8 @@ var editorFactory = async (parentCssSelector, elementCssSelector, page) => {
     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");
 };
 
@@ -5207,11 +5346,25 @@ var EditorButton = class extends AbstractElementWithParent {
   }
 };
 
+// src/pageObjects/elements/EditorTitle.ts
+var CAPTION_TEXT_CLASS = " .caption-text";
+var 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 = 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) {
@@ -5307,12 +5460,43 @@ var AbstractEditor = class extends AbstractElementWithParent {
   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();
+  }
 };
 
 // src/pageObjects/elements/FormField.ts
 var 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
+    });
   }
 };
 
@@ -5449,6 +5633,7 @@ var Table = class extends AbstractElementWithParent {
     this.getRowByIndex(index);
     return new Column({
       parentCssSelector: this.getFullCssSelector(),
+      headerCssSelector: this.headerCssSelector,
       page: this.page,
       index
     });
@@ -5561,7 +5746,7 @@ var Table = class extends AbstractElementWithParent {
         [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" });
     });
   }
@@ -5620,10 +5805,14 @@ var Table = class extends AbstractElementWithParent {
    * 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}`
+    );
   }
 };
 
@@ -5845,7 +6034,10 @@ var ToolbarItem = class extends AbstractElementWithParent {
   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}`);
@@ -5905,7 +6097,12 @@ var FormToolbar = class extends AbstractElementWithParent {
 // src/pageObjects/elements/Filters/HeaderFilterField.ts
 var 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();
@@ -5957,7 +6154,7 @@ var ColumnFilter = class {
     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" });