webbrowserモジュールにはウェブベースのドキュメントを表示するための、とてもハイレベルなインターフェースが定義されています。 このコントローラーオブジェクトは使い易く、プラットフォーム非依存です。 たいていの環境では、このモジュールのopen()を呼び出すだけで正しく 動作します。
Unixでは、X11上でグラフィカルなブラウザが選択されますが、グラフィカルなブ ラウザが利用できなかったり、X11が利用できない場合はテキストモードのブラウザ が使われます。 もしテキストモードのブラウザが使われたら、ユーザがブラウザから抜け出すまでプ ロセスの呼び出しはブロックされます。
Unixでは、環境変数BROWSERが存在するならプラットフォームのデフォ
ルトであるブラウザのリストをオーバーライドし、コロンで区切られたリストの順に
ブラウザの起動を試みます。
リストの中の値に%s
が含まれていたら、テキストモードのブラウザのコマン
ドラインとして%s
の代わりにURLが引数として解釈されます;
もし%s
が含まれなければ、起動するブラウザの名前として単純に解釈されま
す。
非UnixプラットフォームあるいはUnix上でX11ブラウザが利用可能な場合、制 御プロセスはユーザがブラウザを終了するのを待ちませんが、ディスプレイにブラウ ザのウィンドウを表示させたままにします。
以下の例外が定義されています:
以下の関数が定義されています:
url[, new=0][, autoraise=1]) |
url) |
[name]) |
name, constructor[, instance]) |
None
なら、インスタンスが必要な時
にはconstructorがパラメータなしに呼び出されて作られます。
instanceが指定されたら、constructorは呼び出されないので、
None
でかまいません。
この登録は、変数BROWSERを設定するか、getを空文字列でな く、宣言したハンドラの名前と一致する引数とともに呼び出すときだけ、役に立ちま す。
いくつかの種類のブラウザがあらかじめ定義されています。 このモジュールで定義されている、関数get()に与えるブラウザの名前 と、それぞれのコントローラークラスのインスタンスを以下の表に示します。
Type Name | Class Name | Notes |
---|---|---|
'mozilla' |
Netscape('mozilla') | |
'netscape' |
Netscape('netscape') | |
'mosaic' |
GenericBrowser('mosaic %s &') | |
'kfm' |
Konqueror() | (1) |
'grail' |
Grail() | |
'links' |
GenericBrowser('links %s') | |
'lynx' |
GenericBrowser('lynx %s') | |
'w3m' |
GenericBrowser('w3m %s') | |
'windows-default' |
WindowsDefault | (2) |
'internet-config' |
InternetConfig | (3) |
Notes: