Changes:

- fix tests
- add warning/explaination

docs/en/docs/extras/forms.md

@@ -77,6 +77,13 @@ dataclasses.
 {!> ../../../docs_src/extras/form/model.py !}
 ```
 
+## Using form as non-data, non-payload field
+
+When using Form as a non-data, non-payload field, the form receives only the data which matches the field-name.
+
+If you use form-data requests make sure the field content is valid json.
+When you use json requests only the portion which matches the field-name is passed through the model wrapped by the form.
+
 ## Notes
 
 As you could see from the examples, it is very simple and direct to use the `Form` in Esmerald and

tests/forms/test_forms_route.py

@@ -1,3 +1,4 @@
+import json
 from typing import Optional, Union
 
 import pytest
@@ -29,7 +30,7 @@ async def start(request: Request, form: Union[Model, None] = Form()) -> bytes:
     response = client.get("/")
     assert response.status_code == 200
 
-    response = client.post("/", data={"id": "733"})
+    response = client.post("/", data={"form": json.dumps({"id": "733"})})
     assert response.status_code == 200
 
 

tests/test_direct_responses.py

@@ -1,3 +1,4 @@
+import json
 from typing import Optional
 
 from pydantic import BaseModel
@@ -64,7 +65,7 @@ async def start(request: Request, form: Optional[Model] = Form()) -> Template:
     response = client.get("/", follow_redirects=False)
     assert response.status_code == 301
 
-    response = client.post("/", data={"id": 55}, follow_redirects=False)
+    response = client.post("/", data={"form": json.dumps({"id": 55})}, follow_redirects=False)
     assert response.status_code == 301