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¶

کد وضعیت HTTP تعریف‌شده در RFC 2616. این مقدار عددی با مقداری در دیکشنری کدها که در http.server.BaseHTTPRequestHandler.responses یافت می‌شود، متناظر است.

reason¶

این معمولاً یک رشته است که دلیل این خطا را توضیح می‌دهد. نام مستعاری برای ویژگی msg است.

headers¶

سرآیندهای پاسخ HTTP برای درخواست HTTP که باعث HTTPError شد. نام مستعاری برای ویژگی hdrs.

اضافه شده در نسخه‌ی 3.4.

fp¶

یک شیء شبه‌پرونده که می‌توان بدنه خطای HTTP را از آن خواند.

exception urllib.error.ContentTooShortError(msg, content)¶

این استثنا زمانی پرتاب می‌شود که تابع urlretrieve() تشخیص دهد که مقدار داده‌های بارگیری‌شده کمتر از مقدار مورد انتظار (داده‌شده توسط سرآیند Content-Length) است.

content¶

داده‌ی بارگیری‌شده (و ظاهراً بریده‌شده).