Skip to content

Scrapy, a fast high-level web crawling & scraping framework for Python.

Clarify that Scrapy sets Failure.request (#7901)

Adrian3b58ddbdbe03
diff --git a/docs/topics/request-response.rst b/docs/topics/request-response.rst
index 9a39212fb..0f4422d14 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.