feature #1832 [LiveComponent] add support for testing file uploads in actions (daFish)

This PR was merged into the 2.x branch.

Discussion
----------

[LiveComponent] add support for testing file uploads in actions

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes
| Issues        | Fix #... <!-- prefix each issue number with "Fix #", no need to create an issue if none exist, explain below instead -->
| License       | MIT

Commits
-------

cfa1e6f feat: add support for testing file uploads in actions

Author: kbond

src/LiveComponent/CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## 2.18.0
+
+-   Add parameter to `TestLiveComponent::call()` to add files to the request
+
 ## 2.17.0
 
 -   Add `modifier` option in `LiveProp` so options can be modified at runtime.

src/LiveComponent/doc/index.rst

@@ -3657,6 +3657,10 @@ uses Symfony's test client to render and make requests to your components::
 
             $this->assertStringContainsString('Count: 3', $testComponent->render());
 
+            // call live action with file uploads
+            $testComponent
+                ->save('processUpload', files: ['file' => new UploadedFile(...)]);
+
             // emit live events
             $testComponent
                 ->emit('increaseEvent')

src/LiveComponent/src/Test/TestLiveComponent.php

@@ -12,6 +12,7 @@
 namespace Symfony\UX\LiveComponent\Test;
 
 use Symfony\Bundle\FrameworkBundle\KernelBrowser;
+use Symfony\Component\HttpFoundation\File\UploadedFile;
 use Symfony\Component\HttpFoundation\Response;
 use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 use Symfony\Component\Security\Core\User\UserInterface;
@@ -76,11 +77,12 @@ public function actingAs(object $user, string $firewallContext = 'main'): self
     }
 
     /**
-     * @param array<string,mixed> $arguments
+     * @param array<string,mixed>         $arguments
+     * @param array<string, UploadedFile> $files
      */
-    public function call(string $action, array $arguments = []): self
+    public function call(string $action, array $arguments = [], array $files = []): self
     {
-        return $this->request(['args' => $arguments], $action);
+        return $this->request(['args' => $arguments], $action, $files);
     }
 
     /**
@@ -123,7 +125,7 @@ public function response(): Response
         return $this->client()->getResponse();
     }
 
-    private function request(array $content = [], ?string $action = null): self
+    private function request(array $content = [], ?string $action = null, array $files = []): self
     {
         $csrfToken = $this->csrfToken();
 
@@ -137,6 +139,7 @@ private function request(array $content = [], ?string $action = null): self
                 ])
             ),
             parameters: ['data' => json_encode(array_merge($content, ['props' => $this->props()]))],
+            files: $files,
             server: $csrfToken ? ['HTTP_X_CSRF_TOKEN' => $csrfToken] : [],
         );