Text of docs.python.org › uk › 3 › library › webbrowser.html as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

webbrowser — Convenient web-browser controller — Python 3.15.2 documentation

Навігація індекс модулі | наступний | попередній | Python » 3.15.2 documentation » The Python standard library » Інтернет-протоколи та підтримка » webbrowser — Convenient web-browser controller | Theme | webbrowser — Convenient web-browser controller ¶ Вихідний код: Lib/webbrowser.py The webbrowser module provides a high-level interface to allow displaying web-based documents to users.

Under most circumstances, simply calling the open() function from this module will do the right thing. В Unix графічні браузери є кращими під X11, але браузери текстового режиму будуть використовуватися, якщо графічні браузери недоступні або дисплей X11 недоступний. Якщо використовуються браузери текстового режиму, процес виклику блокуватиметься, доки користувач не вийде з браузера.

If the environment variable BROWSER exists, it is interpreted as the os.pathsep -separated list of browsers to try ahead of the platform defaults. When the value of a list part contains the string %s , then it is interpreted as a literal browser command line to be used with the argument URL substituted for %s ; if the value is a single word that refers to one of the already registered browsers this browser is added to the front of the search list; if the part does not contain %s , it is simply interpreted as the name of the browser to launch. [ 1 ] Змінено в версії 3.14: The BROWSER variable can now also be used to reorder the list of platform defaults.

This is particularly useful on macOS where the platform defaults do not refer to command-line tools on PATH . Для платформ, відмінних від Unix, або коли в Unix доступний віддалений браузер, процес керування не чекатиме, поки користувач закінчить роботу з браузером, а дозволить віддаленому браузеру підтримувати власні вікна на дисплеї.

Якщо віддалені браузери недоступні в Unix, процес керування запустить новий браузер і зачекає. On iOS, the BROWSER environment variable, as well as any arguments controlling autoraise, browser preference, and new tab/window creation will be ignored. Web pages will always be opened in the user’s preferred browser, in a new tab, with the browser being brought to the foreground.

The use of the webbrowser module on iOS requires the ctypes module. If ctypes isn’t available, calls to open() will fail. Command-line interface ¶ The script webbrowser can be used as a command-line interface for the module. It accepts a URL as the argument. It accepts the following optional parameters: -n , --new-window ¶ Opens the URL in a new browser window, if possible. -t , --new-tab ¶ Opens the URL in a new browser tab.

The options are, naturally, mutually exclusive. Usage example: python -m webbrowser -t "https://www.python.org" Availability : not WASI, not Android. Визначено такий виняток: exception webbrowser. Error ¶ Виняток виникає, коли виникає помилка керування браузером. Визначаються такі функції: webbrowser. open ( url , new = 0 , autoraise = True ) ¶ Відображати url за допомогою браузера за умовчанням.

Якщо new дорівнює 0, url відкривається в тому ж вікні браузера, якщо це можливо. Якщо new дорівнює 1, відкривається нове вікно браузера, якщо це можливо. Якщо new дорівнює 2, за можливості відкривається нова сторінка браузера («вкладка»). Якщо autoraise має значення True , вікно відкривається, якщо це можливо (зверніть увагу, що в багатьох віконних менеджерах це відбуватиметься незалежно від налаштування цієї змінної).

Returns True if a browser was successfully launched, False otherwise. Зауважте, що на деяких платформах спроба відкрити ім’я файлу за допомогою цієї функції може спрацювати та запустити відповідну програму операційної системи. Однак це не підтримується та не переноситься.

Викликає подію аудиту webbrowser.open з аргументом url . webbrowser. open_new ( url ) ¶ Відкрийте url у новому вікні браузера за замовчуванням, якщо можливо, інакше відкрийте url в єдиному вікні браузера. Returns True if a browser was successfully launched, False otherwise. webbrowser. open_new_tab ( url ) ¶ Відкрийте url на новій сторінці («вкладці») веб-переглядача за умовчанням, якщо це можливо, інакше еквівалентно open_new() .

Returns True if a browser was successfully launched, False otherwise. webbrowser. get ( using = None ) ¶ Повертає об’єкт контролера для типу браузера using . Якщо using має значення None , поверніть контролер для браузера за замовчуванням, який відповідає середовищу абонента. webbrowser. register ( name , constructor , instance = None , * , preferred = False ) ¶ Зареєструйте тип браузера ім’я .

Після реєстрації типу браузера функція get() може повернути контролер для цього типу браузера. Якщо екземпляр не надано або має значення None , конструктор буде викликано без параметрів для створення екземпляра за потреби. Якщо надано екземпляр , конструктор ніколи не буде викликаний і може бути None .

Якщо встановити preferred на True , цей браузер стане кращим результатом для виклику get() без аргументів. В іншому випадку ця точка входу корисна, лише якщо ви плануєте встановити змінну BROWSER або викликати get() з непорожнім аргументом, який відповідає імені обробника, який ви оголошуєте.

Змінено в версії 3.7: Додано переважний параметр лише для ключового слова. Кілька типів браузерів визначено заздалегідь. У цій таблиці наведено назви типів, які можна передати функції get() , і відповідні екземпляри для класів контролерів, усі визначені в цьому модулі.

Тип імені Назва класу Примітки 'mozilla' Mozilla('mozilla') 'firefox' Mozilla('mozilla') 'Богоявлення'' Epiphany('epiphany') 'kfmclient' Konqueror() (1) 'завойовник' Konqueror() (1) 'kfm'' Konqueror() (1) 'опера' Opera() 'посилання' GenericBrowser('links') 'elinks' Elinks('elinks') 'р�

The rest of this page is on the live site.