test: Migrate basic folder tests to Playwright

packages/testing/playwright/composables/TestEntryComposer.ts

@@ -35,7 +35,7 @@ export class TestEntryComposer {
 		await this.n8n.api.setMaxTeamProjectsQuota(-1);
 
 		// Create a project using the API
-		const response = await this.n8n.api.projectApi.createProject();
+		const response = await this.n8n.api.projects.createProject();
 
 		const projectId = response.id;
 		await this.n8n.page.goto(`workflow/new?projectId=${projectId}`);
@@ -44,13 +44,9 @@ export class TestEntryComposer {
 	}
 
 	async fromNewProject() {
-		// Enable features to allow us to create a new project
-		await this.n8n.api.enableFeature('projectRole:admin');
-		await this.n8n.api.enableFeature('projectRole:editor');
-		await this.n8n.api.setMaxTeamProjectsQuota(-1);
-
+		await this.withProjectFeatures();
 		// Create a project using the API
-		const response = await this.n8n.api.projectApi.createProject();
+		const response = await this.n8n.api.projects.createProject();
 
 		const projectId = response.id;
 		await this.n8n.navigate.toProject(projectId);
@@ -66,4 +62,17 @@ export class TestEntryComposer {
 		await this.n8n.page.goto(`workflow/${workflowImportResult.workflowId}`);
 		return workflowImportResult;
 	}
+
+	/**
+	 * Enable project feature set
+	 * Allow project creation, sharing, and folder creation
+	 */
+	async withProjectFeatures() {
+		await this.n8n.api.enableFeature('sharing');
+		await this.n8n.api.enableFeature('folders');
+		await this.n8n.api.enableFeature('advancedPermissions');
+		await this.n8n.api.enableFeature('projectRole:admin');
+		await this.n8n.api.enableFeature('projectRole:editor');
+		await this.n8n.api.setMaxTeamProjectsQuota(-1);
+	}
 }

packages/testing/playwright/helpers/NavigationHelper.ts

@@ -119,6 +119,17 @@ export class NavigationHelper {
 		await this.page.goto(url);
 	}
 
+	/**
+	 * Navigate to a specific folder
+	 * URL: /projects/{projectId}/folders/{folderId}
+	 */
+	async toFolder(folderId: string, projectId?: string): Promise<void> {
+		const url = projectId
+			? `/projects/${projectId}/folders/${folderId}/workflows`
+			: `/folders/${folderId}/workflows`;
+		await this.page.goto(url);
+	}
+
 	/**
 	 * Navigate to workflow canvas (alias for toWorkflow)
 	 */

packages/testing/playwright/pages/BasePage.ts

@@ -1,6 +1,9 @@
 import type { Page } from '@playwright/test';
 
+import { BaseModal } from './components/BaseModal';
+
 export abstract class BasePage {
+	protected readonly baseModal = new BaseModal(this.page);
 	constructor(protected readonly page: Page) {}
 
 	protected async clickByTestId(testId: string) {

packages/testing/playwright/pages/WorkflowsPage.ts

@@ -75,7 +75,7 @@ export class WorkflowsPage extends BasePage {
 		await this.page.getByRole('button', { name: 'delete' }).click();
 	}
 
-	async searchWorkflows(searchTerm: string) {
+	async search(searchTerm: string) {
 		await this.clickByTestId('resources-list-search');
 		await this.fillByTestId('resources-list-search', searchTerm);
 	}
@@ -154,4 +154,42 @@ export class WorkflowsPage extends BasePage {
 	async filterByTag(tag: string) {
 		await this.filterByTags([tag]);
 	}
+
+	getFolderBreadcrumbsActions() {
+		return this.page.getByTestId('folder-breadcrumbs-actions');
+	}
+
+	getFolderBreadcrumbsActionToggle() {
+		return this.page.getByTestId('action-toggle-dropdown');
+	}
+
+	getFolderBreadcrumbsAction(actionName: string) {
+		return this.getFolderBreadcrumbsActionToggle().getByTestId(`action-${actionName}`);
+	}
+
+	addFolderButton() {
+		return this.page.getByTestId('add-folder-button');
+	}
+
+	// Add region for actions
+
+	/**
+	 * Add a folder from the add resource dropdown
+	 * @returns The name of the folder
+	 */
+	async addFolder() {
+		const folderName = 'My Test Folder';
+		await this.addResource.folder();
+		await this.fillFolderModal(folderName);
+		return folderName;
+	}
+
+	/**
+	 * Fill the folder modal
+	 * @param folderName - The name of the folder
+	 */
+	async fillFolderModal(folderName: string) {
+		await this.baseModal.fillInput(folderName);
+		await this.baseModal.clickButton('Create');
+	}
 }

packages/testing/playwright/services/api-helper.ts

@@ -36,14 +36,14 @@ const DB_TAGS = {
 export class ApiHelpers {
 	request: APIRequestContext;
 	workflowApi: WorkflowApiHelper;
-	projectApi: ProjectApiHelper;
+	projects: ProjectApiHelper;
 	credentialApi: CredentialApiHelper;
 	variablesApi: VariablesApiHelper;
 
 	constructor(requestContext: APIRequestContext) {
 		this.request = requestContext;
 		this.workflowApi = new WorkflowApiHelper(this);
-		this.projectApi = new ProjectApiHelper(this);
+		this.projects = new ProjectApiHelper(this);
 		this.credentialApi = new CredentialApiHelper(this);
 		this.variablesApi = new VariablesApiHelper(this);
 	}

packages/testing/playwright/services/project-api-helper.ts

@@ -1,4 +1,5 @@
 import { nanoid } from 'nanoid';
+import type { Folder } from '@n8n/db';
 
 import type { ApiHelpers } from './api-helper';
 import { TestError } from '../Types';
@@ -42,4 +43,142 @@ export class ProjectApiHelper {
 
 		return true;
 	}
+
+	/**
+	 * Create a new folder in a project
+	 * @param projectId The ID of the project to create the folder in
+	 * @param folderName The name of the folder to create
+	 * @param parentFolderId Optional parent folder ID for nested folders
+	 * @returns The created folder data
+	 */
+	async createFolder(
+		projectId: string,
+		folderName?: string,
+		parentFolderId?: string,
+	): Promise<Folder> {
+		const uniqueName = folderName ? `${folderName} (${nanoid(8)})` : `Test Folder ${nanoid(8)}`;
+
+		const response = await this.api.request.post(`/rest/projects/${projectId}/folders`, {
+			data: {
+				name: uniqueName,
+				...(parentFolderId && { parentFolderId }),
+			},
+		});
+
+		if (!response.ok()) {
+			throw new TestError(`Failed to create folder: ${await response.text()}`);
+		}
+
+		const result = await response.json();
+		return result.data ?? result;
+	}
+
+	/**
+	 * Update a folder
+	 * @param projectId The ID of the project containing the folder
+	 * @param folderId The ID of the folder to update
+	 * @param updates Object containing folder updates (name, parentFolderId, tagIds)
+	 * @returns True if update was successful
+	 */
+	async updateFolder(
+		projectId: string,
+		folderId: string,
+		updates: { name?: string; parentFolderId?: string; tagIds?: string[] },
+	): Promise<boolean> {
+		const response = await this.api.request.patch(
+			`/rest/projects/${projectId}/folders/${folderId}`,
+			{
+				data: updates,
+			},
+		);
+
+		if (!response.ok()) {
+			throw new TestError(`Failed to update folder: ${await response.text()}`);
+		}
+
+		return true;
+	}
+
+	/**
+	 * Delete a folder
+	 * @param projectId The ID of the project containing the folder
+	 * @param folderId The ID of the folder to delete
+	 * @param deleteWorkflows Whether to delete workflows in the folder (default: false)
+	 * @returns True if deletion was successful
+	 */
+	async deleteFolder(
+		projectId: string,
+		folderId: string,
+		deleteWorkflows: boolean = false,
+	): Promise<boolean> {
+		const response = await this.api.request.delete(
+			`/rest/projects/${projectId}/folders/${folderId}?deleteWorkflows=${deleteWorkflows}`,
+		);
+
+		if (!response.ok()) {
+			throw new TestError(`Failed to delete folder: ${await response.text()}`);
+		}
+
+		return true;
+	}
+
+	/**
+	 * Get folder tree for a specific folder
+	 * @param projectId The ID of the project
+	 * @param folderId The ID of the folder to get the tree for
+	 * @returns The folder tree data
+	 */
+	async getFolderTree(projectId: string, folderId: string) {
+		const response = await this.api.request.get(
+			`/rest/projects/${projectId}/folders/${folderId}/tree`,
+		);
+
+		if (!response.ok()) {
+			throw new TestError(`Failed to get folder tree: ${await response.text()}`);
+		}
+
+		const result = await response.json();
+		return result.data ?? result;
+	}
+
+	/**
+	 * List folders in a project
+	 * @param projectId The ID of the project
+	 * @param filters Optional filters for the folder list
+	 * @returns The folder list data
+	 */
+	async listFolders(projectId: string, filters?: { search?: string; parentFolderId?: string }) {
+		const queryParams = new URLSearchParams();
+		if (filters?.search) queryParams.append('search', filters.search);
+		if (filters?.parentFolderId) queryParams.append('parentFolderId', filters.parentFolderId);
+
+		const url = `/rest/projects/${projectId}/folders${queryParams.toString() ? `?${queryParams}` : ''}`;
+		const response = await this.api.request.get(url);
+
+		if (!response.ok()) {
+			throw new TestError(`Failed to list folders: ${await response.text()}`);
+		}
+
+		const result = await response.json();
+		return result.data ?? result;
+	}
+
+	/**
+	 * Get folder content (counts of sub-folders and workflows)
+	 * @param projectId The ID of the project
+	 * @param folderId The ID of the folder
+	 * @returns Folder content counts
+	 */
+	async getFolderContent(projectId: string, folderId: string) {
+		const response = await this.api.request.get(
+			`/rest/projects/${projectId}/folders/${folderId}/content`,
+		);
+
+		if (!response.ok()) {
+			throw new TestError(`Failed to get folder content: ${await response.text()}`);
+		}
+
+		const result = await response.json();
+		return result.data ?? result;
+	}
 }

packages/testing/playwright/tests/ui/1-workflows.spec.ts

@@ -51,17 +51,17 @@ test.describe('Workflows', () => {
 		await n8n.goHome();
 
 		// Search for specific workflow
-		await n8n.workflows.searchWorkflows(specificName);
+		await n8n.workflows.search(specificName);
 		await expect(n8n.workflows.cards.getWorkflow(specificName)).toBeVisible();
 
 		// Search with partial term
 		await n8n.workflows.clearSearch();
-		await n8n.workflows.searchWorkflows(uniqueId);
+		await n8n.workflows.search(uniqueId);
 		await expect(n8n.workflows.cards.getWorkflows()).toHaveCount(2);
 
 		// Search for non-existent
 		await n8n.workflows.clearSearch();
-		await n8n.workflows.searchWorkflows('NonExistentWorkflow123');
+		await n8n.workflows.search('NonExistentWorkflow123');
 		await expect(n8n.workflows.cards.getWorkflows()).toHaveCount(0);
 		await expect(n8n.page.getByText('No workflows found')).toBeVisible();
 	});
@@ -135,7 +135,7 @@ test.describe('Workflows', () => {
 		const tags = await n8n.canvas.addTags(2);
 
 		await n8n.goHome();
-		await n8n.workflows.searchWorkflows('Tagged');
+		await n8n.workflows.search('Tagged');
 		await n8n.workflows.filterByTag(tags[0]);
 
 		await expect(n8n.page).toHaveURL(/search=Tagged/);