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

下載的（並且據推測被截斷的）資料。