Mirrors/servo
1
0
Fork 0
mirror of https://github.com/servo/servo.git synced 2025-08-06 14:10:11 +01:00
Code Issues Projects Releases Packages Wiki Activity

Update web-platform-tests to revision 66dc9c93f2c8ebd7c8fdc28fae20d92713c97806

Browse source
This commit is contained in:
WPT Sync Bot 2019-06-26 10:22:48 +00:00
parent e488ea750b
commit 12f4ae132e
1651 changed files with 8123 additions and 14152 deletions
Download patch file Download diff file Expand all files Collapse all files

58
tests/wpt/web-platform-tests/docs/writing-tests/python-handlers/index.md
View file

@ -6,10 +6,29 @@ requests made to the corresponding URL. This is hooked up to a route like
treated as a handler file (note that this makes it easy to write unsafe
handlers, particularly when running the server in a web-exposed setting).
The Python files must define a single function `main` with the signature::
The Python files must define a function named `main` with the signature:
main(request, response)
...where `request` is [a wptserve `Request`
object](/tools/wptserve/docs/request) and `response` is [a wptserve `Response`
object](/tools/wptserve/docs/response).
This function must return a value in one of the following four formats:
((status_code, reason), headers, content)
(status_code, headers, content)
(headers, content)
content
Above, `headers` is a list of (field name, value) pairs, and `content` is a
string or an iterable returning strings. The `main` function may also update
the response manually. For example, one may use `response.headers.set` to set a
response header, and only return the content. One may even use this kind of
handler, but manipulate the output socket directly, in which case the return
value of the function, and the properties of the response object, will be
ignored.
The wptserver implements a number of Python APIs for controlling traffic.
```eval_rst
@ -20,3 +39,40 @@ The wptserver implements a number of Python APIs for controlling traffic.
/tools/wptserve/docs/response
/tools/wptserve/docs/stash
```
## Example: Dynamic HTTP headers
The following code defines a Python handler that allows the requester to
control the value of the `Content-Type` HTTP response header:
```python
def main(request, response):
content_type = request.GET.first('content-type')
headers = [('Content-Type', content_type)]
return (200, 'my status text'), headers, 'my response content'
```
If saved to a file named `resources/control-content-type.py`, the WPT server
will respond to requests for `resources/control-content-type.py` by executing
that code.
This could be used from a [testharness.js test](../testharness) like so:
```html
<!DOCTYPE html>
<meta charset="utf-8">
<title>Demonstrating the WPT server's Python handler feature</title>
<script src="/resources/testharness.js"></script>
<script src="/resources/testharnessreport.js"></script>
<script>
promise_test(function() {
return fetch('resources/control-content-type.py?content-type=text/foobar')
.then(function(response) {
assert_equals(response.status, 200);
assert_equals(response.statusText, 'my status text');
assert_equals(response.headers.get('Content-Type'), 'text/foobar');
});
});
</script>
```