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 已被設為 OSError 而不是 IOError 的子類別。

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 header 給定)時被引發。content 屬性中將存放已下載(可能已被截斷)的資料。