提交 c6d20bdd 编写于 作者: S Steven Almeroth

Doc: update wording for COOKIES_ENABLED

上级 6c3970e6
...@@ -158,13 +158,13 @@ more of the following methods: ...@@ -158,13 +158,13 @@ more of the following methods:
:type spider: :class:`~scrapy.spiders.Spider` object :type spider: :class:`~scrapy.spiders.Spider` object
.. method:: from_crawler(cls, crawler) .. method:: from_crawler(cls, crawler)
If present, this classmethod is called to create a middleware instance If present, this classmethod is called to create a middleware instance
from a :class:`~scrapy.crawler.Crawler`. It must return a new instance from a :class:`~scrapy.crawler.Crawler`. It must return a new instance
of the middleware. Crawler object provides access to all Scrapy core of the middleware. Crawler object provides access to all Scrapy core
components like settings and signals; it is a way for middleware to components like settings and signals; it is a way for middleware to
access them and hook its functionality into Scrapy. access them and hook its functionality into Scrapy.
:param crawler: crawler that uses this middleware :param crawler: crawler that uses this middleware
:type crawler: :class:`~scrapy.crawler.Crawler` object :type crawler: :class:`~scrapy.crawler.Crawler` object
...@@ -237,16 +237,14 @@ Default: ``True`` ...@@ -237,16 +237,14 @@ Default: ``True``
Whether to enable the cookies middleware. If disabled, no cookies will be sent Whether to enable the cookies middleware. If disabled, no cookies will be sent
to web servers. to web servers.
Notice that if the :class:`~scrapy.http.Request` Notice that despite the value of :setting:`COOKIES_ENABLED` setting if
has ``meta['dont_merge_cookies']`` evaluated to ``True``. ``Request.``:reqmeta:`meta['dont_merge_cookies'] <dont_merge_cookies>`
despite the value of :setting:`COOKIES_ENABLED` the cookies will **not** be evaluates to ``True`` the request cookies will **not** be sent to the
sent to web servers and received cookies in web server and received cookies in :class:`~scrapy.http.Response` will
:class:`~scrapy.http.Response` will **not** be merged with the existing **not** be merged with the existing cookies.
cookies.
For more detailed information see the ``cookies`` parameter in
:class:`~scrapy.http.Request`
For more detailed information see the ``cookies`` parameter in
:class:`~scrapy.http.Request`.
.. setting:: COOKIES_DEBUG .. setting:: COOKIES_DEBUG
......
...@@ -80,6 +80,8 @@ Request objects ...@@ -80,6 +80,8 @@ Request objects
attributes of the cookie. This is only useful if the cookies are saved attributes of the cookie. This is only useful if the cookies are saved
for later requests. for later requests.
.. reqmeta:: dont_merge_cookies
When some site returns cookies (in a response) those are stored in the When some site returns cookies (in a response) those are stored in the
cookies for that domain and will be sent again in future requests. That's cookies for that domain and will be sent again in future requests. That's
the typical behaviour of any regular web browser. However, if, for some the typical behaviour of any regular web browser. However, if, for some
...@@ -294,7 +296,7 @@ Those are: ...@@ -294,7 +296,7 @@ Those are:
* :reqmeta:`dont_retry` * :reqmeta:`dont_retry`
* :reqmeta:`handle_httpstatus_list` * :reqmeta:`handle_httpstatus_list`
* :reqmeta:`handle_httpstatus_all` * :reqmeta:`handle_httpstatus_all`
* ``dont_merge_cookies`` (see ``cookies`` parameter of :class:`Request` constructor) * :reqmeta:`dont_merge_cookies`
* :reqmeta:`cookiejar` * :reqmeta:`cookiejar`
* :reqmeta:`dont_cache` * :reqmeta:`dont_cache`
* :reqmeta:`redirect_urls` * :reqmeta:`redirect_urls`
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册