urllib.error — urllib.request 引发的异常类

源代码: Lib/urllib/error.py

---

urllib.error 模块定义了由 urllib.request 引发的异常的异常类。基本异常类是 URLError。

以下异常由 urllib.error 在适当的时候引发

exception urllib.error.URLError

当处理程序遇到问题时，会引发此异常（或派生异常）。它是 OSError 的子类。

reason

此错误的原因。它可以是消息字符串或其他异常实例。

在 3.3 版本中变更: URLError 曾经是 IOError 的子类型，现在是 OSError 的别名。

exception urllib.error.HTTPError(url, code, msg, hdrs, fp)

尽管是异常（URLError 的子类），HTTPError 也可以用作非异常的类文件返回值（与 urlopen() 返回的结果相同）。这在处理特殊的 HTTP 错误（例如身份验证请求）时很有用。

url

包含请求的 URL。filename 属性的别名。

code

RFC 2616 中定义的 HTTP 状态代码。此数值对应于 http.server.BaseHTTPRequestHandler.responses 中代码字典中的值。

reason

这通常是一个解释此错误原因的字符串。msg 属性的别名。

headers

导致 HTTPError 的 HTTP 请求的 HTTP 响应标头。hdrs 属性的别名。

3.4 版本新增。

fp

一个类文件对象，可以从中读取 HTTP 错误正文。

exception urllib.error.ContentTooShortError(msg, content)

当 urlretrieve() 函数检测到下载的数据量少于预期量（由 Content-Length 标头给出）时，会引发此异常。

content

下载的（并且据推测被截断的）数据。