Documentación offline Python 3.14

"urllib.error" --- Exception classes raised by urllib.request

3.14 Ver versión oficial en línea Licencia PSF-2.0Descargado el 2026-08-02

"urllib.error" --- Exception classes raised by urllib.request#

Código fuente: 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

Los gestores lanzan esta excepción (o excepciones derivadas) cuando encuentran un problema. Es una subclase de "OSError".

reason

  El motivo de este error. Puede ser una cadena de mensaje u otra
  instancia de una excepción.

Distinto en la versión 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)

A pesar de ser una excepción (una subclase de "URLError"), un "HTTPError" también puede funcionar como un valor de retorno no excepcional de tipo archivo (lo mismo que retorna "urlopen()"). Esto es útil para gestionar errores HTTP exóticos, como peticiones de autentificación.

url

  Contiene la URL de la solicitud. Un alias para el atributo
  *filename*.

code

  Un código de estado HTTP como los definidos en **RFC 2616**.
  Este valor numérico se corresponde con un valor de un
  diccionario de códigos como el que hay en
  "http.server.BaseHTTPRequestHandler.responses".

reason

  Normalmente esto es una cadena de caracteres que explica el
  motivo de este error. Un alias para el atributo *msg*.

headers

  Las cabeceras de la respuesta HTTP de la petición HTTP que causó
  el "HTTPError". Un alias para el atributo *hdrs*.

  Added in version 3.4.

fp

  Un objeto similar a un archivo donde se puede leer el cuerpo del
  error HTTP.

exception urllib.error.ContentTooShortError(msg, content)

Esta excepción se lanza cuando la función "urlretrieve()" detecta que la cantidad de datos descargados es menor que la esperada (dada por la cabecera Content-Length).

content

  Los datos descargados (y supuestamente truncados).