chrome.networking.onc

Описание

API chrome.networking.onc используется для настройки сетевых подключений (сотовая связь, Ethernet, VPN или Wi-Fi). Этот API доступен в автоматически запускаемых сеансах киоска Chrome OS.

Конфигурации сетевых подключений определяются в соответствии со спецификацией Open Network Configuration (ONC) .

ПРИМЕЧАНИЕ : большинство свойств словаря и значений перечисления используют UpperCamelCase для соответствия спецификации ONC вместо соглашения JavaScript lowerCamelCase.

Разрешения

networking.onc

Доступность

Только Chrome OS 59+

Типы

ActivationStateType

Перечисление

«Активировано»

«Активация»

«Неактивировано»

«Частично активирован»

CaptivePortalStatus

Перечисление

"Неизвестный"

«Оффлайн»

«Онлайн»

"Портал"

«ProxyAuthRequired»

CellularProperties

Характеристики

  • ActivationState

    ActivationStateType (необязательно)

    Состояние активации учетной записи оператора.

  • Тип активации

    строка необязательная

    Тип активации сотовой сети.

  • Разрешить роуминг

    логическое необязательное

    Разрешен ли роуминг в сети.

  • АвтоКоннект

    логическое необязательное

    Должна ли сотовая сеть подключаться автоматически (при нахождении в зоне действия).

  • Семья

    строка необязательная

    Семейство технологий сотовых устройств — CDMA или GSM .

  • Версия прошивки

    строка необязательная

    Версия прошивки, загруженная в сотовый модем.

  • FoundNetworks

    FoundNetworkProperties [] необязательно

    Список сетей, найденных во время последнего сканирования сетей.

  • HardwareRevision

    строка необязательная

    Обновление аппаратной части сотового модема.

  • HomeProvider

    CellularProviderProperties (необязательно)

    Информация об операторе, выдавшем SIM-карту, установленную в данный момент в модеме.

  • Производитель

    строка необязательная

    Производитель сотовых модемов.

  • ModelID

    строка необязательная

    Идентификатор модели сотового модема.

  • Сетевые технологии

    строка необязательная

    Если модем зарегистрирован в сети, то сетевая технология, используемая в данный момент.

  • Платежный портал

    Платежный портал необязателен

    Портал онлайн-платежей, с помощью которого пользователь может зарегистрироваться или изменить тарифный план мобильной связи.

  • RoamingState

    строка необязательная

    Состояние роуминга сотового модема в текущей сети.

  • SIMLockStatus

    SIMLockStatus (опционально)

    Состояние блокировки SIM-карт для сетей семейства GSM.

  • SIMPresent

    логическое необязательное

    Наличие SIM-карты.

  • Сканирование

    логическое необязательное

    Хром 63+

    Истина, когда выполняется сканирование сотовой сети.

  • Оператор обслуживания

    CellularProviderProperties (необязательно)

    Информация об операторе, в сети которого в данный момент зарегистрирован модем.

  • Сила сигнала

    номер необязательно

    Текущая мощность сигнала сети.

  • ПоддержкаNetworkScan

    логическое необязательное

    Поддерживает ли сотовая сеть сканирование.

CellularProviderProperties

Характеристики

  • Код

    нить

    Идентификатор сотовой сети как простая конкатенация MCC (код страны мобильной связи) и MNC (код сети мобильной связи) сети.

  • Страна

    строка необязательная

    Двухбуквенный код страны.

  • Имя

    нить

    Имя оператора.

CellularStateProperties

Характеристики

CertificatePattern

Характеристики

  • EnrollmentURI

    строка[] необязательная

    Список URI, на которые может быть перенаправлен пользователь в случае, если не найдено ни одного сертификата, соответствующего данному шаблону.

  • Эмитент

    IssuerSubjectPattern необязательно

    Если установлено, шаблон, с которым должны сопоставляться настройки эмитента X.509.

  • ЭмитентCARef

    строка[] необязательная

    Список сертификатов центров сертификации (CA) эмитентов сертификатов. Сертификат должен быть подписан одним из них, чтобы соответствовать этому шаблону.

  • Предмет

    IssuerSubjectPattern необязательно

    Если установлено, шаблон, с которым должны сопоставляться настройки субъекта X.509.

ClientCertificateType

Перечисление

"Реф"

"Шаблон"

ConnectionStateType

Перечисление

«Связанный»

«Соединение»

«NotConnected»

DeviceStateProperties

Характеристики

  • SIMLockStatus

    SIMLockStatus (опционально)

    Хром 62+

    Состояние блокировки SIM-карты, если Type = Cellular и SIMPresent = True.

  • SIMPresent

    логическое необязательное

    Хром 62+

    Если тип устройства — сотовая связь, установите состояние наличия SIM-карты.

  • Сканирование

    логическое необязательное

    Установите, если устройство включено. True, если устройство в данный момент выполняет сканирование.

  • Текущее состояние устройства.

  • Тип сети, связанный с устройством (сотовая связь, Ethernet или WiFi).

DeviceStateType

Перечисление

«Неинициализировано»
Устройство доступно, но не инициализировано.

"Неполноценный"
Устройство инициализировано, но не включено.

«Включение»
Запрошено включенное состояние, но оно не выполнено.

"Включено"
Устройство включено.

"Запрещенный"
Устройство запрещено.

EAPProperties

Характеристики

  • Анонимная личность

    строка необязательная

  • ClientCertPKCS11Id

    строка необязательная

    Хром 60+
  • ClientCertPattern

    CertificatePattern (необязательно)

  • ClientCertProvisioningProfileId

    строка необязательная

    Хром 93+
  • ClientCertRef

    строка необязательная

  • ClientCertType

    ClientCertificateType

  • Личность

    строка необязательная

  • Внутренний

    строка необязательная

  • Внешний

    строка необязательная

    Внешний тип EAP. Требуется ONC, но может быть не указан при переводе с Shill.

  • Пароль

    строка необязательная

  • Сохранить учетные данные

    логическое необязательное

  • ServerCAPEMs

    строка[] необязательная

  • ServerCARefs

    строка[] необязательная

  • SubjectMatch

    ManagedDOMString (необязательно)

    Хром 60+
  • UseProactiveKeyCaching

    логическое необязательное

  • UseSystemCAs

    логическое необязательное

EthernetProperties

Характеристики

  • Аутентификация

    строка необязательная

    Аутентификация, используемая сетью Ethernet. Возможные значения: None и 8021X .

  • АвтоКоннект

    логическое необязательное

    Должна ли сеть Ethernet подключаться автоматически.

  • ЕАП

    EAPProperties необязательны

    Настройки EAP сети. Требуется для аутентификации 8021X.

EthernetStateProperties

Характеристики

FoundNetworkProperties

Характеристики

  • ДлинноеИмя

    строка необязательная

    Длинное название оператора сети.

  • NetworkId

    нить

    Идентификатор сети.

  • КороткоеИмя

    строка необязательная

    Краткое название оператора сети.

  • Статус

    нить

    Доступность сети.

  • Технология

    нить

    Технология доступа, используемая в сети.

GlobalPolicy

Характеристики

  • AllowOnlyPolicyNetworksToAutoconnect

    логическое необязательное

    Если задано значение «true», автоматическое подключение возможно только к сетям политики. Значение по умолчанию — «false».

  • AllowOnlyPolicyNetworksToConnect

    логическое необязательное

    Если задано значение «true», можно подключаться только к сетям, указанным в политике, и нельзя добавлять или настраивать новые сети. Значение по умолчанию — «false».

  • AllowOnlyPolicyNetworksToConnectIfAvailable

    логическое необязательное

    Хром 70+

    Если установлено значение true и управляемая сеть доступна в списке видимых сетей, можно подключаться только к сетям, к которым применяются политики, и нельзя добавлять или настраивать новые сети. Значение по умолчанию — false.

  • BlockedHexSSIDs

    строка[] необязательная

    Хром 86+

    Список заблокированных сетей. Подключения к заблокированным сетям запрещены. Сети можно разблокировать, указав явную конфигурацию сети. По умолчанию — пустой список.

IPConfigProperties

Характеристики

  • Исключенные маршруты

    строка[] необязательная

    Хром 76+

    Массив IP-блоков в нотации CIDR, подробности см. в onc_spec.md.

  • Шлюз

    строка необязательная

    Адрес шлюза, используемый для конфигурации IP.

  • IP-адрес

    строка необязательная

    IP-адрес для подключения. Может быть IPv4- или IPv6-адресом, в зависимости от значения параметра Type .

  • Включенные маршруты

    строка[] необязательная

    Хром 76+

    Массив IP-блоков в нотации CIDR, подробности см. в onc_spec.md.

  • Серверы имен

    строка[] необязательная

    Массив адресов, используемых для серверов имен.

  • RoutingPrefix

    номер необязательно

    Префикс маршрутизации.

  • SearchDomains

    строка[] необязательная

    Хром 76+

    Массив строк для разрешения имен, подробности см. в onc_spec.md.

  • Тип

    строка необязательная

    Тип конфигурации IP. Может быть IPv4 или IPv6 .

  • WebProxyAutoDiscoveryUrl

    строка необязательная

    URL-адрес для автоматического обнаружения прокси-сервера WEb, переданный по DHCP.

IPConfigType

Перечисление

"DHCP"

"Статический"

IssuerSubjectPattern

Характеристики

  • CommonName

    строка необязательная

    Если установлено, значение, с которым необходимо сопоставить общее имя субъекта сертификата.

  • Местность

    строка необязательная

    Если установлено, значение, с которым необходимо сопоставить общее местоположение субъекта сертификата.

  • Организация

    строка необязательная

    Если задано, значение, с которым будут сопоставляться организации субъекта сертификата. Значение должно совпадать хотя бы с одной организацией.

  • Организационная единица

    строка необязательная

    Если задано, значение, с которым будут сопоставляться организационные подразделения субъекта сертификата. Хотя бы одно организационное подразделение должно соответствовать этому значению.

ManagedBoolean

Характеристики

  • Активный

    логическое необязательное

    Активное значение, используемое в данный момент менеджером конфигурации сети (например, Shill).

  • УстройствоРедактируемое

    логическое необязательное

    Существует ли политика DevicePolicy для свойства и позволяет ли она редактировать свойство (т. е. устанавливает ли политика рекомендуемое значение свойства). Значение по умолчанию — false .

  • DevicePolicy

    логическое необязательное

    Значение свойства, предоставленное политикой устройства.

  • Эффективный

    строка необязательная

    Источник, на основании которого была определена эффективная стоимость имущества.

  • SharedSetting

    логическое необязательное

    Значение, заданное для всех пользователей устройства. Доступно только в том случае, если DeviceEditiable имеет true .

  • Пользовательский редактор

    логическое необязательное

    Существует ли политика пользователя (UserPolicy) для свойства и позволяет ли она редактировать свойство (т. е. политика задаёт рекомендуемое значение свойства). Значение по умолчанию — false .

  • UserPolicy

    логическое необязательное

    Значение свойства, предоставленное политикой пользователя.

  • Пользовательские настройки

    логическое необязательное

    Значение свойства, заданное вошедшим в систему пользователем. Предоставляется только в том случае, если UserEditable имеет true .

ManagedCellularProperties

Характеристики

ManagedDOMString

Характеристики

  • Активный

    строка необязательная

    Активное значение, используемое в данный момент менеджером конфигурации сети (например, Shill).

  • УстройствоРедактируемое

    логическое необязательное

    Существует ли политика DevicePolicy для свойства и позволяет ли она редактировать свойство (т. е. устанавливает ли политика рекомендуемое значение свойства). Значение по умолчанию — false .

  • DevicePolicy

    строка необязательная

    Значение свойства, предоставленное политикой устройства.

  • Эффективный

    строка необязательная

    Источник, на основании которого была определена эффективная стоимость имущества.

  • SharedSetting

    строка необязательная

    Значение, заданное для всех пользователей устройства. Доступно только в том случае, если DeviceEditiable имеет true .

  • Пользовательский редактор

    логическое необязательное

    Существует ли политика пользователя (UserPolicy) для свойства и позволяет ли она редактировать свойство (т. е. политика задаёт рекомендуемое значение свойства). Значение по умолчанию — false .

  • UserPolicy

    строка необязательная

    Значение свойства, предоставленное политикой пользователя.

  • Пользовательские настройки

    строка необязательная

    Значение свойства, заданное вошедшим в систему пользователем. Предоставляется только в том случае, если UserEditable имеет true .

ManagedDOMStringList

Характеристики

  • Активный

    строка[] необязательная

    Активное значение, используемое в данный момент менеджером конфигурации сети (например, Shill).

  • УстройствоРедактируемое

    логическое необязательное

    Существует ли политика DevicePolicy для свойства и позволяет ли она редактировать свойство (т. е. устанавливает ли политика рекомендуемое значение свойства). Значение по умолчанию — false .

  • DevicePolicy

    строка[] необязательная

    Значение свойства, предоставленное политикой устройства.

  • Эффективный

    строка необязательная

    Источник, на основании которого была определена эффективная стоимость имущества.

  • SharedSetting

    строка[] необязательная

    Значение, заданное для всех пользователей устройства. Доступно только в том случае, если DeviceEditiable имеет true .

  • Пользовательский редактор

    логическое необязательное

    Существует ли политика пользователя (UserPolicy) для свойства и позволяет ли она редактировать свойство (т. е. политика задаёт рекомендуемое значение свойства). Значение по умолчанию — false .

  • UserPolicy

    строка[] необязательная

    Значение свойства, предоставленное политикой пользователя.

  • Пользовательские настройки

    строка[] необязательная

    Значение свойства, заданное вошедшим в систему пользователем. Предоставляется только в том случае, если UserEditable имеет true .

ManagedEthernetProperties

Характеристики

ManagedIPConfigProperties

Характеристики

ManagedIPConfigType

Характеристики

  • Активный

    IPConfigType необязательно

    Активное значение, используемое в данный момент менеджером конфигурации сети (например, Shill).

  • УстройствоРедактируемое

    логическое необязательное

    Существует ли политика DevicePolicy для свойства и позволяет ли она редактировать свойство (т. е. устанавливает ли политика рекомендуемое значение свойства). Значение по умолчанию — false .

  • DevicePolicy

    IPConfigType необязательно

    Значение свойства, предоставленное политикой устройства.

  • Эффективный

    строка необязательная

    Источник, на основании которого была определена эффективная стоимость имущества.

  • SharedSetting

    IPConfigType необязательно

    Значение, заданное для всех пользователей устройства. Доступно только в том случае, если DeviceEditiable имеет true .

  • Пользовательский редактор

    логическое необязательное

    Существует ли политика пользователя (UserPolicy) для свойства и позволяет ли она редактировать свойство (т. е. политика задаёт рекомендуемое значение свойства). Значение по умолчанию — false .

  • UserPolicy

    IPConfigType необязательно

    Значение свойства, предоставленное политикой пользователя.

  • Пользовательские настройки

    IPConfigType необязательно

    Значение свойства, заданное вошедшим в систему пользователем. Предоставляется только в том случае, если UserEditable имеет true .

ManagedLong

Характеристики

  • Активный

    номер необязательно

    Активное значение, используемое в данный момент менеджером конфигурации сети (например, Shill).

  • УстройствоРедактируемое

    логическое необязательное

    Существует ли политика DevicePolicy для свойства и позволяет ли она редактировать свойство (т. е. устанавливает ли политика рекомендуемое значение свойства). Значение по умолчанию — false .

  • DevicePolicy

    номер необязательно

    Значение свойства, предоставленное политикой устройства.

  • Эффективный

    строка необязательная

    Источник, на основании которого была определена эффективная стоимость имущества.

  • SharedSetting

    номер необязательно

    Значение, заданное для всех пользователей устройства. Доступно только в том случае, если DeviceEditiable имеет true .

  • Пользовательский редактор

    логическое необязательное

    Существует ли политика пользователя (UserPolicy) для свойства и позволяет ли она редактировать свойство (т. е. политика задаёт рекомендуемое значение свойства). Значение по умолчанию — false .

  • UserPolicy

    номер необязательно

    Значение свойства, предоставленное политикой пользователя.

  • Пользовательские настройки

    номер необязательно

    Значение свойства, заданное вошедшим в систему пользователем. Предоставляется только в том случае, если UserEditable имеет true .

ManagedManualProxySettings

Характеристики

ManagedProperties

Характеристики

ManagedProxyLocation

Характеристики

ManagedProxySettings

Характеристики

ManagedProxySettingsType

Характеристики

  • Активный

    ProxySettingsType необязательно

    Активное значение, используемое в данный момент менеджером конфигурации сети (например, Shill).

  • УстройствоРедактируемое

    логическое необязательное

    Существует ли политика DevicePolicy для свойства и позволяет ли она редактировать свойство (т. е. устанавливает ли политика рекомендуемое значение свойства). Значение по умолчанию — false .

  • DevicePolicy

    ProxySettingsType необязательно

    Значение свойства, предоставленное политикой устройства.

  • Эффективный

    строка необязательная

    Источник, на основании которого была определена эффективная стоимость имущества.

  • SharedSetting

    ProxySettingsType необязательно

    Значение, заданное для всех пользователей устройства. Доступно только в том случае, если DeviceEditiable имеет true .

  • Пользовательский редактор

    логическое необязательное

    Существует ли политика пользователя (UserPolicy) для свойства и позволяет ли она редактировать свойство (т. е. политика задаёт рекомендуемое значение свойства). Значение по умолчанию — false .

  • UserPolicy

    ProxySettingsType необязательно

    Значение свойства, предоставленное политикой пользователя.

  • Пользовательские настройки

    ProxySettingsType необязательно

    Значение свойства, заданное вошедшим в систему пользователем. Предоставляется только в том случае, если UserEditable имеет true .

ManagedThirdPartyVPNProperties

Характеристики

ManagedVPNProperties

Характеристики

ManagedWiFiProperties

Характеристики

ManualProxySettings

Характеристики

  • FTP-прокси

    ProxyLocation необязательно

    Настройки FTP-прокси.

  • HTTPProxy

    ProxyLocation необязательно

    Настройки для HTTP-прокси.

  • НОСКИ

    ProxyLocation необязательно

    Настройки для SOCKS-прокси.

  • SecureHTTPProxy

    ProxyLocation необязательно

    Настройки безопасного HTTP-прокси.

NetworkConfigProperties

Характеристики

NetworkFilter

Характеристики

  • настроен

    логическое необязательное

    Если значение true, включать только настроенные (сохранённые) сети. Значение по умолчанию — false.

  • предел

    номер необязательно

    Максимальное количество возвращаемых сетей. Если не указано иное, по умолчанию 1000. Используйте 0, чтобы не ограничивать.

  • Тип сети

    Тип сети

    Тип возвращаемых сетей.

  • видимый

    логическое необязательное

    Если задано значение «true», включаются только видимые (физически подключенные или находящиеся в зоне действия) сети. Значение по умолчанию — «false».

NetworkProperties

Характеристики

  • Сотовая связь

    CellularProperties (необязательно)

    Для сотовых сетей — свойства сотовой сети.

  • Подключаемый

    логическое необязательное

    Возможность подключения к сети.

  • ConnectionState

    ConnectionStateType необязательно

    Текущее состояние подключения к сети.

  • ErrorState

    строка необязательная

    Последнее зафиксированное состояние ошибки сети.

  • Ethernet

    EthernetProperties (необязательно)

    Для сетей Ethernet — свойства сети Ethernet.

  • GUID

    нить

    Сетевой GUID.

  • IPAddressConfigType

    IPConfigType необязательно

    Тип конфигурации IP-адреса сети.

  • IPConfigs

    IPConfigProperties [] необязательно

    Конфигурация IP сети.

  • Mac-адрес

    строка необязательная

    MAC-адрес сети.

  • Измеренный

    логическое необязательное

    Хром 85+

    Является ли сеть тарифицируемой.

  • Имя

    строка необязательная

    Удобное для пользователя сетевое имя.

  • NameServersConfigType

    IPConfigType необязательно

    Тип конфигурации IP для серверов имен, используемых в сети.

  • Приоритет

    номер необязательно

    Приоритет сети.

  • Настройки прокси

    ProxySettings необязательно

    Настройки прокси-сервера сети.

  • Ограниченное подключение

    логическое необязательное

    Для подключенной сети: ограничено ли сетевое подключение к Интернету, например, если сеть находится за порталом или сотовая сеть не активирована.

  • SavedIPConfig

    Свойства IPConfig ( необязательно)

    Конфигурация IP, полученная от DHCP-сервера до применения статической конфигурации IP.

  • Источник

    строка необязательная

    Указывает, настроена ли сеть и как именно. Возможные значения:

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

    «None» конфликтует с генерацией кода расширения, поэтому мы должны использовать строку для «Source» вместо перечисления SourceType.

  • StaticIPConfig

    Свойства IPConfig ( необязательно)

    Статическая IP-конфигурация сети.

  • TrafficCounterResetTime

    номер необязательно

    Хром 125+

    Когда последний раз обнулялись счетчики трафика.

  • Тип сети.

  • VPN

    VPNСвойства (необязательно)

    Для сетей VPN — свойства сети VPN.

  • Wi-Fi

    WiFiProperties (необязательно)

    Для сетей WiFi — свойства сети WiFi.

NetworkStateProperties

Характеристики

NetworkType

Перечисление

"Все"

«Сотовая связь»

"Ethernet"

"Привязь"

"VPN"

«Беспроводной»

"Wi-Fi"

PaymentPortal

Характеристики

  • Метод

    нить

    HTTP-метод, используемый для платежного портала.

  • PostData

    строка необязательная

    Данные для отправки на платёжный портал. Игнорируется, если выбран Method POST .

  • URL-адрес

    строка необязательная

    URL платежного портала.

ProxyLocation

Характеристики

  • Хозяин

    нить

    IP-адрес прокси-сервера.

  • Порт

    число

    Порт, используемый для прокси-сервера.

ProxySettings

Характеристики

  • Исключитьдомены

    строка[] необязательная

    Домены и хосты, для которых ручные настройки прокси-сервера исключены.

  • Руководство

    ManualProxySettings (необязательно)

    Ручные настройки прокси-сервера — используется только для Manual настроек прокси-сервера.

  • ПАК

    строка необязательная

    URL-адрес файла автоконфигурации прокси-сервера.

  • Тип настроек прокси.

ProxySettingsType

Перечисление

"Прямой"

"Руководство"

"ПАК"

"WPAD"

SIMLockStatus

Характеристики

  • LockEnabled

    булев

    Включена ли блокировка SIM-карты.

  • LockType

    нить

    Статус блокировки SIM-карты — возможные значения: 'sim-pin' , 'sim-puk' и '' .

  • RetriesLeft

    номер необязательно

    Допустимое количество попыток блокировки PIN-кода до того, как для разблокировки SIM-карты потребуется PUK-код.

ThirdPartyVPNProperties

Характеристики

  • ExtensionID

    нить

    Идентификатор расширения стороннего VPN-провайдера.

  • ИмяПоставщика

    строка необязательная

    Имя VPN-провайдера.

VPNProperties

Характеристики

  • АвтоКоннект

    логическое необязательное

    Должна ли сеть VPN подключаться автоматически.

  • Хозяин

    строка необязательная

    VPN-хост.

  • Тип

    строка необязательная

    Тип VPN. Не может быть перечислением, так как используется тип «L2TP-IPSec». Этот параметр необязателен для NetworkConfigProperties, который передаётся в setProperties, где можно задать только определённые свойства.

VPNStateProperties

Характеристики

WiFiProperties

Характеристики

  • AllowGatewayARPPolling

    логическое необязательное

    Не рекомендуется с версии Chrome 131

    Удалено в версии M131. Теперь нет активного опроса ARP.

  • АвтоКоннект

    логическое необязательное

    Должна ли сеть WiFi подключаться автоматически при нахождении в зоне ее действия.

  • BSSID

    строка необязательная

    BSSID соответствующей точки доступа.

  • ЕАП

    EAPProperties необязательны

    Свойства сетевого EAP. Требуется для сетей WEP-8021X и WPA-EAP .

  • Частота

    номер необязательно

    Рабочая частота Wi-Fi в МГц. Для подключённых сетей — текущая частота, на которой сеть подключена. В противном случае — частота наилучшего доступного BSS.

  • Список частот

    номер[] необязательно

    Содержит все рабочие частоты, недавно обнаруженные в сети WiFi.

  • HexSSID

    строка необязательная

    Копия SSID сети в шестнадцатеричном коде.

  • СкрытыйSSID

    логическое необязательное

    Будет ли транслироваться SSID сети.

  • Парольная фраза

    строка необязательная

    Хром 66+

    Парольная фраза для подключений WEP/WPA/WPA2. Это свойство можно только задать. Свойства, возвращаемые getProperties , не будут содержать этого значения.

  • RoamThreshold

    номер необязательно

    Устаревшее, игнорируемое.

  • SSID

    строка необязательная

    SSID сети.

  • Безопасность

    строка необязательная

    Тип безопасности сети.

  • Сила сигнала

    номер необязательно

    Уровень сигнала сети.

WiFiStateProperties

Характеристики

WiMAXProperties

Характеристики

  • АвтоКоннект

    логическое необязательное

    Должно ли подключение к сети происходить автоматически.

  • ЕАП

    EAPProperties необязательны

    Свойства сетевого EAP.

Методы

createNetwork()

Обещать
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<string>

Создаёт новую конфигурацию сети на основе свойств. Если соответствующая настроенная сеть уже существует, это завершится ошибкой. В противном случае возвращает GUID новой сети.

Параметры

  • поделился

    булев

    Если true , поделитесь этой сетевой конфигурацией с другими пользователями.

    Эта опция доступна только в веб-интерфейсе Chrome. * При вызове из приложений единственно допустимым значением является false .

  • характеристики

    NetworkConfigProperties

    Свойства для настройки новой сети.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (result: string) => void

    • результат

      нить

Возврат

  • Обещание<строка>

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

disableNetworkType()

chrome.networking.onc.disableNetworkType(
  networkType: NetworkType,
): void

Отключает все устройства, соответствующие указанному типу сети. См. примечание для enableNetworkType .

Параметры

  • Тип сети

    Тип сети

    Тип сети, которую необходимо отключить.

enableNetworkType()

chrome.networking.onc.enableNetworkType(
  networkType: NetworkType,
): void

Включает любые устройства, соответствующие указанному типу сети. Обратите внимание, что тип может представлять несколько типов сетей (например, «Беспроводная»).

Параметры

  • Тип сети

    Тип сети

    Тип сети, которую необходимо включить.

forgetNetwork()

Обещать
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
): Promise<void>

Забывает конфигурацию сети, очищая все настроенные свойства сети с идентификатором GUID networkGuid . Это может также включать любые другие сети с совпадающими идентификаторами (например, SSID Wi-Fi и Security). Если такой конфигурации нет, возникнет ошибка, и операция завершится неудачей.

В сеансах киоска этот метод не позволит забыть общие сетевые конфигурации.

Параметры

  • networkGuid

    нить

    GUID сети, которую нужно забыть.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getCaptivePortalStatus()

Обещать
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
): Promise<CaptivePortalStatus>

Возвращает статус портала захвата для сети, соответствующей «networkGuid».

Параметры

  • networkGuid

    нить

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

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (result: CaptivePortalStatus) => void

Возврат

  • Обещание< CaptivePortalStatus >

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getDeviceStates()

Обещать
chrome.networking.onc.getDeviceStates(
  callback?: function,
): Promise<DeviceStateProperties[]>

Возвращает состояния доступных сетевых устройств.

Параметры

Возврат

  • Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getGlobalPolicy()

Обещать
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
): Promise<GlobalPolicy>

Получает глобальные свойства политики. Эти свойства не должны изменяться в течение сеанса.

Параметры

Возврат

  • Обещание< GlobalPolicy >

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getManagedProperties()

Обещать
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
): Promise<ManagedProperties>

Получает объединенные свойства сети с идентификатором networkGuid из источников: настройки пользователя, общие настройки, политика пользователя, политика устройства и текущие активные настройки.

Параметры

  • networkGuid

    нить

    GUID сети, для которой требуется получить свойства.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (result: ManagedProperties) => void

Возврат

  • Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getNetworks()

Обещать
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
): Promise<NetworkStateProperties[]>

Возвращает список сетевых объектов с теми же свойствами, что и getState . Предусмотрен фильтр для указания типа возвращаемых сетей и ограничения их количества. Система упорядочивает сети по приоритету: подключенные или подключающиеся сети отображаются первыми.

Параметры

Возврат

  • Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getProperties()

Обещать
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
): Promise<NetworkProperties>

Получает все свойства сети с идентификатором networkGuid. Включает все свойства сети (доступные только для чтения и для чтения/записи).

Параметры

  • networkGuid

    нить

    GUID сети, для которой требуется получить свойства.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (result: NetworkProperties) => void

Возврат

  • Обещание< Свойства сети >

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getState()

Обещать
chrome.networking.onc.getState(
  networkGuid: string,
  callback?: function,
): Promise<NetworkStateProperties>

Получает кэшированные свойства сети с идентификатором networkGuid, доступные только для чтения. Эта функция должна быть более производительной, чем getProperties , которая требует полного цикла запроса к сетевой подсистеме. Для всех сетей возвращаются следующие свойства: GUID, Type, Name, WiFi.Security. Для видимых сетей предусмотрены дополнительные свойства: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

Параметры

  • networkGuid

    нить

    GUID сети, для которой требуется получить свойства.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    (result: NetworkStateProperties) => void

Возврат

  • Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

requestNetworkScan()

chrome.networking.onc.requestNetworkScan(
  networkType?: NetworkType,
): void

Запрашивает сканирование сетевой подсистемой новых сетей и обновление списка, возвращаемого функцией getVisibleNetworks . Это всего лишь запрос: сетевая подсистема может проигнорировать его. Если список обновлён, будет вызвано событие onNetworkListChanged .

Параметры

  • Тип сети

    NetworkType (необязательно)

    Хром 63+

    Если указано, запрашивает сканирование, соответствующее типу сети. Для сотовой связи будет запрошено сканирование мобильной сети, если поддерживается.

setProperties()

Обещать
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<void>

Задаёт свойства сети с идентификатором networkGuid . Это действительно только для настроенных сетей (Source != None). Для ненастроенных видимых сетей следует использовать createNetwork . В сеансах киоска вызов этого метода в общей сети завершится ошибкой.

Параметры

  • networkGuid

    нить

    GUID сети, для которой требуется задать свойства.

  • характеристики

    NetworkConfigProperties

    Свойства, которые необходимо установить.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

startConnect()

Обещать
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

Запускает подключение к сети с networkGuid.

Параметры

  • networkGuid

    нить

    GUID сети, к которой нужно подключиться.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

startDisconnect()

Обещать
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

Запускает отключение от сети с networkGuid.

Параметры

  • networkGuid

    нить

    GUID сети, от которой требуется отключиться.

  • перезвонить

    функция необязательна

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 125+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

События

onDeviceStateListChanged

chrome.networking.onc.onDeviceStateListChanged.addListener(
  callback: function,
)

Срабатывает при изменении списка устройств или изменении каких-либо свойств состояния устройства.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    () => void

onNetworkListChanged

chrome.networking.onc.onNetworkListChanged.addListener(
  callback: function,
)

Срабатывает при изменении списка сетей. Отправляет полный список идентификаторов GUID для всех текущих сетей.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (changes: string[]) => void

    • изменения

      нить[]

onNetworksChanged

chrome.networking.onc.onNetworksChanged.addListener(
  callback: function,
)

Срабатывает при изменении свойств любой из сетей. Отправляет список идентификаторов GUID для сетей, свойства которых изменились.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (changes: string[]) => void

    • изменения

      нить[]

onPortalDetectionCompleted

chrome.networking.onc.onPortalDetectionCompleted.addListener(
  callback: function,
)

Срабатывает после завершения обнаружения портала в сети. Отправляет GUID сети и соответствующий статус портала захвата.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит так: 

    (networkGuid: string, status: CaptivePortalStatus) => void