urllib.error --- urllib.request 引發的例外類別

原始碼：Lib/urllib/error.py

---

urllib.error module（模組）為 urllib.request 所引發的例外定義了例外 (exception) 類別。基礎例外類別是 URLError。

下列例外會被 urllib.error 適時引發：

exception urllib.error.URLError

處理程式 (handler) 在遇到問題時會引發此例外（或其衍生例外）。它是 OSError 的一個子類別。

reason

此錯誤的原因。它可以是一個訊息字串或另一個例外實例。

在 3.3 版的變更: URLError 曾经是 IOError 的子类型，现在它是 OSError 的一个别名。

exception urllib.error.HTTPError

雖然是一個例外（URLError 的一個子類別），HTTPError 也可以作為一個非例外的類檔案回傳值（與 urlopen() 所回傳的物件相同）。這適用於處理特殊 HTTP 錯誤，例如為請求認證。

code

一個 HTTP 狀態碼，具體定義見 RFC 2616。這個數值會對應到存放在 http.server.BaseHTTPRequestHandler.responses 程式碼 dictionary 中的某個值。

reason

這通常是一個解釋本次錯誤原因的字串。

headers

導致 HTTPError 的特定 HTTP 請求的 HTTP 回應 header。

在 3.4 版新加入.

exception urllib.error.ContentTooShortError(msg, content)

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

content

已下载（并可能被截断）的数据。