create-appraisejs 0.3.1-alpha.0 → 0.4.0-alpha.0

package/templates/starter/automation/steps/actions/click.step.ts

@@ -1,59 +1,57 @@
 import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvironment, generateRandomData, RandomDataType } from '../../../packages/cucumber-runtime/src/index.js'
-/**
- * @name click
- * @description Template step for handling element click
- * @type ACTION
- */
-
-// This file is generated automatically. Add template steps to this group to generate content.
-
-/**
- * @name click
- * @description Template step for clicking on an element
- * @icon MOUSE
- */
-When('the user clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).click()
-  } catch (error) {
-    throw new Error(`Failed to click on the ${elementName} element: ${error}`)
-  }
-})
-
-/**
- * @name double click
- * @description Template step for double clicking on an element
- * @icon MOUSE
- */
-When('the user double clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).dblclick()
-  } catch (error) {
-    throw new Error(`Failed to double click on the ${elementName} element: ${error}`)
-  }
-})
-
-/**
- * @name right click
- * @description Template step for right clicking on an element
- * @icon MOUSE
- */
-When('the user right clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
-  const selector = await resolveLocator(this.page, elementName)
-  if (!selector) {
-    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
-  }
-  try {
-    await this.page.locator(selector).click({ button: 'right' })
-  } catch (error) {
-    throw new Error(`Failed to right click on the ${elementName} element: ${error}`)
-  }
-})
+/**
+ * @name click
+ * @description Template step for handling element click
+ * @type ACTION
+ */
+
+/**
+ * @name click
+ * @description Template step for clicking on an element
+ * @icon MOUSE
+ */
+When('the user clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).click()
+  } catch (error) {
+    throw new Error(`Failed to click on the ${elementName} element: ${error}`)
+  }
+})
+
+/**
+ * @name double click
+ * @description Template step for double clicking on an element
+ * @icon MOUSE
+ */
+When('the user double clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).dblclick()
+  } catch (error) {
+    throw new Error(`Failed to double click on the ${elementName} element: ${error}`)
+  }
+})
+
+/**
+ * @name right click
+ * @description Template step for right clicking on an element
+ * @icon MOUSE
+ */
+When('the user right clicks on the {string} element', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found. Current url: ${this.page.url()}`)
+  }
+  try {
+    await this.page.locator(selector).click({ button: 'right' })
+  } catch (error) {
+    throw new Error(`Failed to right click on the ${elementName} element: ${error}`)
+  }
+})

package/templates/starter/automation/steps/actions/hover.step.ts

@@ -1,28 +1,26 @@
 import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvironment, generateRandomData, RandomDataType } from '../../../packages/cucumber-runtime/src/index.js'
-/**
- * @name hover
- * @description Template steps that handles hover actions
- * @type ACTION
- */
-
-// This file is generated automatically. Add template steps to this group to generate content.
-
-/**
- * @name hover
- * @description Template step for hovering over an element
- * @icon MOUSE
- */
-When(
-  'the user hovers the cursor over the {string} element',
-  async function (this: CustomWorld, elementName: SelectorName) {
-    try {
-      const selector = await resolveLocator(this.page, elementName);
-      if (!selector) {
-        throw new Error(`Selector ${elementName} not found`);
-      }
-      await this.page.locator(selector).hover();
-    } catch (error) {
-      throw new Error(`Failed to hover over the ${elementName} element: ${error}`);
-    }
-  }
-);
+/**
+ * @name hover
+ * @description Template steps that handles hover actions
+ * @type ACTION
+ */
+
+/**
+ * @name hover
+ * @description Template step for hovering over an element
+ * @icon MOUSE
+ */
+When(
+  'the user hovers the cursor over the {string} element',
+  async function (this: CustomWorld, elementName: SelectorName) {
+    try {
+      const selector = await resolveLocator(this.page, elementName)
+      if (!selector) {
+        throw new Error(`Selector ${elementName} not found`)
+      }
+      await this.page.locator(selector).hover()
+    } catch (error) {
+      throw new Error(`Failed to hover over the ${elementName} element: ${error}`)
+    }
+  },
+)

package/templates/starter/automation/steps/actions/input.step.ts

@@ -5,142 +5,119 @@ import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvir
  * @type ACTION
  */
 
-// This file is generated automatically. Add template steps to this group to generate content.
-
 /**
- * @name fill
- * @description Template step for filling up an input field with a provided value
+ * @name check
+ * @description Template step for checking a checkbox
  * @icon INPUT
  */
-When(
-    'the user fills in the {string} input field with value {string}',
-    async function (this: CustomWorld, elementName: SelectorName, value: string) {
-        const selector = await resolveLocator(this.page, elementName);
-        if (!selector) {
-            throw new Error(`Selector ${elementName} not found`);
-        }
-        try {
-            await this.page.locator(selector).fill(value);
-        } catch (error) {
-            throw new Error(
-                `Failed to fill in the ${elementName} input field with value ${value}: ${error}`
-            );
-        }
-    }
-);
+When('the user checks the {string} checkbox', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found`)
+  }
+  try {
+    await this.page.locator(selector).check()
+  } catch (error) {
+    throw new Error(`Failed to check the ${elementName} checkbox: ${error}`)
+  }
+})
 
 /**
  * @name clear
  * @description Template step for clearing an input field
  * @icon INPUT
  */
-When(
-    'the user clears the {string} field',
-    async function (this: CustomWorld, elementName: SelectorName) {
-        const selector = await resolveLocator(this.page, elementName);
-        if (!selector) {
-            throw new Error(`Selector ${elementName} not found`);
-        }
-        try {
-            await this.page.locator(selector).clear();
-        } catch (error) {
-            throw new Error(`Failed to clear the ${elementName} field: ${error}`);
-        }
-    }
-);
+When('the user clears the {string} field', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found`)
+  }
+  try {
+    await this.page.locator(selector).clear()
+  } catch (error) {
+    throw new Error(`Failed to clear the ${elementName} field: ${error}`)
+  }
+})
 
 /**
- * @name select dropdown option
- * @description Template step for selecting a particular option inside a dropdown element
+ * @name fill
+ * @description Template step for filling up an input field with a provided value
  * @icon INPUT
  */
 When(
-    'the user selects the {string} option of the {string} dropdown',
-    async function (
-        this: CustomWorld,
-        optionName: string,
-        elementName: SelectorName
-    ) {
-        const selector = await resolveLocator(this.page, elementName);
-        if (!selector) {
-            throw new Error(`Selector ${elementName} not found`);
-        }
-        try {
-            await this.page.locator(selector).selectOption(optionName);
-        } catch (error) {
-            throw new Error(
-                `Failed to select the ${optionName} option of the ${elementName} dropdown: ${error}`
-            );
-        }
+  'the user fills in the {string} input field with value {string}',
+  async function (this: CustomWorld, elementName: SelectorName, value: string) {
+    const selector = await resolveLocator(this.page, elementName)
+    if (!selector) {
+      throw new Error(`Selector ${elementName} not found`)
+    }
+    try {
+      await this.page.locator(selector).fill(value)
+    } catch (error) {
+      throw new Error(`Failed to fill in the ${elementName} input field with value ${value}: ${error}`)
     }
-);
+  },
+)
 
 /**
- * @name check
- * @description Template step for checking a checkbox
+ * @name fill input with stored value
+ * @description Template step for filling an input field with data from a stored variable
  * @icon INPUT
  */
 When(
-    'the user checks the {string} checkbox',
-    async function (this: CustomWorld, elementName: SelectorName) {
-        const selector = await resolveLocator(this.page, elementName);
-        if (!selector) {
-            throw new Error(`Selector ${elementName} not found`);
-        }
-        try {
-            await this.page.locator(selector).check();
-        } catch (error) {
-            throw new Error(`Failed to check the ${elementName} checkbox: ${error}`);
-        }
+  'the user fills in the {string} input with data from the stored variable {string}',
+  async function (this: CustomWorld, fieldName: SelectorName, variableName: string) {
+    const value = this.getVar<string>(variableName)
+    if (!value) {
+      throw new Error(`Variable ${variableName} not found`)
+    }
+    const selector = await resolveLocator(this.page, fieldName)
+    if (!selector) {
+      throw new Error(`Selector ${fieldName} not found`)
+    }
+    try {
+      await this.page.locator(selector).fill(value)
+    } catch (error) {
+      throw new Error(
+        `Failed to fill in the ${fieldName} input field with data from the stored variable ${variableName}: ${error}`,
+      )
     }
-);
+  },
+)
 
 /**
- * @name uncheck
- * @description Template step for unchecking a checkbox
+ * @name select dropdown option
+ * @description Template step for selecting a particular option inside a dropdown element
  * @icon INPUT
  */
 When(
-    'the user unchecks the {string} checkbox',
-    async function (this: CustomWorld, elementName: SelectorName) {
-        const selector = await resolveLocator(this.page, elementName);
-        if (!selector) {
-            throw new Error(`Selector ${elementName} not found`);
-        }
-        try {
-            await this.page.locator(selector).uncheck();
-        } catch (error) {
-            throw new Error(
-                `Failed to uncheck the ${elementName} checkbox: ${error}`
-            );
-        }
+  'the user selects the {string} option of the {string} dropdown',
+  async function (this: CustomWorld, optionName: string, elementName: SelectorName) {
+    const selector = await resolveLocator(this.page, elementName)
+    if (!selector) {
+      throw new Error(`Selector ${elementName} not found`)
     }
-);
+    try {
+      await this.page.locator(selector).selectOption(optionName)
+    } catch (error) {
+      throw new Error(`Failed to select the ${optionName} option of the ${elementName} dropdown: ${error}`)
+    }
+  },
+)
 
 /**
- * @name fill input with stored value
- * @description Template step for filling an input field with data from a stored variable
+ * @name uncheck
+ * @description Template step for unchecking a checkbox
  * @icon INPUT
  */
-When(
-    'the user fills in the {string} input with data from the stored variable {string}',
-    async function (
-        this: CustomWorld,
-        fieldName: SelectorName,
-        variableName: string
-    ) {
-        const value = this.getVar<string>(variableName);
-        if (!value) {
-            throw new Error(`Variable ${variableName} not found`);
-        }
-        const selector = await resolveLocator(this.page, fieldName);
-        if (!selector) {
-            throw new Error(`Selector ${fieldName} not found`);
-        }
-        try {
-            await this.page.locator(selector).fill(value);
-        } catch (error) {
-            throw new Error(`Failed to fill in the ${fieldName} input field with data from the stored variable ${variableName}: ${error}`);
-        }
-    }
-);
+When('the user unchecks the {string} checkbox', async function (this: CustomWorld, elementName: SelectorName) {
+  const selector = await resolveLocator(this.page, elementName)
+  if (!selector) {
+    throw new Error(`Selector ${elementName} not found`)
+  }
+  try {
+    await this.page.locator(selector).uncheck()
+  } catch (error) {
+    throw new Error(`Failed to uncheck the ${elementName} checkbox: ${error}`)
+  }
+})

package/templates/starter/automation/steps/actions/navigation.step.ts

@@ -1,71 +1,68 @@
 import { When, Then, CustomWorld, expect, SelectorName, resolveLocator, getEnvironment, generateRandomData, RandomDataType } from '../../../packages/cucumber-runtime/src/index.js'
-/**
- * @name navigation
- * @description Template steps that deals with browser navigation
- * @type ACTION
- */
-
-// This file is generated automatically. Add template steps to this group to generate content.
-
-/**
- * @name navigate to url
- * @description Navigate to the specified URL
- * @icon NAVIGATION
- */
-When('the user navigates to the {string} url', async function (this: CustomWorld, url: string) {
-  try {
-    await this.page.goto(url, { waitUntil: 'domcontentloaded' })
-  } catch (error) {
-    throw new Error(`Failed to navigate to the ${url} url: ${error}`)
-  }
-})
-
-/**
- * @name navigate to environment base url
- * @description Navigate to the base url of the selected environment
- * @icon NAVIGATION
- */
-When('the user navigates to the base url of the selected environment', async function (this: CustomWorld) {
-  try {
-    const environment = process.env.ENVIRONMENT as string
-    if (!environment) {
-      throw new Error('Environment is not set')
-    }
-    const environmentConfig = getEnvironment(environment)
-    if (!environmentConfig) {
-      throw new Error(`Environment ${environment} not found`)
-    }
-    await this.page.goto(environmentConfig.baseUrl, {
-      waitUntil: 'domcontentloaded',
-    })
-  } catch (error) {
-    throw new Error(`Failed to navigate to the base url of the selected environment: ${error}`)
-  }
-})
-
-/**
- * @name reload
- * @description Template step for reloading the current page
- * @icon NAVIGATION
- */
-When('the user reloads the page', async function (this: CustomWorld) {
-  try {
-    await this.page.reload()
-    await this.page.waitForLoadState('domcontentloaded')
-  } catch (error) {
-    throw new Error(`Failed to reload the page: ${error}`)
-  }
-})
-
-/**
- * @name go back
- * @description Template step for going back to the previous page
- * @icon NAVIGATION
- */
-When('the user goes back to the previous page', async function (this: CustomWorld) {
-  try {
-    await this.page.goBack({ waitUntil: 'domcontentloaded' })
-  } catch (error) {
-    throw new Error(`Failed to go back to the previous page: ${error}`)
-  }
-})
+/**
+ * @name navigation
+ * @description Template steps that deals with browser navigation
+ * @type ACTION
+ */
+/**
+ * @name navigate to url
+ * @description Navigate to the specified URL
+ * @icon NAVIGATION
+ */
+When('the user navigates to the {string} url', async function (this: CustomWorld, url: string) {
+  try {
+    await this.page.goto(url, { waitUntil: 'domcontentloaded' })
+  } catch (error) {
+    throw new Error(`Failed to navigate to the ${url} url: ${error}`)
+  }
+})
+
+/**
+ * @name reload
+ * @description Template step for reloading the current page
+ * @icon NAVIGATION
+ */
+When('the user reloads the page', async function (this: CustomWorld) {
+  try {
+    await this.page.reload()
+    await this.page.waitForLoadState('domcontentloaded')
+  } catch (error) {
+    throw new Error(`Failed to reload the page: ${error}`)
+  }
+})
+
+/**
+ * @name go back
+ * @description Template step for going back to the previous page
+ * @icon NAVIGATION
+ */
+When('the user goes back to the previous page', async function (this: CustomWorld) {
+  try {
+    await this.page.goBack({ waitUntil: 'domcontentloaded' })
+  } catch (error) {
+    throw new Error(`Failed to go back to the previous page: ${error}`)
+  }
+})
+
+/**
+ * @name navigate to environment base url
+ * @description Navigate to the base url of the selected environment
+ * @icon NAVIGATION
+ */
+When('the user navigates to the base url of the selected environment', async function (this: CustomWorld) {
+  try {
+    const environment = process.env.ENVIRONMENT as string
+    if (!environment) {
+      throw new Error('Environment is not set')
+    }
+    const environmentConfig = getEnvironment(environment)
+    if (!environmentConfig) {
+      throw new Error(`Environment ${environment} not found`)
+    }
+    await this.page.goto(environmentConfig.baseUrl, {
+      waitUntil: 'domcontentloaded',
+    })
+  } catch (error) {
+    throw new Error(`Failed to navigate to the base url of the selected environment: ${error}`)
+  }
+})