Text of docs.python.org › 3.14 › library › urllib.error.html as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

urllib.error — Exception classes raised by urllib.request — Python 3.14.10 documentation

Navigation index modules | next | previous | Python » 3.14.10 documentation » The Python standard library » Internet Protocols and Support » urllib.error — Exception classes raised by urllib.request | Theme | urllib.error — Exception classes raised by urllib.request ¶ Source code: Lib/urllib/error.py The urllib.error module defines the exception classes for exceptions raised by urllib.request . The base exception class is URLError .

The following exceptions are raised by urllib.error as appropriate: exception urllib.error. URLError ¶ The handlers raise this exception (or derived exceptions) when they run into a problem. It is a subclass of OSError . reason ¶ The reason for this error. It can be a message string or another exception instance. Changed in version 3.3: URLError used to be a subtype of IOError , which is now an alias of OSError . exception urllib.error.

HTTPError ( url , code , msg , hdrs , fp ) ¶ Though being an exception (a subclass of URLError ), an HTTPError can also function as a non-exceptional file-like return value (the same thing that urlopen() returns). This is useful when handling exotic HTTP errors, such as requests for authentication. url ¶ Contains the request URL. An alias for filename attribute. code ¶ An HTTP status code as defined in RFC 2616 . This numeric value corresponds to a value found in the dictionary of codes as found in http.server.BaseHTTPRequestHandler.responses . reason ¶ This is usually a string explaining the reason for this error.

An alias for msg attribute. headers ¶ The HTTP response headers for the HTTP request that caused the HTTPError . An alias for hdrs attribute. Added in version 3.4. fp ¶ A file-like object where the HTTP error body can be read from. exception urllib.error. ContentTooShortError ( msg , content ) ¶ This exception is raised when the urlretrieve() function detects that the amount of the downloaded data is less than the expected amount (given by the Content-Length header). content ¶ The downloaded (and supposedly truncated) data.

Previous topic urllib.parse — Parse URLs into components Next topic urllib.robotparser — Parser for robots.txt This page Report a bug Improve this page Show source « Navigation index modules | next | previous | Python » 3.14.10 documentation » The Python standard library » Internet Protocols and Support » urllib.error — Exception classes raised by urllib.request | Theme | © Copyright 2001 Python Software Foundation.

This page is licensed under the Python Software Foundation License Version 2. Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License. See History and License for more information. The Python Software Foundation is a non-profit corporation. Please donate. Last updated on Nov 19, 2026 (13:23 UTC). Found a bug ? Created using Sphinx 9.1.1.