Lesson 5: Topic 5

README.md

@@ -1 +1,109 @@
-# coding-temple-cypress-playground
+# API Test Suite Documentation for Restful Booker
+
+## Overview
+
+This repository contains a comprehensive API test suite for the Restful Booker platform, designed to ensure the reliability and correctness of its API endpoints through automated testing using Cypress.
+
+## Prerequisites
+
+- Node.js (version 12 or higher)
+- npm (comes with Node.js)
+- Cypress
+- AJV and AJV-formats for schema validation (for validating API responses against JSON schemas)
+
+Ensure all dependencies are installed by running:
+
+```bash
+npm install cypress ajv ajv-formats --save-dev
+```
+
+## Installation
+
+Clone the repository and install dependencies to set up the project on your local machine:
+
+```bash
+git clone https://github.com/aasimsyed/coding-temple-cypress-playground
+cd coding-temple-cypress-playground
+npm install
+```
+
+## Running Tests
+
+To open the Cypress Test Runner for interactive testing:
+
+```bash
+npx cypress open
+```
+
+To run tests headlessly suitable for CI environments:
+
+```bash
+npx cypress run
+```
+
+## Configuration
+
+The cypress.config.js file is configured to handle environment variables and setup preferences:
+
+```javascript
+const { defineConfig } = require("cypress");
+
+module.exports = defineConfig({
+  e2e: {
+    env: {
+      restfulBookerUrl: 'https://restful-booker.herokuapp.com'
+    },
+    chromeWebSecurity: false,
+    supportFile: 'cypress/support/commands.js',
+    specPattern: [
+      'cypress/integration/e2e/**/*.spec.js',
+      'cypress/integration/api/**/*.spec.js'
+    ],
+    setupNodeEvents(on, config) {
+      // Event listeners can be defined here
+    }
+  }
+});
+```
+
+## Custom Commands
+
+Custom Cypress commands enhance test readability and reusability:
+
+- *apiRequest*: Abstracts making API requests with dynamic inputs.
+- *createBooking*: Wraps the apiRequest to create bookings.
+- *deleteBooking*: Utilizes apiRequest to delete bookings based on ID.
+
+These are defined in *cypress/support/commands.js*.
+
+## Schema Validation
+
+API response validation is performed using AJV combined with schemas defined in cypress/schemas. This ensures responses adhere to expected formats, crucial for API integrity.
+
+## Using Fixtures
+
+Fixtures are used to manage and maintain test data separate from test logic, located under cypress/fixtures. This allows easy management of test data without altering the test scripts.
+
+## Best Practices Employed
+
+- *Modular Test Structure*: Each API endpoint has dedicated test files under cypress/integration, making tests easier to manage and debug.
+- *Environment Abstraction*: Configuration details are abstracted into cypress.config.js, allowing easy changes without code adjustments.
+- *Schema Validation*: Ensures the API's output remains consistent, catching potential breaking changes.
+- *Custom Commands*: Reduces code duplication and increases the maintainability of tests.
+- *Efficient Use of Fixtures*: Separates test data from test logic, improving test clarity and ease of updates.
+
+## Potential Future Improvements
+
+- *Parallel Testing*: Implement Cypress's parallel execution capabilities to reduce test run times.
+- *Increased Coverage*: Expand tests to cover more scenarios and edge cases.
+- *Continuous Integration*: Integrate with CI/CD pipelines for automated running of tests upon code commits or at scheduled intervals.
+- *Security Testing*: Integrate security-focused tests to identify and mitigate potential vulnerabilities.
+
+## Project URL
+
+- https://github.com/aasimsyed/coding-temple-cypress-playground
+- PR for these change: https://github.com/aasimsyed/coding-temple-cypress-playground/pull/4
+
+## Conclusion
+
+The implemented test suite serves as a robust foundation for ongoing development, ensuring high standards of quality and reliability for the Restful Booker API. By adhering to best practices, this suite facilitates efficient testing and future expansion.

cypress.config.js

@@ -2,8 +2,17 @@ const { defineConfig } = require("cypress");
 
 module.exports = defineConfig({
   e2e: {
+    env: {
+      restfulBookerUrl: 'https://restful-booker.herokuapp.com'
+    },
+    chromeWebSecurity: false,
+    supportFile: 'cypress/support/commands.js',
+    specPattern: [
+      'cypress/integration/e2e/**/*.spec.js',
+      'cypress/integration/api/**/*.spec.js'
+    ],
     setupNodeEvents(on, config) {
       // implement node event listeners here
-    },
-  },
+    }
+  }
 });

cypress/fixtures/adBlockerUrls.json

@@ -0,0 +1,12 @@
+{
+  "blockAds": "https://pagead2.googlesyndication.com/**",
+  "blockGpt": "https://www.googletagservices.com/tag/js/gpt.js",
+  "blockGtm": "https://www.googletagmanager.com/gtm.js?id=GTM-MX8DD4S",
+  "blockAdPlus": "https://cdn.ad.plus/player/adplus.js",
+  "blockBacktrace": "https://events.backtrace.io/**",
+  "blockGif": "**/*.gif",
+  "blockUserMatch": "**/usermatch.gif**",
+  "blockMerge": "**/merge**",
+  "blockScripts": "**/*.js"
+}
+

cypress/fixtures/bookingDetails.json

@@ -0,0 +1,11 @@
+{
+  "firstname": "Jim",
+  "lastname": "Brown",
+  "totalprice": 111,
+  "depositpaid": true,
+  "bookingdates": {
+    "checkin": "2021-01-01",
+    "checkout": "2021-01-02"
+  },
+  "additionalneeds": "Breakfast"
+}

cypress/fixtures/credentials.json

@@ -0,0 +1,36 @@
+{
+  "users": {
+    "standardUser": {
+      "username": "standard_user",
+      "password": "secret_sauce"
+    },
+    "lockedOutUser": {
+      "username": "locked_out_user",
+      "password": "secret_sauce"
+    },
+    "problemUser": {
+      "username": "problem_user",
+      "password": "secret_sauce"
+    },
+    "performanceGlitchUser": {
+      "username": "performance_glitch_user",
+      "password": "secret_sauce"
+    },
+    "invalidUser": {
+      "username": "invalid_user",
+      "password": "secret_sauce"
+    },
+    "noPassword": {
+      "username": "standard_user",
+      "password": ""
+    },
+    "invalidPassword": {
+      "username": "standard_user",
+      "password": "invalid_password"
+    },
+    "noUsername": {
+      "username": "",
+      "password": "secret_sauce"
+    }
+  }
+}

cypress/fixtures/updateBookingDetails.json

@@ -0,0 +1,11 @@
+{
+  "firstname": "UpdatedFirstName",
+  "lastname": "UpdatedLastName",
+  "totalprice": 200,
+  "depositpaid": false,
+  "bookingdates": {
+    "checkin": "2023-01-10",
+    "checkout": "2023-01-15"
+  },
+  "additionalneeds": "Late checkout"
+}

cypress/integration/api/createBooking.spec.js

@@ -0,0 +1,61 @@
+import { getNewToken } from '../../support/utils';
+import { compileSchema } from '../../support/ajv-utils';
+
+describe('CreateBooking API Test', () => {
+  before(() => {
+    // Load and compile schemas
+    cy.readFile('cypress/schemas/createBookingRequest.json')
+      .then(compileSchema).as('validateRequest');
+    cy.readFile('cypress/schemas/createBookingResponse.json')
+      .then(compileSchema).as('validateResponse');
+    cy.log('Schemas compiled successfully.');
+
+    // Load booking details
+    cy.fixture('bookingDetails.json').as('bookingData');
+
+    // Retrieve a new token and store as alias
+    getNewToken().then(cy.wrap).as('token');
+  });
+
+  after(() => {
+    // Clean up: delete the booking created in the before hook
+    cy.get('@token').then(token => {
+      cy.get('@bookingId').then(bookingId => {
+        if (bookingId && token) {
+          cy.log('Cleaning up: deleting the booking created in the before hook');
+          cy.deleteBooking(bookingId, token).then(response => {
+            expect(response.status).to.eq(201);
+            cy.log(`Booking with ID: ${bookingId} deleted successfully.`);
+          });
+        } else {
+          cy.log('No booking ID or token available for cleanup.');
+        }
+      });
+    });
+  });
+
+  it('should create a new booking and validate the response matches the request', function () {
+    // Use aliases to ensure data is loaded before executing the test
+    cy.get('@token').then(token => {
+      cy.get('@bookingData').then(bookingData => {
+        cy.log('Creating a new booking with the provided details');
+        cy.createBooking(bookingData, token).then(response => {
+          expect(response.status).to.eq(200);
+          cy.log('Booking created with status:', response.status);
+
+          // Validate response schema
+          cy.get('@validateResponse').then(validateResponse => {
+            if (!validateResponse(response.body)) {
+              const errors = validateResponse.errors.map(err => `${err.instancePath} ${err.message}`).join(', ');
+              throw new Error(`Response validation failed: ${errors}`);
+            }
+            cy.log('Response schema validation passed.');
+
+            // Store the bookingId for cleanup
+            cy.wrap(response.body.bookingid).as('bookingId');
+          });
+        });
+      });
+    });
+  });
+});

cypress/integration/api/createToken.spec.js

@@ -0,0 +1,31 @@
+import { compileSchema } from '../../support/ajv-utils';
+
+describe('CreateToken API Test', () => {
+  before(() => {
+    // Load and compile the schema, then store it as an alias for use in the tests
+    cy.readFile('cypress/schemas/createTokenResponse.json')
+      .then(compileSchema)
+      .as('validateTokenSchema'); // Storing the compiled schema as an alias
+    cy.log('Token schema compiled and stored as an alias.');
+  });
+
+  it('should create a new auth token', () => {
+    cy.apiRequest('POST', '/auth', null, {
+      username: 'admin',
+      password: 'password123',
+    }).then((response) => {
+      expect(response.status).to.eq(200);
+      cy.log('Auth token created, validating response...');
+
+      // Use the alias for the schema to validate the response
+      cy.get('@validateTokenSchema').then((validate) => {
+        const validationResult = validate(response.body);
+        if (!validationResult) {
+          const errors = validate.errors.map(err => `${err.instancePath} ${err.message}`).join(', ');
+          throw new Error(`Validation error: ${errors}`);
+        }
+        cy.log('Response validated successfully against the schema.');
+      });
+    });
+  });
+});

cypress/integration/api/deleteBooking.spec.js

@@ -0,0 +1,47 @@
+import { getNewToken } from '../../support/utils';
+import { compileSchema } from '../../support/ajv-utils';
+
+describe('Delete Booking by ID API Tests', () => {
+  let validateResponse, bookingId, token;
+
+  before(() => {
+    // Compile the response schema
+    cy.readFile('cypress/schemas/deleteBookingResponse.json')
+      .then(compileSchema)
+      .then((compiledSchema) => {
+        validateResponse = compiledSchema;
+        cy.log('Response schema compiled successfully.');
+      });
+
+    // Retrieve authentication token
+    getNewToken().then((receivedToken) => {
+      cy.wrap(receivedToken).as('token');
+      cy.log('Authentication token retrieved:', token);
+
+      // Load booking details from a fixture and create a booking
+      cy.fixture('bookingDetails.json').then((bookingDetails) => {
+        cy.createBooking(bookingDetails, token).then((response) => {
+          expect(response.status).to.eq(200);
+          bookingId = response.body.bookingid;
+          cy.wrap(bookingId).as('bookingId');
+          cy.log(`New booking created with ID: ${bookingId}`);
+        });
+      });
+    });
+  });
+
+  it('should delete a booking by ID', () => {
+    cy.get('@token').then((token) => {
+      cy.get('@bookingId').then((bookingId) => {
+        if (bookingId && token) {
+          cy.deleteBooking(bookingId, token).then(response => {
+            expect(response.status).to.eq(201);
+            cy.log(`Booking with ID: ${bookingId} deleted successfully.`);
+          });
+        } else {
+          cy.log('No booking ID or token available for cleanup.');
+        }
+      });
+    });
+  });
+});