Django4.0 进阶测试主题-请求工厂
class RequestFactory
RequestFactory
与测试客户端共享相同的 API。 但是,RequestFactory
不能像浏览器那样运行,而是提供一种生成请求实例的方法,该实例可用作任何视图的第一个参数。 这意味着您可以像测试任何其他功能一样测试视图函数——就像一个黑匣子一样,具有确切已知的输入,可以测试特定的输出。
RequestFactory
的 API 是测试客户端 API 的一个稍加限制的子集。
- 它只能访问 HTTP 的
get()
、post()
、put()
、delete()
、head()
、options()
和 trace()
方法。 - 这些方法接受所有相同的参数,除了
follow
。因为这只是一个产生请求的工厂,所以由你来处理响应。 - 它不支持中间件。如果需要视图正常运行,会话和认证属性必须由测试本身提供。
例如
下面是一个使用请求工厂的单元测试:
from django.contrib.auth.models import AnonymousUser, User
from django.test import RequestFactory, TestCase
from .views import MyView, my_view
class SimpleTest(TestCase):
def setUp(self):
# Every test needs access to the request factory.
self.factory = RequestFactory()
self.user = User.objects.create_user(
username='jacob', email='jacob@…', password='top_secret')
def test_details(self):
# Create an instance of a GET request.
request = self.factory.get('/customer/details')
# Recall that middleware are not supported. You can simulate a
# logged-in user by setting request.user manually.
request.user = self.user
# Or you can simulate an anonymous user by setting request.user to
# an AnonymousUser instance.
request.user = AnonymousUser()
# Test my_view() as if it were deployed at /customer/details
response = my_view(request)
# Use this syntax for class-based views.
response = MyView.as_view()(request)
self.assertEqual(response.status_code, 200)
AsyncRequestFactory
RequestFactory
创建 WSGI
类的请求。如果你想创建 ASGI
类的请求,包括有一个正确的 ASGI scope
,你可以使用 django.test.AsyncRequestFactory
。
该类与 RequestFactory
直接 API 兼容,唯一的区别是它返回 ASGIRequest
实例,而不是 WSGIRequest
实例。它的所有方法仍然是可同步调用的。