generator-jhipster-playwright 1.0.0

package/generators/cypress/templates/src/test/javascript/cypress/e2e/entity/_entity_.spec.ts.ejs

@@ -0,0 +1,378 @@
+<%_
+/**
+ * Entity spec template
+ * Translated from Cypress _entity_.cy.ts (v9)
+ *
+ * Source EJS variables (all from entity context merged with application):
+ *   - readOnly, updatableEntity, entityApi, entityApiUrl, entityPage, entityInstance,
+ *     entityNameCapitalized, primaryKey.name, adminEntity, fields, relationships,
+ *     differentRelationships, builtInUserManagement, userManagement,
+ *     graalvmSupport, cypressBootstrapEntities, paginationNo,
+ *     clientFrameworkReact, clientFrameworkVue, jpaMetamodelFiltering,
+ *     anyFieldHasFileBasedContentType, workaroundEntityCannotBeEmpty,
+ *     workaroundInstantReactiveMariaDB, applicationTypeMicroservice
+ *   - this.generateTestEntity() — generator method
+ *   - this._ — lodash
+ */
+
+const skipUserManagementCreatePage = builtInUserManagement && !userManagement.skipClient;
+const baseApi = entityApi + 'api/';
+
+const entityFakeData = this.generateTestEntity(fields.filter(f => !f.autoGenerate && !f.nullable));
+const requiredRelationships = relationships.filter(rel => rel.relationshipRequired || rel.id);
+const requiredOtherEntities = this._.uniq(requiredRelationships.map(rel => rel.otherEntity));
+const otherEntities = this._.uniq(Object.values(differentRelationships).filter(rels => rels.length > 0).map(rels => rels[0].otherEntity));
+const skipCreateTest =
+  (
+    graalvmSupport ||
+    !cypressBootstrapEntities ||
+    requiredRelationships.some(rel => rel.otherEntity.primaryKey && rel.otherEntity.primaryKey.derived) ||
+    requiredRelationships.some(rel => rel.otherEntity.builtInUser || rel.otherEntity === this.entity) ||
+    requiredRelationships.map(rel => rel.otherEntity.relationships).flat().some(rel => rel.relationshipRequired) ||
+    !entityFakeData
+  ) ? '.skip' : '';
+
+const reason = graalvmSupport ? 'graalvm is failing.' : 'cannot create a required entity with relationship with required relationships.';
+
+const sampleFields = fields.filter(f => !f.autoGenerate && !f.nullable);
+
+if (workaroundEntityCannotBeEmpty && sampleFields.length === 0) {
+  const sample = fields.find(f => !f.autoGenerate);
+  if (sample) {
+    sampleFields.push(sample);
+  }
+} else if (workaroundInstantReactiveMariaDB) {
+  const samples = fields.filter(f => !f.autoGenerate && f.nullable && f.fieldType === 'Instant');
+  if (samples.length > 0) {
+    sampleFields.push(...samples);
+  }
+}
+_%>
+import { test, expect } from '@playwright/test';
+import {
+  entityTableSelector,
+  entityDetailsButtonSelector,
+  entityDetailsBackButtonSelector,
+<%_ if (!readOnly) { _%>
+  entityCreateButtonSelector,
+  entityCreateSaveButtonSelector,
+  entityCreateCancelButtonSelector,
+  <%_ if (updatableEntity) { _%>
+  entityEditButtonSelector,
+  <%_ } _%>
+  entityDeleteButtonSelector,
+  entityConfirmDeleteButtonSelector,
+<%_ } _%>
+  getEntityHeading,
+  getEntityCreateUpdateHeading,
+  getEntityDetailsHeading,
+  getEntityDeleteDialogHeading,
+} from '../../support/entity';
+import { credentials, login, authenticatedRequest } from '../../support/commands';
+import { clickOn<%= adminEntity && !applicationTypeMicroservice ? 'Admin' : 'Entity' %>MenuItem } from '../../support/navbar';
+
+test.describe('<%- entityNameCapitalized %> e2e test', () => {
+
+  const <%= entityInstance %>PageUrl = '/<%= entityPage %>';
+  const <%= entityInstance %>PageUrlPattern = new RegExp('/<%= entityPage %>(\\\\?.*)?$');
+  const <%= entityInstance %>ApiUrlPattern = new RegExp('/<%= baseApi + entityApiUrl %>(\\\\?.*)?$');
+  let username: string;
+  let password: string;
+<%_ if (!readOnly) { _%>
+  <% if (skipCreateTest) { %>// <% } %>const <%= entityInstance %>Sample = <%- JSON.stringify(this.generateTestEntity(sampleFields)) %>;
+<%_ } _%>
+
+  let <%= entityInstance %>: any;
+<%_ for (const otherEntity of requiredOtherEntities) { _%>
+  <% if (skipCreateTest) { %>// <% } %>let <%= otherEntity.entityInstance %>: any;
+<%_ } _%>
+
+  test.beforeAll(() => {
+    const creds = credentials();
+    ({ <%- adminEntity ? 'adminUsername : ' : '' %>username, <%- adminEntity ? 'adminPassword : ' : '' %>password } = creds);
+  });
+
+  test.beforeEach(async ({ page, request }) => {
+    await login(page, request, username, password);
+  });
+
+<%_ if (requiredOtherEntities.length > 0) { _%>
+  <%_ if (skipCreateTest) { _%>
+  /* Disabled due to incompatibility
+  <%_ } _%>
+  test.beforeEach(async ({ request }) => {
+  <%_ for (const otherEntity of requiredOtherEntities) { _%>
+    const response<%= otherEntity.entityClass %> = await authenticatedRequest(request, {
+      method: 'POST',
+      url: '/<%= baseApi + otherEntity.entityApiUrl %>',
+      data: <%- JSON.stringify(this.generateTestEntity(otherEntity.fields.filter(f => !f.autoGenerate))) %>,
+    });
+    <%= otherEntity.entityInstance %> = await response<%= otherEntity.entityClass %>.json();
+  <%_ } _%>
+  });
+  <%_ if (skipCreateTest) { _%>
+   */
+  <%_ } _%>
+
+<%_ } _%>
+  test.afterEach(async ({ request }) => {
+    if (<%= entityInstance %>) {
+      await authenticatedRequest(request, { method: 'DELETE', url: `/<%= baseApi + entityApiUrl %>/${<%= entityInstance %>.<%= primaryKey.name %>}` });
+      <%= entityInstance %> = undefined;
+    }
+  });
+
+<%_ if (requiredOtherEntities.length > 0) { _%>
+  <%_ if (skipCreateTest) { _%>
+  /* Disabled due to incompatibility
+  <%_ } _%>
+  test.afterEach(async ({ request }) => {
+  <%_ for (const otherEntity of requiredOtherEntities) { _%>
+    if (<%= otherEntity.entityInstance %>) {
+      await authenticatedRequest(request, { method: 'DELETE', url: `/<%= baseApi + otherEntity.entityApiUrl %>/${<%= otherEntity.entityInstance %>.<%= otherEntity.primaryKey.name %>}` });
+      <%= otherEntity.entityInstance %> = undefined;
+    }
+  <%_ } _%>
+  });
+  <%_ if (skipCreateTest) { _%>
+   */
+  <%_ } _%>
+
+<%_ } _%>
+
+  test('<%- entityNameCapitalized %> menu should load <%- entityNameCapitalized %> page', async ({ page }) => {
+    await page.goto('/');
+    await clickOn<%= adminEntity && !applicationTypeMicroservice ? 'Admin' : 'Entity' %>MenuItem(page, '<%= entityPage %>');
+    await expect(page).toHaveURL(<%= entityInstance %>PageUrlPattern);
+    await expect(getEntityHeading(page, '<%- entityNameCapitalized %>')).toBeVisible();
+  });
+
+  test.describe('<%- entityNameCapitalized %> page', () => {
+<%_ if (!readOnly) { _%>
+    test.describe('create button click', () => {
+      test.beforeEach(async ({ page }) => {
+        await page.goto(<%= entityInstance %>PageUrl);
+        await page.waitForResponse('**/<%= baseApi + entityApiUrl %>*');
+      });
+
+      test('should load create <%- entityNameCapitalized %> page', async ({ page }) => {
+        await page.locator(entityCreateButtonSelector).click();
+        await expect(page).toHaveURL(new RegExp('/<%= entityPage %>/new$'));
+        await expect(getEntityCreateUpdateHeading(page, '<%- entityNameCapitalized %>')).toBeVisible();
+        await expect(page.locator(entityCreateSaveButtonSelector)).toBeVisible();
+        await page.locator(entityCreateCancelButtonSelector).click();
+        const response = await page.waitForResponse('**/<%= baseApi + entityApiUrl %>*');
+        expect(response.status()).toBe(200);
+        await expect(page).toHaveURL(<%= entityInstance %>PageUrlPattern);
+      });
+    });
+
+<%_ } _%>
+    test.describe('with existing value', () => {
+<%_ if (!readOnly) { _%>
+  <%_ if (skipCreateTest) { _%>
+      /* Disabled due to incompatibility
+  <%_ } _%>
+      test.beforeEach(async ({ page, request }) => {
+        const createResponse = await authenticatedRequest(request, {
+          method: 'POST',
+          url: '/<%= baseApi + entityApiUrl %>',
+  <%_ if (requiredRelationships.length > 0) { _%>
+          data: {
+            ...<%= entityInstance %>Sample,
+    <%_ for (const relationship of requiredRelationships) { _%>
+            <%= relationship.propertyName %>: <%= relationship.collection ? '[' : '' %><%= relationship.otherEntity.entityInstance %><%= relationship.collection ? ']' : '' %>,
+    <%_ } _%>
+          },
+  <%_ } else { _%>
+          data: <%= entityInstance %>Sample,
+  <%_ } _%>
+        });
+        const created<%= entityNameCapitalized %> = await createResponse.json();
+        <%= entityInstance %> = {
+          ...<%= entityInstance %>Sample,
+          ...created<%= entityNameCapitalized %>,
+        };
+  <%_ if (builtInUserManagement) { _%>
+        if (<%= entityInstance %>.login) {
+          <%= entityInstance %>.login = String(<%= entityInstance %>.login).toLowerCase();
+        }
+  <%_ } _%>
+
+        // Mock the list endpoint
+        await page.route(<%= entityInstance %>ApiUrlPattern, async (route, req) => {
+          if (req.method() === 'GET') {
+            await route.fulfill({
+              status: 200,
+  <%_ if (!paginationNo) { _%>
+              headers: {
+                link: '<http://localhost/<%= baseApi + entityApiUrl %>?page=0&size=20>; rel="last",<http://localhost/<%= baseApi + entityApiUrl %>?page=0&size=20>; rel="first"',
+              },
+  <%_ } _%>
+              contentType: 'application/json',
+              body: JSON.stringify([<%= entityInstance %>]),
+            });
+          } else {
+            await route.continue();
+          }
+        }, { times: 1 });
+
+        const entitiesRequestPromise = page.waitForResponse(
+          response => response.url().match(<%= entityInstance %>ApiUrlPattern) !== null && response.request().method() === 'GET',
+        );
+        await page.goto(<%= entityInstance %>PageUrl);
+        const entitiesResponse = await entitiesRequestPromise;
+        expect(entitiesResponse.status()).toBe(200);
+      });
+  <%_ if (skipCreateTest) { _%>
+       */
+
+  <%_ } _%>
+<%_ } _%>
+<%_ if (readOnly || skipCreateTest) { _%>
+      test.beforeEach(async ({ page }) => {
+        await page.goto(<%= entityInstance %>PageUrl);
+        const response = await page.waitForResponse('**/<%= baseApi + entityApiUrl %>*');
+        const body = await response.json();
+        if (body.length === 0) {
+          test.skip();
+        }
+      });
+
+<%_ } _%>
+
+      test('detail button click should load details <%- entityNameCapitalized %> page', async ({ page }) => {
+        const entityRow = page.locator('tbody tr').filter({ hasText: String(<%= entityInstance %>.<%= primaryKey.name %>) }).first();
+        await entityRow.locator(entityDetailsButtonSelector).click();
+        await expect(getEntityDetailsHeading(page, '<%= entityInstance %>')).toBeVisible();
+        const responsePromise = page.waitForResponse('**/<%= baseApi + entityApiUrl %>*');
+        await page.locator(entityDetailsBackButtonSelector).click();
+        const response = await responsePromise;
+        expect(response.status()).toBe(200);
+        await expect(page).toHaveURL(<%= entityInstance %>PageUrlPattern);
+      });
+
+<%_ if (!readOnly && updatableEntity) { _%>
+      test('edit button click should load edit <%- entityNameCapitalized %> page and go back', async ({ page }) => {
+        const entityRow = page.locator('tbody tr').filter({ hasText: String(<%= entityInstance %>.<%= primaryKey.name %>) }).first();
+        await entityRow.locator(entityEditButtonSelector).click();
+        await expect(getEntityCreateUpdateHeading(page, '<%- entityNameCapitalized %>')).toBeVisible();
+        await expect(page.locator(entityCreateSaveButtonSelector)).toBeVisible();
+        const responsePromise = page.waitForResponse('**/<%= baseApi + entityApiUrl %>*');
+        await page.locator(entityCreateCancelButtonSelector).click();
+        const response = await responsePromise;
+        expect(response.status()).toBe(200);
+        await expect(page).toHaveURL(<%= entityInstance %>PageUrlPattern);
+      });
+
+      test<% if (jpaMetamodelFiltering && clientFrameworkVue && requiredRelationships.length) { %>.skip<% } %>('edit button click should load edit <%- entityNameCapitalized %> page and save', async ({ page }) => {
+        const entityRow = page.locator('tbody tr').filter({ hasText: String(<%= entityInstance %>.<%= primaryKey.name %>) }).first();
+        await entityRow.locator(entityEditButtonSelector).click();
+        await expect(getEntityCreateUpdateHeading(page, '<%- entityNameCapitalized %>')).toBeVisible();
+        await page.locator(entityCreateSaveButtonSelector).click();
+        await expect(page).toHaveURL(<%= entityInstance %>PageUrlPattern);
+      });
+
+<%_ } _%>
+<%_ if (!readOnly) { _%>
+      <% if (skipCreateTest) { %>// Reason: <%- reason %><% } %>
+      test<%= skipCreateTest %>('last delete button click should delete instance of <%- entityNameCapitalized %>', async ({ page }) => {
+  <%_ if (clientFrameworkReact) { _%>
+        const dialogPromise = page.waitForResponse('**/<%= baseApi + entityApiUrl %>/*');
+  <%_ } _%>
+        const entityRow = page.locator('tbody tr').filter({ hasText: String(<%= entityInstance %>.<%= primaryKey.name %>) }).first();
+        await entityRow.locator(entityDeleteButtonSelector).click();
+  <%_ if (clientFrameworkReact) { _%>
+        await dialogPromise;
+  <%_ } _%>
+        await expect(getEntityDeleteDialogHeading(page, '<%= entityInstance %>')).toBeVisible();
+        await page.locator(entityConfirmDeleteButtonSelector).click();
+        const deleteResponse = await page.waitForResponse(resp =>
+          resp.url().includes('/<%= baseApi + entityApiUrl %>/') && resp.request().method() === 'DELETE'
+        );
+        expect(deleteResponse.status()).toBe(204);
+        const listResponse = await page.waitForResponse('**/<%= baseApi + entityApiUrl %>*');
+        expect(listResponse.status()).toBe(200);
+        await expect(page).toHaveURL(<%= entityInstance %>PageUrlPattern);
+  <% if (cypressBootstrapEntities) { %>
+        <%= entityInstance %> = undefined;
+  <%_ } _%>
+      });
+<%_ } _%>
+    });
+  });
+<%_ if (!readOnly) { _%>
+
+  test.describe<% if (skipUserManagementCreatePage) { %>.skip<% } %>('new <%- entityNameCapitalized %> page', () => {
+    test.beforeEach(async ({ page }) => {
+      await page.goto(<%= entityInstance %>PageUrl);
+      await page.waitForResponse('**/<%= baseApi + entityApiUrl %>*');
+      await page.locator(entityCreateButtonSelector).click();
+      await expect(getEntityCreateUpdateHeading(page, '<%- entityNameCapitalized %>')).toBeVisible();
+    });
+
+    <% if (skipCreateTest) { %>// Reason: <%- reason %><% } %>
+    test<%= skipCreateTest %>('should create an instance of <%- entityNameCapitalized %>', async ({ page }) => {
+  <%_ fields.filter(field => (!field.id || !field.autoGenerate) && !field.hidden && !field.readonly).forEach((field) => {
+    const fieldName = field.fieldName;
+    const fieldIsEnum = field.fieldIsEnum;
+    let fieldValue = !entityFakeData ? field.generateFakeData('cypress') : entityFakeData[field.fieldName];
+    if (fieldValue === undefined) {
+        return;
+    }
+    fieldValue = typeof fieldValue === 'string' ? fieldValue.replaceAll("\\", "\\\\").replaceAll("'", "\\'") : fieldValue;
+  _%>
+
+    <%_ if (field.fieldTypeBoolean) { _%>
+      const <%= fieldName %>Checkbox = page.locator(`[data-cy="<%= fieldName %>"]`);
+      await expect(<%= fieldName %>Checkbox).<%= field.fieldTsDefaultValue === 'true' ? '' : 'not.' %>toBeChecked();
+      await <%= fieldName %>Checkbox.click();
+      await expect(<%= fieldName %>Checkbox).<%= field.fieldTsDefaultValue === 'true' ? 'not.' : '' %>toBeChecked();
+
+    <%_ } else if (field.fieldTypeBinary && !field.blobContentTypeText) { _%>
+      // Playwright uses native setInputFiles instead of DataTransfer hack
+      const fixturePath = require('path').join(__dirname, '..', '..', 'fixtures', 'integration-test.png');
+      await page.locator(`[data-cy="<%= fieldName %>"]`).setInputFiles(fixturePath);
+
+    <%_ } else if (fieldIsEnum) { _%>
+      await page.locator(`[data-cy="<%= fieldName %>"]`).selectOption('<%- fieldValue %>');
+
+    <%_ } else if (field.fieldTypeString || field.fieldTypeNumeric || field.fieldTypeLocalDate || field.fieldTypeTimed || field.fieldTypeDuration) { _%>
+      await page.locator(`[data-cy="<%= fieldName %>"]`).fill('<%- fieldValue %>');
+      <% if (field.fieldTypeLocalDate || field.fieldTypeTimed || field.fieldTypeDuration) { %>await page.locator(`[data-cy="<%= fieldName %>"]`).evaluate(e => e.blur());<% } %> await expect(page.locator(`[data-cy="<%= fieldName %>"]`)).toHaveValue('<%- fieldValue %>');
+
+    <%_ } else { _%>
+      await page.locator(`[data-cy="<%= fieldName %>"]`).fill('<%- fieldValue %>');
+      await expect(page.locator(`[data-cy="<%= fieldName %>"]`)).toHaveValue(new RegExp('<%- fieldValue %>'));
+
+    <%_ } _%>
+  <%_ }); _%>
+  <%_ for (const relationship of requiredRelationships) {
+  _%>
+       await page.locator(`[data-cy="<%= relationship.relationshipFieldName %>"]`).selectOption(<%= relationship.collection ? '[0]' : '1' %>);
+  <%_ } _%>
+
+  <%_ if (builtInUserManagement) { _%>
+      await page.locator(`[data-cy="langKey"]`).selectOption({ index: 0 });
+  <%_ } _%>
+
+  <%_ if (anyFieldHasFileBasedContentType) { _%>
+      // Wait for blob fields to be validated
+      await page.waitForTimeout(200);
+  <%_ } _%>
+      const createResponsePromise = page.waitForResponse('**/<%= baseApi + entityApiUrl %>');
+      const listResponsePromise = page.waitForResponse(
+        resp => resp.url().includes('/<%= baseApi + entityApiUrl %>') && resp.request().method() === 'GET'
+      );
+      await page.locator(entityCreateSaveButtonSelector).click();
+      const createResponse = await createResponsePromise;
+      expect(createResponse.status()).toBe(201);
+      <%= entityInstance %> = await createResponse.json();
+
+      const listResponse = await listResponsePromise;
+      expect(listResponse.status()).toBe(200);
+      await expect(page).toHaveURL(<%= entityInstance %>PageUrlPattern);
+    });
+  });
+<%_ } _%>
+});

package/generators/cypress/templates/src/test/javascript/cypress/support/account.ts.ejs

@@ -0,0 +1,26 @@
+/**
+ * Playwright account helpers
+ * Translated from Cypress account.ts (v9)
+ *
+ * Source: ZERO EJS variables — pure static translation.
+ */
+import type { APIRequestContext, APIResponse } from '@playwright/test';
+import { authenticatedRequest } from './commands';
+
+export type Account = Record<string, string | boolean | number>;
+
+export async function getAccount(request: APIRequestContext): Promise<Account> {
+  const response = await authenticatedRequest(request, {
+    method: 'GET',
+    url: '/api/account',
+  });
+  return response.json() as Promise<Account>;
+}
+
+export async function saveAccount(request: APIRequestContext, account: Account): Promise<APIResponse> {
+  return authenticatedRequest(request, {
+    method: 'POST',
+    url: '/api/account',
+    data: account,
+  });
+}

package/generators/cypress/templates/src/test/javascript/cypress/support/commands.ts.ejs

@@ -0,0 +1,200 @@
+/**
+ * Playwright support commands
+ * Translated from Cypress commands.ts (v9)
+ *
+ * Source EJS variables used:
+ *   - authenticationTypeOauth2, authenticationTypeJwt, authenticationTypeSession
+ *   - withAdminUi
+ *   - clientFrameworkAngular, clientFrameworkReact, clientFrameworkVue
+ */
+import type { Page, APIRequestContext, APIResponse } from '@playwright/test';
+import { expect, request as pwRequest } from '@playwright/test';
+
+// ***********************************************
+// Begin Specific Selector Attributes
+// ***********************************************
+
+// Navbar
+export const navbarSelector = '[data-cy="navbar"]';
+export const adminMenuSelector = '[data-cy="adminMenu"]';
+export const accountMenuSelector = '[data-cy="accountMenu"]';
+export const registerItemSelector = '[data-cy="register"]';
+export const settingsItemSelector = '[data-cy="settings"]';
+export const passwordItemSelector = '[data-cy="passwordItem"]';
+export const loginItemSelector = '[data-cy="login"]';
+export const logoutItemSelector = '[data-cy="logout"]';
+export const entityItemSelector = '[data-cy="entity"]';
+
+<%_ if (!authenticationTypeOauth2) { _%>
+// Login
+export const titleLoginSelector = '[data-cy="loginTitle"]';
+export const errorLoginSelector = '[data-cy="loginError"]';
+export const usernameLoginSelector = '[data-cy="username"]';
+export const passwordLoginSelector = '[data-cy="password"]';
+export const forgetYourPasswordSelector = '[data-cy="forgetYourPasswordSelector"]';
+export const submitLoginSelector = '[data-cy="submit"]';
+
+// Register
+export const usernameRegisterSelector = '[data-cy="username"]';
+export const emailRegisterSelector = '[data-cy="email"]';
+export const firstPasswordRegisterSelector = '[data-cy="firstPassword"]';
+export const secondPasswordRegisterSelector = '[data-cy="secondPassword"]';
+export const submitRegisterSelector = '[data-cy="submit"]';
+
+// Settings
+export const firstNameSettingsSelector = '[data-cy="firstname"]';
+export const lastNameSettingsSelector = '[data-cy="lastname"]';
+export const emailSettingsSelector = '[data-cy="email"]';
+export const submitSettingsSelector = '[data-cy="submit"]';
+
+// Password
+export const currentPasswordSelector = '[data-cy="currentPassword"]';
+export const newPasswordSelector = '[data-cy="newPassword"]';
+export const confirmPasswordSelector = '[data-cy="confirmPassword"]';
+export const submitPasswordSelector = '[data-cy="submit"]';
+
+// Reset Password
+export const emailResetPasswordSelector = '[data-cy="emailResetPassword"]';
+export const submitInitResetPasswordSelector = '[data-cy="submit"]';
+<%_ } _%>
+
+// Administration
+export const swaggerFrameSelector = 'iframe[data-cy="swagger-frame"]';
+export const swaggerPageSelector = '[id="swagger-ui"]';
+<%_ if (withAdminUi) { _%>
+export const metricsPageHeadingSelector = '[data-cy="metricsPageHeading"]';
+export const healthPageHeadingSelector = '[data-cy="healthPageHeading"]';
+export const logsPageHeadingSelector = '[data-cy="logsPageHeading"]';
+export const configurationPageHeadingSelector = '[data-cy="configurationPageHeading"]';
+<%_ } _%>
+
+// ***********************************************
+// End Specific Selector Attributes
+// ***********************************************
+
+export const classInvalid = <% if (clientFrameworkAngular) { %>'ng-invalid'<% } else { %>'is-invalid'<% } %>;
+
+export const classValid = <% if (clientFrameworkAngular) { %>'ng-valid'<% } else { %>'is-valid'<% } %>;
+
+export interface Credentials {
+  adminUsername: string;
+  adminPassword: string;
+  username: string;
+  password: string;
+}
+
+async function waitForAppShell(page: Page): Promise<void> {
+  await expect(page.locator(navbarSelector)).toBeVisible();
+}
+
+/**
+ * Get test credentials from environment or defaults.
+ */
+export function credentials(): Credentials {
+  return {
+    adminUsername: process.env.E2E_USERNAME ?? 'admin',
+    adminPassword: process.env.E2E_PASSWORD ?? 'admin',
+    username: process.env.E2E_USERNAME ?? 'user',
+    password: process.env.E2E_PASSWORD ?? 'user',
+  };
+}
+
+<%_ if (authenticationTypeJwt) { _%>
+// JWT token storage for authenticated API requests
+let _jwtToken: string | undefined;
+
+/**
+ * Get a JWT token for API authentication.
+ */
+export async function getAuthToken(request: APIRequestContext, username: string, password: string): Promise<string> {
+  const response = await request.post('/api/authenticate', {
+    data: { username, password },
+  });
+  const { id_token } = await response.json();
+  return id_token;
+}
+
+/**
+ * Perform authenticated API request with JWT.
+ */
+export async function authenticatedRequest(
+  request: APIRequestContext,
+  data: { method?: string; url: string; data?: unknown },
+): Promise<APIResponse> {
+  if (!_jwtToken) {
+    const creds = credentials();
+    _jwtToken = await getAuthToken(request, creds.adminUsername, creds.adminPassword);
+  }
+  return request.fetch(data.url, {
+    method: data.method ?? 'GET',
+    data: data.data,
+    headers: {
+      Authorization: `Bearer ${_jwtToken}`,
+      'Content-Type': 'application/json',
+    },
+  });
+}
+
+/**
+ * Login and set up session.
+ */
+export async function login(page: Page, request: APIRequestContext, username: string, password: string): Promise<void> {
+  const token = await getAuthToken(request, username, password);
+  _jwtToken = token;
+  await page.goto('/');
+  await page.evaluate((t) => {
+<%_ if (clientFrameworkVue) { _%>
+    sessionStorage.setItem('jhi-authenticationToken', t);
+<%_ } else { _%>
+    sessionStorage.setItem('jhi-authenticationToken', JSON.stringify(t));
+<%_ } _%>
+  }, token);
+  await page.goto('/');
+  await waitForAppShell(page);
+}
+<%_ } else if (authenticationTypeOauth2) { _%>
+/**
+ * Perform authenticated API request (OAuth2).
+ */
+export async function authenticatedRequest(
+  request: APIRequestContext,
+  data: { method?: string; url: string; data?: unknown },
+): Promise<APIResponse> {
+  return request.fetch(data.url, { method: data.method ?? 'GET', data: data.data });
+}
+
+/**
+ * Login via OAuth2 (Keycloak).
+ */
+export async function login(page: Page, request: APIRequestContext, username: string, password: string): Promise<void> {
+  await page.goto('/oauth2/authorization/oidc');
+  await page.waitForSelector('#kc-form-login', { timeout: 15000 });
+  await page.locator('#username').fill(username);
+  await page.locator('#password').fill(password);
+  await page.locator('#kc-login').click();
+  await page.waitForURL('**/', { timeout: 15000 });
+  await waitForAppShell(page);
+}
+<%_ } else { _%>
+/**
+ * Perform authenticated API request (Session).
+ */
+export async function authenticatedRequest(
+  request: APIRequestContext,
+  data: { method?: string; url: string; data?: unknown },
+): Promise<APIResponse> {
+  return request.fetch(data.url, { method: data.method ?? 'GET', data: data.data });
+}
+
+/**
+ * Login via Session auth.
+ */
+export async function login(page: Page, request: APIRequestContext, username: string, password: string): Promise<void> {
+  await request.post('/api/authentication', {
+    data: { username, password },
+    form: true,
+  });
+  await page.goto('/');
+  await waitForAppShell(page);
+}
+<%_ } _%>

package/generators/cypress/templates/src/test/javascript/cypress/support/entity.ts.ejs

@@ -0,0 +1,73 @@
+/**
+ * Playwright entity helpers
+ * Translated from Cypress entity.ts (v9)
+ *
+ * Source: ZERO EJS variables — pure static translation.
+ */
+import type { Page, Locator } from '@playwright/test';
+import * as path from 'path';
+
+// ***********************************************
+// Begin Specific Selector Attributes
+// ***********************************************
+
+// Entity
+export const entityTableSelector = '[data-cy="entityTable"]';
+export const entityCreateButtonSelector = '[data-cy="entityCreateButton"]';
+export const entityCreateSaveButtonSelector = '[data-cy="entityCreateSaveButton"]';
+export const entityCreateCancelButtonSelector = '[data-cy="entityCreateCancelButton"]';
+export const entityDetailsButtonSelector = '[data-cy="entityDetailsButton"]'; // can return multiple elements
+export const entityDetailsBackButtonSelector = '[data-cy="entityDetailsBackButton"]';
+export const entityEditButtonSelector = '[data-cy="entityEditButton"]';
+export const entityDeleteButtonSelector = '[data-cy="entityDeleteButton"]';
+export const entityConfirmDeleteButtonSelector = '[data-cy="entityConfirmDeleteButton"]';
+
+// ***********************************************
+// End Specific Selector Attributes
+// ***********************************************
+
+export function getEntityHeading(page: Page, entityName: string): Locator {
+  return page.locator(`[data-cy="${entityName}Heading"]`);
+}
+
+export function getEntityCreateUpdateHeading(page: Page, entityName: string): Locator {
+  return page.locator(`[data-cy="${entityName}CreateUpdateHeading"]`);
+}
+
+export function getEntityDetailsHeading(page: Page, entityInstanceName: string): Locator {
+  return page.locator(`[data-cy="${entityInstanceName}DetailsHeading"]`);
+}
+
+export function getEntityDeleteDialogHeading(page: Page, entityInstanceName: string): Locator {
+  return page.locator(`[data-cy="${entityInstanceName}DeleteDialogHeading"]`);
+}
+
+/**
+ * Upload a binary file to an image field.
+ * Translates Cypress's DataTransfer hack → Playwright's native setInputFiles.
+ */
+export async function setFieldImageAsBytesOfEntity(
+  page: Page,
+  fieldName: string,
+  fileName: string,
+  _mimeType: string,
+): Promise<void> {
+  const fixturePath = path.join(__dirname, '..', 'fixtures', fileName);
+  await page.locator(`[data-cy="${fieldName}"]`).setInputFiles(fixturePath);
+}
+
+/**
+ * Select the last option in a select field.
+ * Translates Cypress setFieldSelectToLastOfEntity.
+ */
+export async function setFieldSelectToLastOfEntity(page: Page, fieldName: string): Promise<void> {
+  const select = page.locator(`[data-cy="${fieldName}"]`);
+  const options = select.locator('option');
+  const count = await options.count();
+  if (count > 0) {
+    const lastOption = await options.nth(count - 1).getAttribute('value');
+    if (lastOption) {
+      await select.selectOption(lastOption);
+    }
+  }
+}