@qavajs/cypress 2.3.1 → 2.5.0

package/CHANGELOG.md

@@ -10,6 +10,18 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
 :pencil: - chore
 :microscope: - experimental
 
+## [2.5.0]
+- :rocket: added http steps
+
+## [2.4.0]
+- :rocket: added steps to work with custom properties (script results) in memory and validations
+```gherkin
+When I save '$js(element => element.prop("value"))' custom property of 'Element' as 'value'
+Then I expect '$js(element => element.prop("value"))' custom property of 'Element' to be equal '123'
+When I save '$js(element => element.prop("value"))' custom property of every element of 'Collection' collection as 'nodeNames'
+Then I expect '$js(element => element.prop("value"))' custom property of every element in 'Collection' collection to equal 'LI'
+```
+
 ## [2.3.1]
 - :x: removed alias assignment in page object
 

package/index.js

@@ -7,3 +7,4 @@ import './lib/valueValidation.js';
 import './lib/execute.js';
 import './lib/storage.js';
 import './lib/mouseActions.js';
+import './lib/http.js';

package/lib/actions.js

@@ -20,7 +20,7 @@ When('I open {value} url', function (url) {
 When('I type {value} (in)to {locator}', function (type, locator) {
     locator.type(type.value());
 });
-//
+
 /**
  * Click element
  * @param {string} alias - element to click

package/lib/http.js

@@ -0,0 +1,177 @@
+import { When } from '@qavajs/cypress-runner-adapter';
+import { dataTable2Object } from './utils';
+
+export class GraphQl {
+    method = 'POST';
+    headers = {'Content-Type': 'application/json'}
+    _query = '';
+    _variables = {};
+    data = {};
+
+    updateBody() {
+        this.body = {query: this._query, variables: this._variables};
+    };
+
+    set query(query) {
+        this._query = query;
+        this.updateBody();
+    };
+
+    set variables(variables) {
+        this._variables = JSON.parse(variables);
+        this.updateBody();
+    };
+}
+
+/**
+ * Create request template and save it to memory
+ * @param {string} method - should be named as one of the http methods (e.g. GET, POST, PUT, DELETE and etc.)
+ *
+ * @example
+ * When I create 'GET' request 'request'
+ */
+When('I create {string} request {value}', function (method, key) {
+    key.set({ method });
+});
+
+/**
+ * Create GraphQL request template and save it to memory
+ * @example
+ * When I create GraphQL request 'request'
+ */
+When('I create GraphQL request {value}', function (key) {
+    key.set(new GraphQl());
+});
+
+/**
+ * Add data table of headers to request
+ * @param {string} requestKey - memory key of request
+ * @param {Array<[string, string]>} headersDataTable - key value headers
+ *
+ * @example
+ * When I add headers to '$request':
+ *   | Content-Type | application/json |
+ */
+When('I add headers to {value}:', async function (requestKey, headersDataTable) {
+    const request = requestKey.value();
+    request.headers = Object.assign({}, request.headers, dataTable2Object(this, headersDataTable));
+});
+
+/**
+ * Add headers to request
+ * @param {string} requestKey - memory key of request
+ * @param {string} headersKey - memory key of headers that resolves to JS object
+ *
+ * @example
+ * When I add '$headers' headers to '$request'
+ */
+When('I add {value} headers to {value}', async function (headersKey, requestKey) {
+    const request = requestKey.value();
+    request.headers = Object.assign({}, request.headers, headersKey.value());
+});
+
+/**
+ * Add body to request
+ * @param {string} requestKey - memory key of request
+ * @param {string} body - body
+ *
+ * @example
+ * When I add body to '$request':
+ * """
+ *  {
+ *      "message": "qavajs"
+ *  }
+ * """
+ */
+When('I add body to {value}:', async function ( requestKey, body) {
+    const request = requestKey.value();
+    request.data = this.value(body);
+});
+
+/**
+ * Add query or variables to GraphQL request.
+ * @param {string} property - one of GraphQl specific properties "query" or "variables"
+ * @param {string} requestKey - memory key of request
+ * @param {string} valueString - multiline string to be set as GraphQl body value.
+ *
+ * @example
+ * When I add query to GraphQL '$request':
+ * """
+ *    query {
+ *      characters(page: 2, filter: { name: "rick" }) {
+ *        results {
+ *          name
+ *           }
+ *         }
+ *      }
+ **/
+When('I add {gqlRequestProperty} to GraphQL {value}:', async function (property, requestKey, valueString) {
+    const request = requestKey.value();
+    request[property] = this.value(valueString);
+});
+
+/**
+ * Add form data body to request
+ * @param {string} requestKey - memory key of request
+ * @param {string} body - body
+ *
+ * @example
+ * When I add body to '$request':
+ *   | key      | value                    | filename | contentType      |
+ *   | formKey  | formValue                |          | application/json |
+ *   | otherKey | otherValue               |          | text/plain       |
+ *   | fileKey  | $file('./path/file.png') | file.png | image/png        |
+ */
+When('I add form data body to {value}:', async function (requestKey, dataTable) {
+    const request = requestKey.value();
+    const formData = new FormData();
+    for (const record of dataTable.hashes()) {
+        const key = this.value(record.key);
+        const value = this.value(record.value);
+        const fileName = this.value(record.filename) ?? 'default';
+        const type = this.value(record.contentType);
+        formData.append(key, new Blob([value], { type }), fileName);
+    }
+    request.data = formData;
+});
+
+/**
+ * Add body to request
+ * @param {string} requestKey - memory key of request
+ * @param {string} body - body
+ *
+ * @example
+ * When I add '$body' body to '$request'
+ */
+When('I add {value} body to {value}', async function (bodyKey, requestKey) {
+    const request = requestKey.value();
+    request.data = bodyKey.value();
+});
+
+/**
+ * Add url to request
+ * @param {string} requestKey - memory key of request
+ * @param {string} url - url
+ *
+ * @example
+ * When I add 'https://qavajs.github.io/' url to '$request'
+ */
+When('I add {value} url to {value}', async function (urlKey, requestKey) {
+    const request = requestKey.value();
+    request.url = urlKey.value();
+});
+
+/**
+ * Send request and send response
+ * @param {string} requestKey - memory key of request
+ * @param {string} responseKey - memory key to save response
+ *
+ * @example
+ * When I send '$request' request and save response as 'response'
+ */
+When('I send {value} request and save response as {value}', async function (requestKey, responseKey) {
+    const request = requestKey.value();
+    cy.request(request).then(response => {
+        responseKey.set(response);
+    });
+});

package/lib/memory.js

@@ -43,6 +43,20 @@ When('I save {value} attribute of {locator} as {value}', function (attribute, lo
     });
 });
 
+/**
+ * Save custom property of element to memory
+ * @param {string} propertyGetter - property getter script
+ * @param {string} alias - element to get value
+ * @param {string} key - key to store value
+ * @example I save '$js(e => e.first().prop("nodeName"))' custom property of 'Checkbox' as 'INPUT'
+ */
+When('I save {value} custom property of {locator} as {value}', function (property, locator, key) {
+    const script = property.value();
+    locator.then(element => {
+        key.set(script(element));
+    });
+});
+
 /**
  * Save number of elements in collection to memory
  * @param {string} alias - collection to get value
@@ -114,6 +128,27 @@ When(
     }
 );
 
+/**
+ * Save custom property of every element in collection to memory
+ * @param {string} propertyGetter - property getter script
+ * @param {string} alias - collection to get values
+ * @param {string} key - key to store value
+ * @example I save '$js(e => e.first().prop("nodeName"))' custom property of every element of 'Search Results' collection as 'LI'
+ */
+When(
+    'I save {value} custom property of every element of {locator} collection as {value}',
+    function (propertyGetter, collection, key) {
+        const script = propertyGetter.value();
+        collection.then(c => {
+            const values = [];
+            c.each(function () {
+                values.push(script(Cypress.$(this)));
+            });
+            key.set(values);
+        });
+    }
+);
+
 /**
  * Save current url to memory
  * @param {string} key - key to store value
@@ -166,12 +201,6 @@ When('I save bounding rect of {locator} as {value}', function (locator, key) {
     });
 });
 
-
-/**
- * ##############################
- */
-
-
 /**
  * Save value to memory
  * @param {string} alias - value to save or alias for previously saved value

package/lib/types.js

@@ -58,3 +58,25 @@ defineParameterType({
     regexp: /(back|forward)/,
     useForSnippets: false
 });
+
+/**
+ * Parse http response body
+ * @returns {string}
+ */
+defineParameterType({
+    name: 'bodyParsingType',
+    regexp: /buffer|json|text/,
+    transformer: p => p === 'buffer' ? 'body' : p,
+    useForSnippets: false,
+});
+
+/**
+ * GraphQL request property
+ * @returns {string}
+ */
+defineParameterType({
+    name: 'gqlRequestProperty',
+    regexp: /query|variables/,
+    transformer: s => s,
+    useForSnippets: false,
+});

package/lib/validation.js

@@ -87,6 +87,26 @@ Then(
     }
 );
 
+/**
+ * Verify that custom property (script result) of element satisfies condition
+ * @param {string} property - element to verify
+ * @param {string} alias - element to verify
+ * @param {string} validation - validation
+ * @param {string} value - expected value
+ * @example I expect '$js(e => e.first().prop("nodeName"))' custom property of 'Search Result' to be equal 'LI'
+ * @example I expect '$js(e => e.first().prop("nodeName"))' property of 'Label' to contain 'span'
+ */
+Then(
+    'I expect {value} custom property of {locator} {validation} {value}',
+    function (property, locator, validation, value) {
+        const script = property.value();
+        const expectedValue = value.value();
+        locator.should(e => {
+            validation(script(e), expectedValue);
+        });
+    }
+);
+
 /**
  * Verify that current url satisfies condition
  * @param {string} validation - validation
@@ -193,6 +213,25 @@ Then(
     }
 );
 
+/**
+ * Verify that custom property of all elements in collection satisfy condition
+ * @param {string} propertyGetter - property getter script
+ * @param {string} alias - collection to get props
+ * @param {string} validation - validation
+ * @param {string} value - expected result
+ * @example I expect '$js(e => e.first().prop("nodeName"))' property of every element in 'Search Results' collection to contain 'LI'
+ */
+Then(
+    'I expect {value} custom property of every element in {locator} collection {validation} {value}',
+    function (property, collection, validation, value) {
+        const expectedValue = value.value();
+        const script = property.value();
+        collection.each(element => {
+            validation(script(element), expectedValue);
+        });
+    }
+);
+
 /**
  * Verify that css property of element satisfies condition
  * @param {string} property - element to verify

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qavajs/cypress",
-  "version": "2.3.1",
+  "version": "2.5.0",
   "description": "qavajs for cypress runner",
   "main": "index.js",
   "scripts": {
@@ -27,8 +27,8 @@
   "author": "Alexandr Galichenko",
   "license": "MIT",
   "devDependencies": {
-    "@qavajs/cypress-runner-adapter": "^1.3.0",
+    "@qavajs/cypress-runner-adapter": "^1.5.0",
     "@qavajs/memory": "^1.10.3",
-    "cypress": "^15.4.0"
+    "cypress": "^15.8.1"
   }
 }