Complete docs, fix tests

Author: chomnoue

framework-docs/modules/ROOT/nav.adoc

@@ -382,6 +382,8 @@
 **** xref:testing/mockmvc/htmlunit/webdriver.adoc[]
 **** xref:testing/mockmvc/htmlunit/geb.adoc[]
 *** xref:testing/mockmvc/playwright.adoc[]
+**** xref:testing/mockmvc/playwright/setup.adoc[]
+**** xref:testing/mockmvc/playwright/testing.adoc[]
 *** xref:testing/mockmvc/vs-end-to-end-integration-tests.adoc[]
 *** xref:testing/mockmvc/resources.adoc[]
 ** xref:testing/spring-mvc-test-client.adoc[]

framework-docs/modules/ROOT/pages/testing/mockmvc/playwright.adoc

@@ -1,4 +1,4 @@
-[[mockmvc-server-playwright]]
+[[playwright]]
 = Playwright Integration
 :page-section-summary-toc: 1
 
@@ -7,19 +7,3 @@ https://playwright.dev/[Playwright] via `MockMvcPlaywrightHandler`.
 This allows browser-style end-to-end testing against your MVC controllers without
 starting a server.
 
-== Setup
-
-First, make sure that you have included a test dependency on `com.microsoft.playwright:playwright`.
-To use it, create a`MockMvcPlaywrightHandler` instance and register it as a
-route https://playwright.dev/java/docs/network#handle-requests[handler] for http requests.
-
-include-code::./MockMvcPlaywrightHandlerTests[tag=init,indent=0]
-
-include-code::./MockMvcPlaywrightHandlerTests[tag=setup,indent=0]
-
-Browser http requests, such as form submission and file uploads, are then translated
-to MockMvc requests.
-
-Don't forget to close playwright resources after your tests
-
-include-code::./MockMvcPlaywrightHandlerTests[tag=close,indent=0]

framework-docs/modules/ROOT/pages/testing/mockmvc/playwright/setup.adoc

@@ -0,0 +1,17 @@
+[[mockmvc-playwright-setup]]
+= Playwright Setup
+
+To integrate playwright with MockMvc, first make sure that you have included a test dependency on `com.microsoft.playwright:playwright`.
+To use it, create a `MockMvcPlaywrightHandler` instance and register it as a
+route https://playwright.dev/java/docs/network#handle-requests[handler] for http requests.
+
+include-code::./MockMvcPlaywrightHandlerTests[tag=init,indent=0]
+
+include-code::./MockMvcPlaywrightHandlerTests[tag=setup,indent=0]
+
+Browser http requests, such as form submission and file uploads, are then translated
+to MockMvc requests.
+
+Remember to close playwright resources after your tests
+
+include-code::./MockMvcPlaywrightHandlerTests[tag=close,indent=0]

framework-docs/modules/ROOT/pages/testing/mockmvc/playwright/testing.adoc

@@ -0,0 +1,58 @@
+[[mockmvc-playwright-testing]]
+= Testing Fullstack Web Applications with Playwright and Mockmvc
+
+With Playwright and Mockmvc in place, you can simulate user interactions with the browser
+and assert the expected changes without mocking the API calls. The following examples cover simple form
+submission and file upload.
+
+NOTE: We use `com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat` for assertions.
+
+[[mockmvc-playwright-testing-get]]
+== Simple GET form
+
+Having an HTML page with a GET form
+
+[source,html]
+----
+<form id="getForm" data-testid="getForm" method="get" action="/search">
+        <label for="query">Search Query:</label>
+        <input type="text" id="query" name="query" required>
+        <button type="submit">Submit GET</button>
+</form>
+<div id="getResult"></div>
+<script>
+...
+// Event listener to submit the form and display results in `getResult`
+</script>
+----
+
+And the following controller to handle the `/search` request
+
+include-code::./MockMvcPlaywrightHandlerTests[tag=controller,indent=0]
+
+Playwright can be used to submit the form and assert results are displayed
+
+include-code::./MockMvcPlaywrightHandlerTests[tag=test,indent=0]
+
+[[mockmvc-playwright-testing-file-upload]]
+== File Upload
+
+You can test a file upload with playwright and assert that it is properly handled by your controllers.
+For example, the following form uploads a file.
+
+[source,html]
+----
+<form id="singleFileForm" data-testid="singleFileForm" method="post" action="/upload-single" enctype="multipart/form-data">
+        <label for="singleFile">Choose File:</label>
+        <input type="file" id="singleFile" name="file" required>
+        <button type="submit">Upload Single File</button>
+</form>
+----
+
+Assuming that the following controller handles the POST `/upload-single` request
+
+include-code::./MockMvcPlaywrightHandlerTests[tag=controller,indent=0]
+
+Playwright can be used to send the file and assert results are displayed
+
+include-code::./MockMvcPlaywrightHandlerTests[tag=test,indent=0]

framework-docs/src/main/java/org/springframework/docs/testing/mockmvc/mockmvcserverplaywright/MockMvcPlaywrightHandlerTests.java

@@ -0,0 +1,72 @@
+/*
+ * Copyright 2002-present the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.springframework.docs.testing.mockmvc.playwright.mockmvcplaywrightsetup;
+
+import com.microsoft.playwright.Browser;
+import com.microsoft.playwright.Page;
+import com.microsoft.playwright.Playwright;
+import org.junit.jupiter.api.*;
+import org.springframework.test.context.junit.jupiter.web.SpringJUnitWebConfig;
+import org.springframework.test.web.servlet.playwright.MockMvcPlaywrightHandler;
+import org.springframework.test.web.servlet.setup.MockMvcBuilders;
+import org.springframework.web.context.WebApplicationContext;
+
+@SpringJUnitWebConfig
+public class MockMvcPlaywrightHandlerTests {
+
+	private static Playwright playwright;
+	private static Browser browser;
+	private Page page;
+
+	private final MockMvcPlaywrightHandler handler;
+	// tag::init[]
+	public MockMvcPlaywrightHandlerTests(WebApplicationContext wac) {
+		var mockMvc = MockMvcBuilders.webAppContextSetup(wac).build();
+		this.handler = MockMvcPlaywrightHandler.builder(mockMvc).build();
+	}
+	// end::init[]
+
+	// tag::setup[]
+	@BeforeAll
+	static void initPlaywright() {
+		playwright = Playwright.create();
+		browser = playwright.chromium().launch();
+	}
+	@BeforeEach
+	public void initPage() {
+		page = browser.newPage();
+		page.setDefaultTimeout(500);
+		page.route(url -> url.startsWith("http://localhost"), handler);
+		page.navigate("http://localhost/index.html");
+	}
+
+	// end::setup[]
+	// tag::close[]
+
+	@AfterEach
+	public void closePage() {
+		page.close();
+	}
+	@AfterAll
+	static void closePlaywright() {
+		browser.close();
+		playwright.close();
+	}
+
+	// end::close[]
+
+}