chrome.networking.onc

Описание

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

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

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

Разрешения

networking.onc

Доступность

Chrome 59+ только для ChromeOS

Типы

ActivationStateType

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

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

«Активация»

"Не активирован"

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

CaptivePortalStatus

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

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

"Не в сети"

"В сети"

"Портал"

«ПроксиАутРекуирд»

CellularProperties

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

  • Состояние активации

    Тип активацииStateType необязательный

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

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

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

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

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

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

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

  • Автоподключение

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

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

  • Семья

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

    Семейство технологий сотовой связи — CDMA или GSM .

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

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

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

  • Найденные сети

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

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

  • Версия оборудования

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

    Версия аппаратного обеспечения сотового модема.

  • ГлавнаяПровайдер

    CellularProviderProperties необязательный

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

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

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

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

  • Идентификатор модели

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

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

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

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

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

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

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

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

  • Роумингстате

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

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

  • SIMLockStatus

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

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

  • SIMPresent

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

    Присутствует ли SIM-карта.

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

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

    Хром 63+

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

  • Обслуживающийоператор

    CellularProviderProperties необязательный

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

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

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

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

  • ПоддержкаNetworkScan

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

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

CellularProviderProperties

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

  • Код

    нить

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

  • Страна

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

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

  • Имя

    нить

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

CellularStateProperties

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

CertificatePattern

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

  • РегистрацияURI

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

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

  • Эмитент

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

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

  • ЭмитентCARef

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

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

  • Предмет

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

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

ClientCertificateType

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

"Реф"

"Шаблон"

ConnectionStateType

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

"Связанный"

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

"Не подключен"

DeviceStateProperties

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

  • SIMLockStatus

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

    Хром 62+

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

  • SIMPresent

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

    Хром 62+

    Установите состояние присутствия SIM-карты, если тип устройства — «Сотовое».

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

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

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

  • Состояние

    Девицестатетипе

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

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

DeviceStateType

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

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

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

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

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

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

EAPProperties

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

  • АнонимнаяИдентификация

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

  • КлиентцертПККС11ид

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

    Хром 60+
  • Клиентсертпаттерн

    СертификатPattern необязательно

  • ClientCertProvisioningProfileId

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

    Хром 93+
  • Клиентсертреф

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

  • Клиентсерттипе

    Клиентсертификатетипе

  • Личность

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

  • Внутренний

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

  • Внешний

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

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

  • Пароль

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

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

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

  • СерверCAPEM

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

  • СерверCARefs

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

  • ТемаМатч

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

    Хром 60+
  • Использовать ProactiveKeyCaching

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

  • UseSystemCAs

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

EthernetProperties

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

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

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

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

  • Автоподключение

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

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

  • EAP

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

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

EthernetStateProperties

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

FoundNetworkProperties

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

  • Длинное имя

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

    Полное имя оператора сети.

  • идентификатор сети

    нить

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

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

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

    Краткое имя оператора сети.

  • Положение дел

    нить

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

  • Технологии

    нить

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

GlobalPolicy

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

  • Алловонлиполицинетворкстоаутоконнект

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

    Если это правда, только сети политик могут подключаться автоматически. По умолчанию ложь.

  • Алловонлиполицинетворкстоконнект

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

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

  • Алловонлиполицинетворкстоконнектифаваилабле

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

    Хром 70+

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

  • БлокированныеHexSSID

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

    Хром 86+

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

IPConfigProperties

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

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

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

    Хром 76+

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

  • шлюз

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

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

  • Айпи адрес

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

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

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

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

    Хром 76+

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

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

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

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

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

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

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

  • Поиск доменов

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

    Хром 76+

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

  • Тип

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

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

  • Вебпроксиавтодисковериурл

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

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

IPConfigType

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

"ДХКП"

«Статический»

IssuerSubjectPattern

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

  • Распространенное имя

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

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

  • Местонахождение

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

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

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

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

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

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

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

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

ManagedBoolean

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

  • Активный

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

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

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

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

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

  • Политика устройства

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

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

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

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

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

  • Общая настройка

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

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

  • Редактируемый пользователем

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

    Существует ли UserPolicy для свойства и разрешено ли его редактирование (т. е. политика устанавливает рекомендуемое значение свойства). По умолчанию установлено значение false .

  • Пользовательская политика

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

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

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

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

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

ManagedCellularProperties

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

ManagedDOMString

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

  • Активный

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

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

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

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

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

  • Политика устройства

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

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

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

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

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

  • Общая настройка

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

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

  • Редактируемый пользователем

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

    Существует ли UserPolicy для свойства и разрешено ли его редактирование (т. е. политика устанавливает рекомендуемое значение свойства). По умолчанию установлено значение false .

  • Пользовательская политика

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

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

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

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

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

ManagedDOMStringList

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

  • Активный

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

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

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

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

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

  • Политика устройства

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

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

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

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

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

  • Общая настройка

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

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

  • Редактируемый пользователем

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

    Существует ли UserPolicy для свойства и разрешено ли его редактирование (т. е. политика устанавливает рекомендуемое значение свойства). По умолчанию установлено значение false .

  • Пользовательская политика

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

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

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

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

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

ManagedEthernetProperties

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

ManagedIPConfigProperties

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

ManagedIPConfigType

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

  • Активный

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

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

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

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

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

  • Политика устройства

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

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

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

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

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

  • Общая настройка

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

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

  • Редактируемый пользователем

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

    Существует ли UserPolicy для свойства и разрешено ли его редактирование (т. е. политика устанавливает рекомендуемое значение свойства). По умолчанию установлено значение false .

  • Пользовательская политика

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

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

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

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

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

ManagedLong

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

  • Активный

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

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

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

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

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

  • Политика устройства

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

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

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

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

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

  • Общая настройка

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

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

  • Редактируемый пользователем

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

    Существует ли UserPolicy для свойства и разрешено ли его редактирование (т. е. политика устанавливает рекомендуемое значение свойства). По умолчанию установлено значение false .

  • Пользовательская политика

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

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

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

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

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

ManagedManualProxySettings

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

ManagedProperties

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

ManagedProxyLocation

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

ManagedProxySettings

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

ManagedProxySettingsType

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

  • Активный

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

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

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

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

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

  • Политика устройства

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

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

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

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

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

  • Общая настройка

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

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

  • Редактируемый пользователем

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

    Существует ли UserPolicy для свойства и разрешено ли его редактирование (т. е. политика устанавливает рекомендуемое значение свойства). По умолчанию установлено значение false .

  • Пользовательская политика

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

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

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

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

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

ManagedThirdPartyVPNProperties

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

ManagedVPNProperties

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

ManagedWiFiProperties

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

ManualProxySettings

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

NetworkConfigProperties

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

NetworkFilter

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

  • настроен

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

    Если это правда, включать только настроенные (сохраненные) сети. По умолчанию установлено значение «ложь».

  • предел

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

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

  • тип сети

    Тип сети

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

  • видимый

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

    Если это правда, включать только видимые (физически подключенные или находящиеся в радиусе действия) сети. По умолчанию установлено значение «ложь».

NetworkProperties

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

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

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

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

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

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

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

  • Состояние соединения

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

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

  • Эрростате

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

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

  • Ethernet

    Свойства Ethernet необязательно

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

  • ГУИД

    нить

    Сетевой GUID.

  • IP-адресконфигтипе

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

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

  • IPConfigs

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

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

  • MAC-адрес

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

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

  • Измеренный

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

    Хром 85+

    Является ли сеть измеренной.

  • Имя

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

    Удобное сетевое имя.

  • ИмяServersConfigType

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

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

  • Приоритет

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

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

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

    Настройки прокси необязательно

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

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

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

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

  • СохраненоIPConfig

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

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

  • Источник

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

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

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

  • СтатическийIPConfig

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

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

  • Трафиккаунтерресеттиме

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

    В ожидании

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

  • Тип сети.

  • VPN

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

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

  • Wi-Fi

    Свойства WiFi необязательно

    Для сетей Wi-Fi — свойства сети Wi-Fi.

NetworkStateProperties

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

NetworkType

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

"Все"

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

«Этернет»

"Тетер"

«ВПН»

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

"Wi-Fi"

PaymentPortal

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

  • Метод

    нить

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

  • PostData

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

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

  • URL

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

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

ProxyLocation

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

  • Хозяин

    нить

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

  • Порт

    число

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

ProxySettings

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

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

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

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

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

    Ручные настройки прокси необязательно

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

  • ПКК

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

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

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

ProxySettingsType

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

"Прямой"

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

"ПАК"

"ВПАД"

SIMLockStatus

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

  • Блокировка включена

    логическое значение

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

  • Тип блокировки

    нить

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

  • Повторы влево

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

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

ThirdPartyVPNProperties

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

  • идентификатор расширения

    нить

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

  • Имя провайдера

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

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

VPNProperties

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

  • Автоподключение

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

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

  • Хозяин

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

    VPN-хост.

  • Тип

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

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

VPNStateProperties

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

WiFiProperties

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

  • Разрешить шлюзARPPolling

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

    Разрешен ли опрос ARP шлюза по умолчанию. По умолчанию истинно.

  • Автоподключение

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

    Должна ли сеть Wi-Fi подключаться автоматически, когда она находится в зоне действия.

  • БССИД

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

    BSSID связанной точки доступа.

  • EAP

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

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

  • Частота

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

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

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

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

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

  • ШестнадцатеричныйSSID

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

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

  • СкрытыйSSID

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

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

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

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

    Хром 66+

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

  • Порог роуминга

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

    Устарело, игнорируется.

  • SSID

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

    SSID сети.

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

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

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

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

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

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

WiFiStateProperties

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

WiMAXProperties

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

  • Автоподключение

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

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

  • EAP

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

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

Методы

createNetwork()

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

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

Параметры

  • общий

    логическое значение

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

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

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

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

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

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

    (result: string)=>void

    • результат

      нить

Возврат

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

    В ожидании

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

disableNetworkType()

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

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

Параметры

  • тип сети

    Тип сети

    Тип сети, которую нужно отключить.

enableNetworkType()

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

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

Параметры

  • тип сети

    Тип сети

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

forgetNetwork()

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

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

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

Параметры

  • сетевой гид

    нить

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

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

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

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

    ()=>void

Возврат

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

    В ожидании

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

getCaptivePortalStatus()

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

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

Параметры

  • сетевой гид

    нить

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

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

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

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

    (result: CaptivePortalStatus)=>void

Возврат

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

    В ожидании

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

getDeviceStates()

Обещать
chrome.networking.onc.getDeviceStates(
  callback?: function,
)

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

Параметры

Возврат

  • Обещание< DeviceStateProperties []>

    В ожидании

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

getGlobalPolicy()

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

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

Параметры

Возврат

  • В ожидании

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

getManagedProperties()

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

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

Параметры

  • сетевой гид

    нить

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

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

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

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

    (result: ManagedProperties)=>void

Возврат

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

    В ожидании

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

getNetworks()

Обещать
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
)

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

Параметры

Возврат

  • Обещание< NetworkStateProperties []>

    В ожидании

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

getProperties()

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

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

Параметры

  • сетевой гид

    нить

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

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

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

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

    (result: NetworkProperties)=>void

Возврат

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

    В ожидании

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

getState()

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

Получил кэшированные свойства считывания сети с ID NetworkGuid. Это предназначено для более высокой функции производительности, чем getProperties , которая требует поездки туда и обратно, чтобы запросить сетевую подсистему. Следующие свойства возвращаются для всех сетей: GUID, тип, имя, WiFi.security. Дополнительные свойства предоставляются для видимых сетей: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetWorkTechnology, Cellular.ActivationState, Cellular.RamingState.

Параметры

  • NetworkGuid

    нить

    GUID сети, чтобы получить свойства.

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

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

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

    (result: NetworkStateProperties)=>void

Возврат

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

    В ожидании

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

requestNetworkScan()

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

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

Параметры

  • тип сети

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

    Хром 63+

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

setProperties()

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

Устанавливает свойства сети с ID networkGuid . Это действительно только для настроенных сетей (источник! = Нет). Незаконфигурированные видимые сети должны вместо этого использовать createNetwork . На сеансах киоска вызов этого метода в общей сети потерпит неудачу.

Параметры

  • NetworkGuid

    нить

    GUID сети для установления свойств для.

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

    NetworkConfigProperties

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

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

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

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

    ()=>void

Возврат

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

    В ожидании

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

startConnect()

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

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

Параметры

  • NetworkGuid

    нить

    GUID сети для подключения.

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

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

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

    ()=>void

Возврат

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

    В ожидании

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

startDisconnect()

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

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

Параметры

  • NetworkGuid

    нить

    GUID сети для отключения от.

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

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

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

    ()=>void

Возврат

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

    В ожидании

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

События

onDeviceStateListChanged

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

Уволен, когда изменился список устройств, или любые свойства состояния устройства изменились.

Параметры

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

    функция

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

    ()=>void

onNetworkListChanged

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

Уволен, когда изменился список сетей. Отправляет полный список гид для всех текущих сетей.

Параметры

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

    функция

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

    (changes: string[])=>void

    • изменения

      нить[]

onNetworksChanged

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

Уволен, когда свойства меняются в любой из сетей. Отправляет список гид для сетей, чьи свойства изменились.

Параметры

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

    функция

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

    (changes: string[])=>void

    • изменения

      нить[]

onPortalDetectionCompleted

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

Уволен, когда завершается обнаружение портала для сети. Отправляет GUID сети и соответствующий статус портала в неволе.

Параметры

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

    функция

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

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