Skip to main content

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

源代码: Lib/urllib/error.py


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

urllib.error 酌情提出以下例外:

exception urllib.error.URLError

处理程序在遇到问题时引发此异常(或派生异常)。它是 OSError 的子类。

reason

这个错误的原因。它可以是消息字符串或另一个异常实例。

在 3.3 版更改: URLError 已经成为 OSError 的亚类而不是 IOError

exception urllib.error.HTTPError

虽然作为一个例外(URLError 的子类),HTTPError 也可以作为一个非特殊的类文件返回值(urlopen() 返回的同样的东西)。这在处理异常HTTP错误(例如认证请求)时非常有用。

code

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

reason

这通常是解释此错误的原因的字符串。

headers

导致 HTTPError 的HTTP请求的HTTP响应标头。

3.4 新版功能.

exception urllib.error.ContentTooShortError(msg, content)

urlretrieve() 功能检测到下载的数据量小于预期量(由 Content-Length 头指定)时,引发此异常。 content 属性存储下载的(以及据称截断的)数据。