MQE-2953 | Get Cookie Expiry in mftf

Author: Mohit.k.Sharma

dev/.credentials

@@ -0,0 +1 @@
+magento/MAGENTO_ADMIN_PASSWORD=Admin@123456

docs/test/actions.md

@@ -144,6 +144,7 @@ The following test actions return a variable:
 
 *  [grabAttributeFrom](#grabattributefrom)
 *  [grabCookie](#grabcookie)
+*  [grabCookieAttributes](#grabCookieAttributes)
 *  [grabFromCurrentUrl](#grabfromcurrenturl)
 *  [grabMultiple](#grabmultiple)
 *  [grabPageSource](#grabpagesource)
@@ -1158,6 +1159,34 @@ To access this value, use `{$grabCookieExampleDomain}` in later actions. -->
 <grabCookie userInput="cookie1" parameterArray="['domainName' => '.example.com']" stepKey="grabCookieExampleDomain"/>
 ```
 
+### grabCookieAttributes
+
+See [grabCookieAttributes docs on codeception.com](http://codeception.com/docs/modules/WebDriver#grabCookieAttributes).
+
+Attribute|Type|Use|Description
+---|---|---|---
+`userInput`|string|optional| Name of the cookie to grab.
+`parameterArray`|string|optional| Array of cookie parameters to grab.
+`stepKey`|string|required| A unique identifier of the action.
+`before`|string|optional| `stepKey` of action that must be executed next.
+`after`|string|optional| `stepKey` of preceding action.
+
+#### Examples
+
+```xml
+<!-- Grab the cookie attributes with the given name `cookie1`.
+To access these values, use `{$grabCookie1}` in later actions. -->
+<grabCookieAttributes userInput="cookie1" stepKey="grabCookie1"/>
+```
+
+```xml
+<!-- Grab the cookie attributes with the given name `cookie1` from the domain `www.example.com`.
+To access these values, use `{$grabCookieExampleDomain}` in later actions.
+To access expiry date, use  `{$grabCookieExampleDomain.expiry}` in later actions.
+-->
+<grabCookieAttributes userInput="cookie1" parameterArray="['domainName' => '.example.com']" stepKey="grabCookieExampleDomain"/>
+```
+
 ### grabFromCurrentUrl
 
 See [grabFromCurrentUrl docs on codeception.com](http://codeception.com/docs/modules/WebDriver#grabFromCurrentUrl)..

etc/di.xml

@@ -8,7 +8,7 @@
 
 <!-- Entity value gets replaced in Dom.php before reading $xml -->
 <!DOCTYPE config [
-        <!ENTITY commonTestActions "acceptPopup|actionGroup|amOnPage|amOnUrl|amOnSubdomain|appendField|assertArrayIsSortasserted|assertElementContainsAttribute|attachFile|cancelPopup|checkOption|clearField|click|clickWithLeftButton|clickWithRightButton|closeAdminNotification|closeTab|comment|conditionalClick|createData|deleteData|updateData|getData|dontSee|dontSeeJsError|dontSeeCheckboxIsChecked|dontSeeCookie|dontSeeCurrentUrlEquals|dontSeeCurrentUrlMatches|dontSeeElement|dontSeeElementInDOM|dontSeeInCurrentUrl|dontSeeInField|dontSeeInFormFields|dontSeeInPageSource|dontSeeInSource|dontSeeInTitle|dontSeeLink|dontSeeOptionIsSelected|doubleClick|dragAndDrop|entity|executeJS|fillField|formatCurrency|generateDate|getOTP|grabAttributeFrom|grabCookie|grabFromCurrentUrl|grabMultiple|grabPageSource|grabTextFrom|grabValueFrom|return|loadSessionSnapshot|loginAsAdmin|magentoCLI|magentoCron|makeScreenshot|maximizeWindow|moveBack|moveForward|moveMouseOver|mSetLocale|mResetLocale|openNewTab|pause|parseFloat|pressKey|reloadPage|resetCookie|submitForm|resizeWindow|saveSessionSnapshot|scrollTo|scrollToTopOfPage|searchAndMultiSelectOption|see|seeCheckboxIsChecked|seeCookie|seeCurrentUrlEquals|seeCurrentUrlMatches|seeElement|seeElementInDOM|seeInCurrentUrl|seeInField|seeInFormFields|seeInPageSource|seeInPopup|seeInSource|seeInTitle|seeLink|seeNumberOfElements|seeOptionIsSelected|selectOption|setCookie|submitForm|switchToIFrame|switchToNextTab|switchToPreviousTab|switchToWindow|typeInPopup|uncheckOption|unselectOption|wait|waitForAjaxLoad|waitForElement|waitForElementChange|waitForElementNotVisible|waitForElementVisible|waitForPwaElementNotVisible|waitForPwaElementVisible|waitForJS|waitForLoadingMaskToDisappear|waitForPageLoad|waitForText|assertArrayHasKey|assertArrayNotHasKey|assertContains|assertStringContainsString|assertStringContainsStringIgnoringCase|assertCount|assertEmpty|assertEquals|assertFalse|assertFileExists|assertFileNotExists|assertGreaterOrEquals|assertGreaterThan|assertGreaterThanOrEqual|assertInstanceOf|assertIsEmpty|assertLessOrEquals|assertLessThan|assertLessThanOrEqual|assertNotContains|assertStringNotContainsString|assertStringNotContainsStringIgnoringCase|assertNotEmpty|assertNotEquals|assertNotInstanceOf|assertNotNull|assertNotRegExp|assertNotSame|assertNull|assertRegExp|assertSame|assertStringStartsNotWith|assertStringStartsWith|assertTrue|expectException|fail|dontSeeFullUrlEquals|dontSee|dontSeeFullUrlMatches|dontSeeInFullUrl|seeFullUrlEquals|seeFullUrlMatches|seeInFullUrl|grabFromFullUrl|helper|assertEqualsWithDelta|assertEqualsCanonicalizing|assertEqualsIgnoringCase|assertNotEqualsWithDelta|assertNotEqualsCanonicalizing|assertNotEqualsIgnoringCase">
+        <!ENTITY commonTestActions "acceptPopup|actionGroup|amOnPage|amOnUrl|amOnSubdomain|appendField|assertArrayIsSortasserted|assertElementContainsAttribute|attachFile|cancelPopup|checkOption|clearField|click|clickWithLeftButton|clickWithRightButton|closeAdminNotification|closeTab|comment|conditionalClick|createData|deleteData|updateData|getData|dontSee|dontSeeJsError|dontSeeCheckboxIsChecked|dontSeeCookie|dontSeeCurrentUrlEquals|dontSeeCurrentUrlMatches|dontSeeElement|dontSeeElementInDOM|dontSeeInCurrentUrl|dontSeeInField|dontSeeInFormFields|dontSeeInPageSource|dontSeeInSource|dontSeeInTitle|dontSeeLink|dontSeeOptionIsSelected|doubleClick|dragAndDrop|entity|executeJS|fillField|formatCurrency|generateDate|getOTP|grabAttributeFrom|grabCookie|grabCookieAttributes|grabFromCurrentUrl|grabMultiple|grabPageSource|grabTextFrom|grabValueFrom|return|loadSessionSnapshot|loginAsAdmin|magentoCLI|magentoCron|makeScreenshot|maximizeWindow|moveBack|moveForward|moveMouseOver|mSetLocale|mResetLocale|openNewTab|pause|parseFloat|pressKey|reloadPage|resetCookie|submitForm|resizeWindow|saveSessionSnapshot|scrollTo|scrollToTopOfPage|searchAndMultiSelectOption|see|seeCheckboxIsChecked|seeCookie|seeCurrentUrlEquals|seeCurrentUrlMatches|seeElement|seeElementInDOM|seeInCurrentUrl|seeInField|seeInFormFields|seeInPageSource|seeInPopup|seeInSource|seeInTitle|seeLink|seeNumberOfElements|seeOptionIsSelected|selectOption|setCookie|submitForm|switchToIFrame|switchToNextTab|switchToPreviousTab|switchToWindow|typeInPopup|uncheckOption|unselectOption|wait|waitForAjaxLoad|waitForElement|waitForElementChange|waitForElementNotVisible|waitForElementVisible|waitForPwaElementNotVisible|waitForPwaElementVisible|waitForJS|waitForLoadingMaskToDisappear|waitForPageLoad|waitForText|assertArrayHasKey|assertArrayNotHasKey|assertContains|assertStringContainsString|assertStringContainsStringIgnoringCase|assertCount|assertEmpty|assertEquals|assertFalse|assertFileExists|assertFileNotExists|assertGreaterOrEquals|assertGreaterThan|assertGreaterThanOrEqual|assertInstanceOf|assertIsEmpty|assertLessOrEquals|assertLessThan|assertLessThanOrEqual|assertNotContains|assertStringNotContainsString|assertStringNotContainsStringIgnoringCase|assertNotEmpty|assertNotEquals|assertNotInstanceOf|assertNotNull|assertNotRegExp|assertNotSame|assertNull|assertRegExp|assertSame|assertStringStartsNotWith|assertStringStartsWith|assertTrue|expectException|fail|dontSeeFullUrlEquals|dontSee|dontSeeFullUrlMatches|dontSeeInFullUrl|seeFullUrlEquals|seeFullUrlMatches|seeInFullUrl|grabFromFullUrl|helper|assertEqualsWithDelta|assertEqualsCanonicalizing|assertEqualsIgnoringCase|assertNotEqualsWithDelta|assertNotEqualsCanonicalizing|assertNotEqualsIgnoringCase">
 ]>
 
 <config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../src/Magento/FunctionalTestingFramework/ObjectManager/etc/config.xsd">

src/Magento/FunctionalTestingFramework/Module/MagentoWebDriver.php

@@ -808,6 +808,39 @@ public function rapidClick($selector, $count)
         }
     }
 
+  /**
+   * Grabs a cookie attributes value.
+   * You can set additional cookie params like `domain`, `path` in array passed as last argument.
+   * If the cookie is set by an ajax request (XMLHttpRequest),
+   * there might be some delay caused by the browser, so try `$I->wait(0.1)`.
+   * @param  string $cookie
+   * @param array  $params
+   * @return mixed
+   */
+    public function grabCookieAttributes(string $cookie, array $params = []): array
+    {
+        $params['name'] = $cookie;
+        $cookieArrays = $this->filterCookies($this->webDriver->manage()->getCookies(), $params);
+        if (is_array($cookieArrays)) { // Microsoft Edge returns null if there are no cookies...
+            $cookieAttributes = [];
+            foreach ($cookieArrays as $cookieArray) {
+                if ($cookieArray->getName() === $cookie) {
+                    $cookieAttributes['name'] = $cookieArray->getValue();
+                    $cookieAttributes['path'] = $cookieArray->getPath();
+                    $cookieAttributes['domain'] = $cookieArray->getDomain();
+                    $cookieAttributes['secure'] = $cookieArray->isSecure();
+                    $cookieAttributes['httpOnly'] = $cookieArray->isHttpOnly();
+                    $cookieAttributes['sameSite'] = $cookieArray->getSameSite();
+                    $cookieAttributes['expiry']  = date('d/m/Y', $cookieArray->getExpiry());
+
+                    return $cookieAttributes;
+                }
+            }
+        }
+
+        return [];
+    }
+
     /**
      * Function used to fill sensitive credentials with user data, data is decrypted immediately prior to fill to avoid
      * exposure in console or log.

src/Magento/FunctionalTestingFramework/Test/Objects/ActionGroupObject.php

@@ -31,6 +31,7 @@ class ActionGroupObject
         "createData",
         "grabAttributeFrom",
         "grabCookie",
+        "grabCookieAttributes",
         "grabFromCurrentUrl",
         "grabMultiple",
         "grabPageSource",

src/Magento/FunctionalTestingFramework/Test/etc/Actions/grabActions.xsd

@@ -13,6 +13,7 @@
         <xs:choice>
             <xs:element type="grabAttributeFromType" name="grabAttributeFrom" minOccurs="0" maxOccurs="unbounded"/>
             <xs:element type="grabCookieType" name="grabCookie" minOccurs="0" maxOccurs="unbounded"/>
+            <xs:element type="grabCookieAttributesType" name="grabCookieAttributes" minOccurs="0" maxOccurs="unbounded"/>
             <xs:element type="grabFromCurrentUrlType" name="grabFromCurrentUrl" minOccurs="0" maxOccurs="unbounded"/>
             <xs:element type="grabMultipleType" name="grabMultiple" minOccurs="0" maxOccurs="unbounded"/>
             <xs:element type="grabPageSourceType" name="grabPageSource" minOccurs="0" maxOccurs="unbounded"/>
@@ -53,6 +54,21 @@
         </xs:simpleContent>
     </xs:complexType>
 
+    <xs:complexType name="grabCookieAttributesType">
+      <xs:annotation>
+        <xs:documentation>
+          Grabs a cookie attributes value.
+        </xs:documentation>
+      </xs:annotation>
+      <xs:simpleContent>
+        <xs:extension base="xs:string">
+          <xs:attribute ref="userInput"/>
+          <xs:attribute ref="parameterArray"/>
+          <xs:attributeGroup ref="commonActionAttributes"/>
+        </xs:extension>
+      </xs:simpleContent>
+    </xs:complexType>
+
     <xs:complexType name="grabFromCurrentUrlType">
         <xs:annotation>
             <xs:documentation>
@@ -129,4 +145,4 @@
             </xs:extension>
         </xs:simpleContent>
     </xs:complexType>
-</xs:schema>
+</xs:schema>

src/Magento/FunctionalTestingFramework/Util/TestGenerator.php

@@ -1100,6 +1100,7 @@ public function generateStepsPhp($actionObjects, $generationScope = TestGenerato
                         $parameterArray
                     );
                     break;
+                case "grabCookieAttributes":
                 case "grabCookie":
                     $testSteps .= $this->wrapFunctionCallWithReturnValue(
                         $stepKey,
@@ -2371,6 +2372,7 @@ private function validateXmlAttributesMutuallyExclusive($key, $tagName, $attribu
                 'excludes' => [
                     'dontSeeCookie',
                     'grabCookie',
+                    'grabCookieAttributes',
                     'resetCookie',
                     'seeCookie',
                     'setCookie',