Python Language
Module Webbrowser
Recherche…
Introduction
Selon la documentation standard de Python, le module Webbrowser fournit une interface de haut niveau pour permettre l'affichage des documents Web aux utilisateurs. Cette rubrique explique et démontre l'utilisation correcte du module navigateur Web.
Syntaxe
-
webbrowser.open(url, new=0, autoraise=False) -
webbrowser.open_new(url) -
webbrowser.open_new_tab(url) -
webbrowser.get(usage=None) -
webbrowser.register(name, constructor, instance=None)
Paramètres
| Paramètre | Détails |
|---|---|
webbrowser.open() | |
| URL | l'URL à ouvrir dans le navigateur Web |
| Nouveau | 0 ouvre l'URL dans l'onglet existant, 1 s'ouvre dans une nouvelle fenêtre, 2 s'ouvre dans un nouvel onglet |
| autoraise | Si défini sur True, la fenêtre sera déplacée au-dessus des autres fenêtres |
webbrowser.open_new() | |
| URL | l'URL à ouvrir dans le navigateur Web |
webbrowser.open_new_tab() | |
| URL | l'URL à ouvrir dans le navigateur Web |
webbrowser.get() | |
| en utilisant | le navigateur à utiliser |
webbrowser.register() | |
| URL | nom du navigateur |
| constructeur | chemin d'accès au navigateur exécutable ( aide ) |
| exemple | Une instance d'un navigateur Web renvoyée par la méthode webbrowser.get() |
Remarques
Le tableau suivant répertorie les types de navigateur prédéfinis. La colonne de gauche contient des noms pouvant être transmis à la méthode webbrowser.get() et la colonne de droite répertorie les noms de classe pour chaque type de navigateur.
| Nom du type | Nom du cours |
|---|---|
'mozilla' | Mozilla('mozilla') |
'firefox' | Mozilla('mozilla') |
'netscape' | Mozilla('netscape') |
'galeon' | Galeon('galeon') |
'epiphany' | Galeon('epiphany') |
'skipstone' | BackgroundBrowser('skipstone') |
'kfmclient' | Konqueror() |
'konqueror' | Konqueror() |
'kfm' | Konqueror() |
'mosaic' | BackgroundBrowser('mosaic') |
'opera' | Opera() |
'grail' | Grail() |
'links' | GenericBrowser('links') |
'elinks' | Elinks('elinks') |
'lynx' | GenericBrowser('lynx') |
'w3m' | GenericBrowser('w3m') |
'windows-default' | WindowsDefault |
'macosx' | MacOSX('default') |
'safari' | MacOSX('safari') |
'google-chrome' | Chrome('google-chrome') |
'chrome' | Chrome('chrome') |
'chromium' | Chromium('chromium') |
'chromium-browser' | Chromium('chromium-browser') |
Ouverture d'une URL avec le navigateur par défaut
Pour simplement ouvrir une URL, utilisez la méthode webbrowser.open() :
import webbrowser
webbrowser.open("http://stackoverflow.com")
Si une fenêtre de navigateur est actuellement ouverte, la méthode ouvre un nouvel onglet à l’URL spécifiée. Si aucune fenêtre n'est ouverte, la méthode ouvre le navigateur par défaut du système d'exploitation et accède à l'URL du paramètre. La méthode ouverte prend en charge les paramètres suivants:
-
url- l'URL à ouvrir dans le navigateur Web (chaîne) [requis] -
new- 0 ouvre dans l'onglet existant, 1 ouvre une nouvelle fenêtre, 2 ouvre un nouvel onglet (entier) [par défaut 0] -
autoraise- si défini sur True, la fenêtre sera déplacée au-dessus des fenêtres des autres applications (booléenne) [False par défaut]
Notez que les arguments new et autoraise fonctionnent rarement car la majorité des navigateurs modernes refusent ces commandes.
Webbrowser peut également essayer d'ouvrir des URL dans de nouvelles fenêtres avec la méthode open_new :
import webbrowser
webbrowser.open_new("http://stackoverflow.com")
Cette méthode est généralement ignorée par les navigateurs modernes et l'URL est généralement ouverte dans un nouvel onglet. L'ouverture d'un nouvel onglet peut être tentée par le module en utilisant la méthode open_new_tab :
import webbrowser
webbrowser.open_new_tab("http://stackoverflow.com")
Ouverture d'une URL avec différents navigateurs
Le module webbrowser prend également en charge différents navigateurs utilisant les méthodes register() et get() . La méthode get est utilisée pour créer un contrôleur de navigateur en utilisant le chemin d'accès d'un exécutable spécifique et la méthode register est utilisée pour attacher ces exécutables à des types de navigateur prédéfinis pour une utilisation future, généralement lorsque plusieurs types de navigateurs sont utilisés.
import webbrowser
ff_path = webbrowser.get("C:/Program Files/Mozilla Firefox/firefox.exe")
ff = webbrowser.get(ff_path)
ff.open("http://stackoverflow.com/")
Enregistrer un type de navigateur:
import webbrowser
ff_path = webbrowser.get("C:/Program Files/Mozilla Firefox/firefox.exe")
ff = webbrowser.get(ff_path)
webbrowser.register('firefox', None, ff)
# Now to refer to use Firefox in the future you can use this
webbrowser.get('firefox').open("https://stackoverflow.com/")