Spec-Zone.ru › Hammerspoon

hs.network.host

Этот подмодуль предоставляет функции для получения информации об хосте, такие как имена хостов, адреса и доступность.

Обзор API

  • Функции - API-вызовы, предлагаемые непосредственно расширением
    • addressesForHostname
    • hostnamesForAddress
    • reachabilityForAddress
    • reachabilityForHostname
  • Методы - API-вызовы, которые можно выполнить только на объекте, возвращаемом конструктором
    • cancel
    • isRunning

Документация API

Функции

addressesForHostname
Подпись hs.network.host.addressesForHostname(name[, fn]) -> table | hostObject
Тип Функция
Описание

Получение IP-адресов для указанного имени хоста.

Параметры
  • name - имя хоста для поиска IP-адресов
  • fn - необязательная функция обратного вызова, которая при указании выполнит разрешение адреса асинхронно, без блокировки.
Возвращаемое значение
  • Если эта функция вызывается без функции обратного вызова, возвращает таблицу, содержащую IP-адреса для указанного имени. Если функция обратного вызова указана, возвращается объект хоста.
Примечания
  • Если функция обратного вызова не предоставлена, разрешение происходит в блокирующем режиме, что может быть заметно при медленном или нестабильном сетевом доступе.
  • Если функция обратного вызова предоставлена, эта функция действует как конструктор, возвращающий объект хоста, и функция обратного вызова будет вызвана по завершении разрешения. Функция обратного вызова должна принимать два параметра: строку "addresses", указывающую, что произошло разрешение адреса, и таблицу, содержащую определённые IP-адреса.
  • Генерирует ошибку, если сетевой доступ в настоящее время отключён или имя хоста недействительно.
Источник extensions/network/libnetwork_host.m строка 268
hostnamesForAddress
Подпись hs.network.host.hostnamesForAddress(address[, fn]) -> table | hostObject
Тип Функция
Описание

Получение имён хостов для указанного IP-адреса.

Параметры
  • address - строка или число, представляющее сетевой адрес IPv4 или IPv6 для поиска имён хостов. Если аргумент является числом, оно рассматривается как 32-битовое числовое представление адреса IPv4.
  • fn - необязательная функция обратного вызова, которая при указании выполнит разрешение имени хоста асинхронно, без блокировки.
Возвращаемое значение
  • Если эта функция вызывается без функции обратного вызова, возвращает таблицу, содержащую имена хостов для указанного адреса. Если функция обратного вызова указана, возвращается объект хоста.
Примечания
  • Если функция обратного вызова не предоставлена, разрешение происходит в блокирующем режиме, что может быть заметно при медленном или нестабильном сетевом доступе.
  • Если функция обратного вызова предоставлена, эта функция действует как конструктор, возвращающий объект хоста, и функция обратного вызова будет вызвана по завершении разрешения. Функция обратного вызова должна принимать два параметра: строку "names", указывающую, что произошло разрешение имени хоста, и таблицу, содержащую определённые имена хостов.
  • Генерирует ошибку, если сетевой доступ в настоящее время отключён или IP-адрес недействителен.
Источник extensions/network/libnetwork_host.m строка 287
reachabilityForAddress
Подпись hs.network.host.reachabilityForAddress(address[, fn]) -> integer | hostObject
Тип Функция
Описание

Получение состояния доступности для указанного IP-адреса.

Параметры
  • address - строка или число, представляющее сетевой адрес IPv4 или IPv6 для проверки доступности. Если аргумент является числом, оно рассматривается как 32-битовое числовое представление адреса IPv4.
  • fn - необязательная функция обратного вызова, которая при указании определит доступность адреса асинхронно, без блокировки.
Возвращаемое значение
  • Если эта функция вызывается без функции обратного вызова, возвращает числовое представление состояния доступности адреса. Если функция обратного вызова указана, возвращается объект хоста.
Примечания
  • Если функция обратного вызова не предоставлена, разрешение происходит в блокирующем режиме, что может быть заметно при медленном или нестабильном сетевом доступе.
  • Если функция обратного вызова предоставлена, эта функция действует как конструктор, возвращающий объект хоста, и функция обратного вызова будет вызвана по завершении разрешения. Функция обратного вызова должна принимать два параметра: строку "reachability", указывающую, что доступность была определена, и числовое представление состояния доступности адреса.
  • Генерирует ошибку, если сетевой доступ в настоящее время отключён или IP-адрес недействителен.
  • Числовое представление состоит из комбинации флагов, определённых в hs.network.reachability.flags.
  • Выполняет тот же тест доступности, что и hs.network.reachability.forAddress.
Источник extensions/network/libnetwork_host.m строка 306
reachabilityForHostname
Подпись hs.network.host.reachabilityForHostname(name[, fn]) -> integer | hostObject
Тип Функция
Описание

Получение состояния доступности для указанного имени хоста.

Параметры
  • name - имя хоста для проверки доступности. Если аргумент является числом, оно рассматривается как 32-битовое числовое представление адреса IPv4.
  • fn - необязательная функция обратного вызова, которая при указании определит доступность адреса асинхронно, без блокировки.
Возвращаемое значение
  • Если эта функция вызывается без функции обратного вызова, возвращает числовое представление состояния доступности имени хоста. Если функция обратного вызова указана, возвращается объект хоста.
Примечания
  • Если функция обратного вызова не предоставлена, разрешение происходит в блокирующем режиме, что может быть заметно при медленном или нестабильном сетевом доступе.
  • Если функция обратного вызова предоставлена, эта функция действует как конструктор, возвращающий объект хоста, и функция обратного вызова будет вызвана по завершении разрешения. Функция обратного вызова должна принимать два параметра: строку "reachability", указывающую, что доступность была определена, и числовое представление состояния доступности имени хоста.
  • Генерирует ошибку, если сетевой доступ в настоящее время отключён или имя хоста недействительно.
  • Числовое представление состоит из комбинации флагов, определённых в hs.network.reachability.flags.
  • Выполняет тот же тест доступности, что и hs.network.reachability.forHostName.
Источник extensions/network/libnetwork_host.m строка 327

Методы

cancel
Подпись hs.network.host:cancel() -> hostObject
Тип Метод
Описание

Отмена текущего асинхронного разрешения имени хоста.

Параметры
  • Нет
Возвращаемое значение
  • объект хоста
Примечания
  • Этот метод не имеет эффекта, если разрешение уже завершено.
Источник extensions/network/libnetwork_host.m строка 367
isRunning
Подпись hs.network.host:isRunning() -> boolean
Тип Метод
Описание

Возвращает значение, показывающее, происходит ли разрешение для асинхронного запроса.

Параметры
  • Нет
Возвращаемое значение
  • true, если разрешение всё ещё происходит, или false, если разрешение уже завершено.
Источник extensions/network/libnetwork_host.m строка 350

© 2014–2017 Hammerspoon contributors
Licensed under the MIT License.
https://www.hammerspoon.org/docs/hs.network.host.html

Spec-Zone.ru

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