summaryrefslogtreecommitdiff
path: root/docs/ref
diff options
context:
space:
mode:
Diffstat (limited to 'docs/ref')
-rw-r--r--docs/ref/request-response.txt14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/ref/request-response.txt b/docs/ref/request-response.txt
index 9b0ed76e4d..9b71adfdf9 100644
--- a/docs/ref/request-response.txt
+++ b/docs/ref/request-response.txt
@@ -281,9 +281,23 @@ middleware class is listed in :setting:`MIDDLEWARE`.
else:
... # Do something for anonymous users.
+ The :meth:`auser` method does the same thing but can be used from async
+ contexts.
+
Methods
-------
+.. method:: HttpRequest.auser()
+
+ .. versionadded:: 5.0
+
+ From the :class:`~django.contrib.auth.middleware.AuthenticationMiddleware`:
+ Coroutine. Returns an instance of :setting:`AUTH_USER_MODEL` representing
+ the currently logged-in user. If the user isn't currently logged in,
+ ``auser`` will return an instance of
+ :class:`~django.contrib.auth.models.AnonymousUser`. This is similar to the
+ :attr:`user` attribute but it works in async contexts.
+
.. method:: HttpRequest.get_host()
Returns the originating host of the request using information from the