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 的子类型，而 IOError 现在是 OSError 的别名。

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

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

url

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

code

一个 HTTP 状态码，如 RFC 2616 中所定义。此数值对应于 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

已下载的（并假定已截断的）数据。