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

已下載的（並假定已截斷的）資料。