Spec-Zone.ru › Nim

std/browsers

Source Edit

Этот модуль реализует простую функцию для открытия URL-адресов в браузере пользователя по умолчанию.

Нестабильный API.

Импорты

since, strutils, winlean, os

Константы

osOpenCmd = "open"
Source Edit

Процедуры

proc openDefaultBrowser() {....deprecated: "not implemented, please open with a specific url instead",
                            raises: [], tags: [], forbids: [].}
Устарело: не реализовано, пожалуйста, откройте с указанным URL-адресом

Предполагается открыть браузер пользователя по умолчанию без url (пустая страница). Это не блокирующая операция. Предполагается реализовать раздел 3 RFC-6694 IETF ("about:blank" зарезервирован для пустой страницы).

Обратите внимание, что это предполагаемое поведение не реализовано и считается не достойным реализации здесь.

Ниже описано поведение текущей реализации:

  • В Windows это вызовет всплывающее диалоговое окно, запрашивая приложение, связанное с about (поскольку Windows просто обрабатывает about: как протокол, подобный http).
  • В Mac OS X используется команда open "about:blank".
  • В Unix проверяется наличие xdg-open и используется, если оно есть. При этом открывается приложение, связанное с text/html MIME (не x-scheme-handler/http, так что, возможно, откроется просмотрщик HTML, а не ваш браузер по умолчанию). В противном случае переменная среды BROWSER используется для определения браузера по умолчанию.

Эта процедура не вызывает исключение при ошибке, будьте осторожны.

block: openDefaultBrowser()

См. также:

  • https://tools.ietf.org/html/rfc6694#section-3
Source Edit
proc openDefaultBrowser(url: string) {....raises: [], tags: [], forbids: [].}

Открывает url в браузере пользователя по умолчанию. Это не блокирующая операция. URL-адрес не должен быть пустой строкой; для открытия пустой страницы см. openDefaultBrowser().

В Windows используется ShellExecute. В Mac OS X используется команда open. В Unix проверяется наличие xdg-open и используется, если оно есть. В противном случае переменная среды BROWSER используется для определения браузера по умолчанию.

Эта процедура не вызывает исключение при ошибке, будьте осторожны.

block: openDefaultBrowser("https://nim-lang.org")
Source Edit

© 2006–2024 Andreas Rumpf
Licensed under the MIT License.
https://nim-lang.org/docs/browsers.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API