Referencia de la Biblioteca de Python

Anterior: 11. Soporte y protocolos Niv. superior: 11. Soporte y protocolos Siguiente: 11.1.1 Objetos del Controlador

---

11.1 webbrowser -- Controlador Web-browser

El módulo webbrowser proporciona un interface de alto nivel que permite mostrar documentos basados en Web a los usuarios. Los objetos del controlador son fáciles de usar y son independientes de la plataforma.

Bajo Unix, se prefieren los navegadores gráficos bajo X11, pero se usarán los navegadores de modo texto si no están disponibles los navegadores gráficos o no hay disponible una terminal X11. Cuando se usa los navegadores en modo texto, el proceso llamante se bloquea hasta que el usuario sale del navegador.

Para plataformas no-Unix, o cuando estén disponibles los navegadores X11 en Unix, el proceso de control no esperará a que el usuario termine con el navegador, permitiendo que el navegador mantenga su propia ventana en la pantalla.

Se definen las siguientes excepciones:

Error

Se desencadena una excepción cuando ocurre un error en el control del navegador.

Se definen las siguientes funciones:

open (url[, new])

Muestra url usando el navegador por defecto. Si new es true, se abre un nuevo navegador, si es posible.

open_new (url)

Abre url en una nueva ventana del navegador por defecto, si es posible; de lo contrario abrirá url en la única ventana del navegador.

get ([name])

Devuelve un objeto controlador para el tipo name del navegador.

register (name, constructor[instance, controller])

Registra el tipo name del navegador. Una vez registrado el tipo de navegador, la función get() podrá devolver un controlador para este tipo de navegador. Si no se suministra instance, o es None, se llamará a constructor sin parámetros para crear la instancia cuando sea necesario. Si se suministra instance nunca se llamará a constructor, pudiendo ser None.

Están definidos algunos tipos de navegador. Esta tabla da los nombres de tipos que pueden pasarse a la función get(), y los nombres de las clases implementadas, todas definidas en este módulo.

Type Name	Class Name	Notes
'netscape'	Netscape
'kfm'	Konquerer	(1)
'grail'	Grail
'windows-default'	WindowsDefault	(2)
'internet-config'	InternetConfig	(3)
'command-line'	CommandLineBrowser

Notas:

(1)

``Konquerer'' es el manejador de ficheros del entorno de escritorio KDE para UNIX, y sólo tendrá sentido si se está ejecutando KDE. Estaría bien alguna manera más segura para detectar KDE; la variable de entorno $KDEDIR no es suficiente.

(2)

Sólo en plataformas Windows; se requieren los módulos de extensión comunes win32api y win32con.

(3)

Sólo en plataformas MacOS; se requiere el módulo estándar de MacPython ic, descrito en manual Macintosh Library Modules.

• 11.1.1 Objetos del Controlador de Navegador

---

Referencia de la Biblioteca de Python

Anterior: 11. Soporte y protocolos Niv. superior: 11. Soporte y protocolos Siguiente: 11.1.1 Objetos del Controlador