itemengine-cypress-automation 1.0.197 → 1.0.198

package/cypress/pages/imageHighlightPage.js

@@ -1,5 +1,5 @@
 import utilities from "../support/helpers/utilities";
-import { autoScoredScoringPreviewTab, autoScoredScoringSectionMultiResponseType, autoScoredSpecifyCorrectAnswerSection, autoScoredStudentViewSettings, backgroundImageUploadComponent, commonComponents, createQuestionBasePage, enableOuterBorderComponent, imageCanvasComponent, questionInstructionsComponent, scoringSectionBaseEditTab, singleMultipleSelectionModeComponent } from "./components"
+import { additionalSettingsAccessibilitySectionComponent, additionalSettingsPanel, autoScoredScoringPreviewTab, autoScoredScoringSectionMultiResponseType, autoScoredSpecifyCorrectAnswerSection, autoScoredStudentViewSettings, backgroundImageUploadComponent, commonComponents, createQuestionBasePage, enableOuterBorderComponent, gradingViewEnumerationComponent, imageActionsComponent, imageCanvasComponent, questionInstructionsComponent, scoringSectionBaseEditTab, showAvailableOptionsToStudents, showStudentMaximumNumberOfPossibleSelections, singleMultipleSelectionModeComponent } from "./components"
 const css = Cypress.env('css');
 let imageWidth = 768;
 let imageHeight = 432;
@@ -10,7 +10,13 @@ const selectors = {
     ...autoScoredSpecifyCorrectAnswerSection,
     ...commonComponents,
     ...enableOuterBorderComponent,
+    ...showAvailableOptionsToStudents,
+    ...showStudentMaximumNumberOfPossibleSelections,
     ...autoScoredScoringPreviewTab,
+    ...imageCanvasComponent,
+    ...imageActionsComponent,
+    ...additionalSettingsPanel,
+    ...gradingViewEnumerationComponent,
 
     //Specify possible options
     specifyPossibleOptionsImageWrapper: () => cy.get('.drawing-tool__wrapper .drawing-tool__canvas'),
@@ -22,6 +28,11 @@ const selectors = {
     redoTool: () => cy.get('.drawing-tool__button-redo'),
     clearAllTool: () => cy.get('.drawing-tool__button-clearAll'),
     optionCount: () => cy.get('[class*="HighlightImagestyles__HighlightCountWrapper"]'),
+    specifyPossibleOptionsLabel: () => cy.get('[class*="HighlightImagestyles__HighlightImageLabel"]'),
+    clearAllPopupHeading: () => cy.get('.drawing-tool__delete-popup__heading'),
+    clearAllPopupDescription: () => cy.get('.drawing-tool__delete-popup__body'),
+    cancelButton: () => cy.get('.cancel-button'),
+    clearAllButton: () => cy.get('.clear-button'),
     //Specify correct answer section
     specifyCorrectAnswerSectionImage: () => cy.get('.highlight-svg-responseive image'),
     specifyCorrectAnswerSectionHighlight: () => cy.get('.ngie-accordion [class*="HighlightImageControlstyles__ShapeWrapper"] a'),
@@ -41,7 +52,16 @@ const selectors = {
     correctAnswerNumeration: () => cy.get('[class*="CellIndexWrapper"]'),
     correctIncorrectAnswerTextWrapper: () => cy.get('[class*="_CorrectIncorrectWrapper"]'),
     incorrectIcon: () => cy.get('[data-icon="Incorrect"]'),
-    correctIcon: () => cy.get('[data-icon="CorrectAnswer"]')
+    correctIcon: () => cy.get('[data-icon="CorrectAnswer"]'),
+    //Additional settings
+    descriptorsAccordion: () => cy.get('.descriptor-wrapper .MuiAccordionSummary-root'),
+    descriptorsHeading: () => cy.get('[class*="Descriptorsstyles__AddToolsHeading"]'),
+    descriptorsInfoIcon: () => cy.get('[class*="Descriptorsstyles__InfoIconWrapper"]'),
+    descriptorsInputField: () => cy.get('.option-without-ckeditor input'),
+    descriptorsInputFieldNumeration: () => cy.get('.descriptor-wrapper .MuiInputAdornment-positionStart'),
+    ariaLabelInputField: () => cy.get('input[placeholder*="Enter ARIA label"]'),
+    inputFieldNumeration: () => cy.get('.MuiInputAdornment-root'),
+    ariaLabelSectionLabel: () => cy.get('[class*="styles__LabelWrapper"]').contains('ARIA'),
 }
 
 const steps = {
@@ -56,6 +76,10 @@ const steps = {
     ...autoScoredSpecifyCorrectAnswerSection.steps,
     ...autoScoredScoringSectionMultiResponseType.steps,
     ...enableOuterBorderComponent.steps,
+    ...showAvailableOptionsToStudents.steps,
+    ...showStudentMaximumNumberOfPossibleSelections.steps,
+    ...additionalSettingsPanel.steps,
+    ...gradingViewEnumerationComponent.steps,
 
     //Specify possible options
     clickOnFreeformTool: () => {
@@ -79,7 +103,16 @@ const steps = {
     clickOnClearAllTool: () => {
         imageHighlightPage.clearAllTool()
             .click()
-            .blur();
+    },
+
+    clickOnClearAllButton: () => {
+        imageHighlightPage.clearAllButton()
+            .click();
+    },
+
+    clickOnCancelAllButton: () => {
+        imageHighlightPage.cancelButton()
+            .click();
     },
 
     verifyImageUploadedInSpecifyPossibleOptionsSection: () => {
@@ -157,7 +190,233 @@ const steps = {
             .should('not.have.class', 'drawing-tool__button--active');
     },
 
+    verifyCanvasImageTopLeftAligned: () => {
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .should('have.css', 'top', '0px')
+            .and('have.css', 'left', '0px');
+    },
+
+    verifyCanvasImageCenterAligned: () => {
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .should('not.have.css', 'top', '0px')
+            .and('not.have.css', 'left', '0px');
+    },
+
+    verifyCanvasImageTopRightAligned: () => {
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .should('have.css', 'top', '0px')
+            .and('not.have.css', 'left', '0px');
+    },
+
+    /**
+   * @param {number} value holds opacity value for image
+   * @description function verifies opacity value for image
+   */
+    verifyOpacityValueForCanvasImage: (value) => {
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .should('have.attr', 'opacity', value / 100);
+    },
+
+    verifyImageFitsToCanvas: () => {
+        imageHighlightPage.canvasWidthInputField()
+            .invoke('attr', 'value')
+            .then((value) => {
+                imageHighlightPage.specifyPossibleOptionsImageCanvas()
+                    .should('have.css', 'width', `${value}px`);
+            });
+    },
+
+    verifyImageDoesNotFitToCanvas: () => {
+        imageHighlightPage.canvasWidthInputField()
+            .invoke('attr', 'value')
+            .then(($element) => {
+                imageHighlightPage.specifyPossibleOptionsImageCanvas()
+                    .should('not.have.css', 'width', `${$element}px`);
+            });
+    },
+
+    /**
+     * @param {*} width width of canvas
+     * @description this function verifies width of canvas
+     */
+    verifyCanvasWidth: (width) => {
+        const tolerance = 2
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .should('have.attr', 'width', width - tolerance);
+    },
+
+    /**
+     * @param {*} height height of canvas
+     * @description this function verifies height of canvas
+     */
+    verifyCanvasHeight: (height) => {
+        const tolerance = 2
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .should('have.css', 'height')
+            .then(($cssHeight) => {
+                const actualHeight = parseFloat($cssHeight);
+                expect(actualHeight).to.be.closeTo(height, tolerance);
+            });
+    },
+
+    /**
+    * @param {string} text alternative text for canvas image
+    * @description this function verifies text for canvas image
+    */
+    verifyImageAltTextSpecifyPossibleOptionsImageCanvas: (text) => {
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .parents('.drawing-tool__wrapper')
+            .find('.lower-canvas')
+            .should('have.attr', 'aria-label', text);
+    },
+
+    verifyNoImageAltTextSpecifyPossibleOptionsImageCanvas: () => {
+        imageHighlightPage.specifyPossibleOptionsImageCanvas()
+            .parents('.drawing-tool__wrapper')
+            .find('.lower-canvas')
+            .should('have.attr', 'aria-label', 'Image');
+    },
+
     //Specify correct answer section
+    /**
+    * @param {string} text alternative text for canvas image
+    * @description this function verifies text for canvas image
+    */
+    verifyImageAltTextSpecifyCorrectAnswerImageCanvas: (text) => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.attr', 'alt', text);
+    },
+
+    verifyNoImageAltTextSpecifyCorrectAnswerImageCanvas: () => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.attr', 'alt', '');
+    },
+
+    verifyCanvasImageTopLeftAlignedSpecifyCorrectAnswer: () => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.css', 'top', '0px')
+            .and('have.css', 'left', '0px');
+    },
+
+    verifyCanvasImageCenterAlignedSpecifyCorrectAnswer: () => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('not.have.css', 'top', '0px')
+            .and('not.have.css', 'left', '0px');
+    },
+
+    verifyCanvasImageTopRightAlignedSpecifyCorrectAnswer: () => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.css', 'top', '0px')
+            .and('not.have.css', 'left', '0px');
+    },
+
+    /**
+   * @param {number} value holds opacity value for image
+   * @description function verifies opacity value for image
+   */
+    verifyOpacityValueForCanvasImageSpecifyCorrectAnswer: (value) => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.attr', 'opacity', value / 100);
+    },
+
+    verifyImageFitsToCanvasSpecifyCorrectAnswer: () => {
+        imageHighlightPage.canvasWidthInputField()
+            .invoke('attr', 'value')
+            .then((value) => {
+                imageHighlightPage.specifyCorrectAnswerSectionImage()
+                    .should('have.css', 'width', `${value}px`);
+            });
+    },
+
+    verifyImageDoesNotFitToCanvasSpecifyCorrectAnswer: () => {
+        imageHighlightPage.canvasWidthInputField()
+            .invoke('attr', 'value')
+            .then(($element) => {
+                imageHighlightPage.specifyCorrectAnswerSectionImage()
+                    .should('not.have.css', 'width', `${$element}px`);
+            });
+    },
+
+    /**
+     * @param {*} width width of canvas
+     * @description this function verifies width of canvas
+     */
+    verifyCanvasWidthSpecifyCorrectAnswer: (width) => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.attr', 'width', width);
+    },
+
+    /**
+     * @param {*} height height of canvas
+     * @description this function verifies height of canvas
+     */
+    verifyCanvasHeightSpecifyCorrectAnswer: (height) => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.css', 'height', `${height}px`);
+    },
+
+    /**
+    * @param {string} text alternative text for canvas image
+    * @description this function verifies text for canvas image
+    */
+    verifyImageAlternativeTextPresentInSpecifyCorrectAnswer: (text) => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('have.attr', 'alt', text);
+    },
+
+    verifyNoImageAlternativeTextPresentInSpecifyCorrectAnswer: () => {
+        imageHighlightPage.specifyCorrectAnswerSectionImage()
+            .should('not.have.attr', 'alt');
+    },
+
+    /**
+     * This function verifies highlight region aria label
+     * @param {number} index for the highlight region
+     * @param {string} ariaLabel for the highlight region
+     */
+    verifyHighlightRegionAriaLabelSpecifyCorrectAnswer: (index, ariaLabel) => {
+        imageHighlightPage.specifyCorrectAnswerSectionHighlight()
+            .eq(index)
+            .should('have.attr', 'aria-label', ariaLabel);
+    },
+
+    /**
+     * Verifies the ARIA label text input fields.
+     * @param {number} inputFieldIndex - The index of the input field to verify.
+     */
+    verifyAriaLabelTextInputFields: (inputFieldIndex) => {
+        imageHighlightPage.ariaLabelInputField()
+            .eq(inputFieldIndex)
+            .parents('.input-editable')
+            .within(() => {
+                utilities.verifyInnerText(imageHighlightPage.inputFieldNumeration(), `${inputFieldIndex + 1}`)
+                utilities.verifyInputFieldValue(imageHighlightPage.ariaLabelInputField(), '');
+            });
+    },
+
+    /**
+     * Enters text in the ARIA label input field.
+     * @param {number} inputFieldIndex - The index of the input field to enter text into.
+     * @param {string} text - The text to enter into the input field.
+     */
+    enterTextInAriaLabelInputField: (inputFieldIndex, text) => {
+        imageHighlightPage.ariaLabelInputField()
+            .eq(inputFieldIndex)
+            .type(text)
+            .should('have.value', text)
+            .blur();
+    },
+
+    /**
+     * Clears text in the ARIA label input field.
+     * @param {number} inputFieldIndex - The index of the input field to clear.
+     */
+    clearTextInAriaLabelInputField: (inputFieldIndex) => {
+        imageHighlightPage.ariaLabelInputField()
+            .eq(inputFieldIndex)
+            .clear();
+    },
+
     verifyImageUploadedSpecifyCorrectAnswer: () => {
         utilities.verifyElementVisibilityState(imageHighlightPage.specifyCorrectAnswerSectionImage(), 'visible')
     },
@@ -331,6 +590,103 @@ const steps = {
         utilities.verifyElementVisibilityState(imageHighlightPage.imagePreviewTab(), 'visible')
     },
 
+    verifyImageNotUploadedPreviewTab: () => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.attr', 'href', '');
+    },
+
+    verifyCanvasImageTopLeftAlignedInPreviewTab: () => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.css', 'top', '0px')
+            .and('have.css', 'left', '0px');
+    },
+
+    verifyCanvasImageCenterAlignedInPreviewTab: () => {
+        imageHighlightPage.imagePreviewTab()
+            .should('not.have.css', 'top', '0px')
+            .and('not.have.css', 'left', '0px');
+    },
+
+    verifyCanvasImageTopRightAlignedInPreviewTab: () => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.css', 'top', '0px')
+            .and('not.have.css', 'left', '0px');
+    },
+
+    /**
+    * @param {number} value holds opacity value for image
+    * @description function verifies opacity value for image
+    */
+    verifyOpacityValueForCanvasImageInPreviewTab: (value) => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.attr', 'opacity', value / 100);
+    },
+
+    /**
+    * @param {*} width width of canvas
+    * @description this function verifies width of canvas
+    */
+    verifyCanvasWidthInPreviewTab: (width) => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.attr', 'width', width);
+    },
+
+    /**
+     * @param {*} height height of canvas
+     * @description this function verifies height of canvas
+     */
+    verifyCanvasHeightInPreviewTab: (height) => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.css', 'height', `${height}px`);
+    },
+
+    /**
+     * @param {string} text alternative text for canvas image
+     * @description this function verifies text for canvas image
+     */
+    verifyImageAlternativeTextInPreviewTab: (text) => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.attr', 'alt', text);
+    },
+
+    verifyNoImageAlternativeTextPresentInPreviewTab: () => {
+        imageHighlightPage.imagePreviewTab()
+            .should('have.attr', 'alt', '');
+    },
+
+    verifyImageFitsToCanvasInPreviewTab: () => {
+        createQuestionBasePage.steps.switchToEditTab();
+        imageCanvasComponent.canvasWidthInputField()
+            .invoke('attr', 'value')
+            .then((value) => {
+                createQuestionBasePage.steps.switchToPreviewTab();
+                imageHighlightPage.imagePreviewTab()
+                    .should('have.css', 'width', `${value}px`);
+            });
+    },
+
+    verifyImageDoesNotFitToCanvasInPreviewTab: () => {
+        createQuestionBasePage.steps.switchToEditTab();
+        imageHighlightPage.canvasWidthInputField()
+            .invoke('attr', 'value')
+            .then(($element) => {
+                createQuestionBasePage.steps.switchToPreviewTab();
+                imageHighlightPage.imagePreviewTab()
+                    .should('not.have.css', 'width', `${$element}px`);
+            });
+    },
+
+    /**
+     * This function verifies highlight region aria label
+     * @param {number} index for the highlight region
+     * @param {string} ariaLabel for the highlight region
+     */
+    verifyHighlightRegionAriaLabelPreviewTab: (index, ariaLabel) => {
+        imageHighlightPage.highlightPreviewTab()
+            .eq(index)
+            .should('have.attr', 'aria-label', ariaLabel);
+    },
+
     /**
     * This function verifies the alt text of the image
     * @param {string} altText for the image in preview tab
@@ -474,7 +830,7 @@ const steps = {
     },
 
     /**
-    * @param {*} index of highlight region
+    * @param {number} index of highlight region
     * @description this function verifies the highlight region is correct
     */
     verifyCorrectHighlightRegion: (index) => {
@@ -517,6 +873,23 @@ const steps = {
             });
     },
 
+    verifyHighlightNumerationNotExist: () => {
+        imageHighlightPage.highlightNumerationPreviewTab()
+            .should('not.exist');
+    },
+
+    /**
+     * This function checks numeration array for highlights
+     * @param {string[]} numerationArray array of numeration to be checked for highlight options
+     */
+    verifyHighlightEnumeration: (numerationArray) => {
+        numerationArray.forEach((numeration, index) => {
+            imageHighlightPage.highlightNumerationPreviewTab()
+                .eq(index)
+                .should('have.text', numeration);
+        });
+    },
+
     /**
    * @param {string[]} numerationArray array of numeration numbers, lowercase, uppercase
    * @description this function verifies the numeration of Correct Answer Container
@@ -575,6 +948,56 @@ const steps = {
             .should('have.css', 'border')
             .and('match', /0px none/);
     },
+
+    verifyDescriptorsAccordionIsCollapsed: () => {
+        imageHighlightPage.descriptorsAccordion()
+            .should('have.attr', 'aria-expanded', 'false');
+    },
+
+    expandDescriptorsAccordion: () => {
+        imageHighlightPage.descriptorsAccordion()
+            .click()
+            .should('have.attr', 'aria-expanded', 'true');
+    },
+
+    /**
+    * Verifies that the descriptors input fields are visible and correctly numbered.
+    * @param {number} countOfDescriptors - The total number of descriptor input fields to verify.
+    */
+    verifyDescriptorsInputFieldContents: (countOfDescriptors) => {
+        for (let i = 0; i < countOfDescriptors; i++) {
+            imageHighlightPage.descriptorsInputField()
+                .eq(i)
+                .should('be.visible')
+            imageHighlightPage.descriptorsInputFieldNumeration()
+                .eq(i)
+                .should('have.text', `${i + 1}`);
+        }
+    },
+
+    /**
+     * Verifies that a specific descriptor input field contains the expected text.
+     * @param {number} index - The index of the descriptor input field to verify.
+     * @param {string} inputText - The expected text to be found in the input field.
+     */
+    verifyDescriptorsInputField: (index, inputText) => {
+        imageHighlightPage.descriptorsInputField()
+            .eq(index)
+            .should('have.value', inputText)
+    },
+
+    /**
+    * Enters text into a specific descriptor input field and verifies the input.
+    * @param {number} index - The index of the descriptor input field where the text will be entered.
+    * @param {string} inputText - The text to enter into the input field.
+    */
+    enterTextInDescriptorsInputField: (index, inputText) => {
+        imageHighlightPage.descriptorsInputField()
+            .eq(index)
+            .type(inputText)
+            .blur();
+        steps.verifyDescriptorsInputField(index, inputText);
+    }
 }
 
 const tests = {
@@ -586,6 +1009,13 @@ const tests = {
     ...commonComponents.tests,
     ...enableOuterBorderComponent.tests,
     ...autoScoredStudentViewSettings.tests,
+    ...showAvailableOptionsToStudents.tests,
+    ...questionInstructionsComponent.tests,
+    ...backgroundImageUploadComponent.tests,
+    ...imageCanvasComponent.tests,
+    ...additionalSettingsPanel.tests,
+    ...gradingViewEnumerationComponent.tests,
+    ...additionalSettingsAccessibilitySectionComponent.tests,
 
     /**
      * @param {string} scoringType scoring type 'All or nothing| Partial equal weights| Partial different weights'