Il modulo webbrowser comprende funzioni per aprire URL in applicazioni che interagiscono con un browser. Il modulo comprende un registro dei browser disponibili, nel caso siano disponibili nel sistema diverse opzioni. Può anche essere controllato tramite la variabile di ambiente BROWSER.

Un Semplice Esempio

Per aprire una pagina nel browser si usi la funzione open().

# webbrowser_open.py

import webbrowser

webbrowser.open(
    'https://docs.python.org/3/library/webbrowser.html'
)

L'URL viene aperto in una finestra del browser, che viene sollevata alla sommità dello stack di finestre. La documentazione dice che verrà usata una finestra esistente, se possibile, ma il reale comportamento dipende dalle impostazioni del browser. Utilizzando Chrome con Linux Ubuntu viene aperta una nuova scheda nell'istanza aperta del browser.

Finestre contro Schede

Se si vuole che venga utilizzata sempre una nuova finestra, si usi open_new().

# webbrowser_open_new.py

import webbrowser

webbrowser.open_new(
    'https://docs.python.org/3/library/webbrowser.html'
)

Se si vuole aprire una nuova scheda si usi open_new_tab().

Usare uno Specifico Browser

Se per qualche ragione si vuole utilizzare per la propria applicazione uno specifico browser, si può accedere all'insieme di controller per i browser registrati tramite la funzione get(). Il controller del browser ha metodi per aprire (open()), aprire una nuova finestra (open_new()) oppure una nuova scheda (open_new_tab()). Questo esempio forza l'utilizzo del browser Firefox.

webbrowser_get.py
import webbrowser

b = webbrowser.get('firefox')
b.open('https://docs.python.org/3/library/webbrowser.html')

Si faccia riferimento alla documentazione del modulo per un elenco dei tipi di browser disponibili.

La Variabile BROWSER

Gli utenti possono controllare il modulo dall'esterno dell'applicazione impostando la variabile di ambiente BROWSER con i nomi dei browser e dei comandi da eseguire. Il valore dovrebbe consistere in una serie di nomi di browser separati da os.pathsep. Se il nome comprende %s esso viene interpretato come comando letterale ed eseguito direttamente con il segnaposto %s rimpiazzato dal nome dell'URL. Altrimenti il nome viene passato a get() per ottenere un oggetto controller dal registro.

Ad esmpio questo comando apre la pagina web in Firefox, assumendo che sia disponibile, a prescindere da quali browser siano registrati.

$ BROWSER=firefox python3 webbrowser_open.py

Interfaccia da Riga di Comando

Tutte le caratteristiche del modulo sono anche disponibili tramite la riga di comando oltre che all'interno del proprio programma Python.

$ python3 -m webbrowser
Usage: /usr/lib/python3.5/webbrowser.py [-n | -t] url
    -n: open new window
    -t: open new tab