跳到主要内容

🛩️ 页面设置


本节介绍SessionPage运行参数设置。

这些设置是全局参数,设置后每次请求都会使用它们。

示例:

from DrissionPage import SessionPage

page = SessionPage()
page.set.cookies([{'name': 'a', 'value': '1'}, {'name': 'b', 'value': '2'}])

✅️️ set.retry_times()

此方法用于设置连接失败时重连次数。

参数名称类型默认值说明
timesint必填次数

返回:None

✅️️ set.retry_interval()

此方法用于设置连接失败时重连间隔。

参数名称类型默认值说明
intervalfloat必填秒数

返回:None

✅️️ set.timeout()

此方法用于设置连接超时时间(秒)。

参数名称类型默认值说明
secondfloat必填秒数

返回:None

示例:

page.set.timeout(20)

✅️️ set.encoding()

此方法用于设置网页编码。

默认情况下,程序会自动从 headers、页面上获取编码,但总有些奇葩网页的编码不准确。这时候可以主动设置编码。

可以针对已获取的Rsponse对象设置,或作为整体设置对之后的连接都有效。

参数名称类型默认值说明
encodingstr必填编码名称,如果要取消之前的设置,传入None
set_allboolTrue是否设置对象参数,为False则只设置当前Response对象

返回:None


✅️️ set.cookies()

此方法用于设置一个或多个 cookie。

设置一个 cookie 支持的格式:

  • Cookie:单个Cookie对象
  • str'name=value; domain=****; ...''name=****; value=****; domain=****; ...'格式,只支持用';'分隔
  • dict{'name': '****', 'value': '****', 'domain': '****', ...}{name: value, 'domain': '****', ...}格式

设置多个 cookie 支持的格式:

  • listtuple:上面几种形式的单个 cookie 放到列表中传入即可
  • dict{name1: value1, name2: value2, ..., 'domain': '****', ...}格式
  • str'name1=value1; name2=value2; ... domain=****; ...'格式,多个 cookie 之间只能用';'分隔
  • CookieJar:单个CookieJar对象
参数名称类型默认值说明
cookiesCookie
CookieJar
list
tuple
str
dict
必填cookies 信息

返回:None


✅️️ set.cookies.clear()

此方法用于清除所有 cookie。

参数:

返回:None


✅️️ set.cookies.remove()

此方法用于删除一个 cookie。

参数名称类型默认值说明
namestr必填cookie 的 name 字段

返回:None


✅️️ set.headers()

此方法用于设置 headers,会取代已有 headers。

headers 可以是dict格式的,也可以是文本格式。

文本格式不同字段用\n分隔,字段 key 和 value 用': '分隔,即从浏览器直接复制的格式。

参数名称类型默认值说明
headersdict
str
必填headers 信息

返回:None


✅️️ set.header()

此方法用于设置 headers 中一个项。

参数名称类型默认值说明
namestr必填设置名称
valuestr必填设置值

返回:None


✅️️ set.user_agent()

此方法用于设置 user_agent。

参数名称类型默认值说明
uastr必填user_agent 信息

返回:None


✅️️ set.proxies()

此方法用于设置代理 ip。

参数名称类型默认值说明
httpstr必填http代理地址
httpsstrNonehttps代理地址,为None时使用http的值

返回:None


✅️️ set.auth()

此方法用于设置认证元组或对象。

参数名称类型默认值说明
authTuple[str, str]
HTTPBasicAuth
必填认证元组或对象

返回:None


✅️️ set.hooks()

此方法用于设置回调方法。

参数名称类型默认值说明
hooksdict必填回调方法

返回:None


✅️️ set.params()

此方法用于设置查询参数字典。

参数名称类型默认值说明
paramsdict必填查询参数字典

返回:None


✅️️ set.verify()

此方法用于设置是否验证SSL证书。

参数名称类型默认值说明
on_offbool必填bool表示开或关

返回:None


✅️️ set.cert()

此方法用于设置SSL客户端证书。

参数名称类型默认值说明
certstr
Tuple[str, str]
必填SSL客户端证书文件的路径(.pem格式),或(‘cert’, ‘key’)元组

返回:None


✅️️ set.stream()

此方法用于设置是否使用流式响应内容。

参数名称类型默认值说明
on_offbool必填bool表示开或关

返回:None


✅️️ set.trust_env()

此方法用于设置是否信任环境。

参数名称类型默认值说明
on_offbool必填bool表示开或关

返回:None


✅️️ set.max_redirects()

此方法用于设置连接最大重定向次数。

参数名称类型默认值说明
``timesint必填最大重定向次数

返回:None


✅️️ set.add_adapter()

此方法用于添加适配器。

参数名称类型默认值说明
urlstr必填适配器对应url
adapterHTTPAdapter必填适配器对象

返回:None


✅️️ close()

此方法用于关闭连接。

参数:

返回:None