diff --git a/docs/topics/request-response.rst b/docs/topics/request-response.rst index 1d97e39b6..f0f34e829 100644 --- a/docs/topics/request-response.rst +++ b/docs/topics/request-response.rst @@ -713,11 +713,15 @@ Errbacks ======== The errback of a request is a function that will be called when an exception -is raise while processing it. +is raised while processing it. It receives a :exc:`~twisted.python.failure.Failure` as first parameter and can be used to track connection establishment timeouts, DNS errors etc. +Scrapy sets the ``request`` attribute of that +:exc:`~twisted.python.failure.Failure` object to the :class:`~scrapy.Request` +object being processed. + If an errback raises an exception, Scrapy logs it and sends the :signal:`spider_error` signal, unless the exception is the one that the errback received, which Scrapy logs as a download error instead.