chrome.networking.onc

Описание

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

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

NOTE Большинство свойств словаря и значений перечисления используют UpperCamelCase, чтобы соответствовать спецификации ONC, а не соглашению JavaScript lowerCamelCase.

Разрешения

networking.onc

Доступность

Chrome 59 и более поздних версий Только для ChromeOS

Типы

ActivationStateType

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

"Активировано"

"Активация"

"NotActivated"

"PartiallyActivated"

CaptivePortalStatus

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

"Unknown"

"Офлайн"

"Онлайн"

"Портал"

"ProxyAuthRequired"

CellularProperties

Свойства

  • ActivationState

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

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

  • ActivationType

    Строка (необязательно)

    Тип активации мобильной сети.

  • AllowRoaming

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

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

  • AutoConnect

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

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

  • Семейные программы

    Строка (необязательно)

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

  • FirmwareRevision

    Строка (необязательно)

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

  • FoundNetworks

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

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

  • HardwareRevision

    Строка (необязательно)

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

  • HomeProvider

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

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

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

    Строка (необязательно)

    Производитель модема сотовой связи.

  • ModelID

    Строка (необязательно)

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

  • NetworkTechnology

    Строка (необязательно)

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

  • PaymentPortal

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

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

  • RoamingState

    Строка (необязательно)

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

  • SIMLockStatus

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

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

  • SIMPresent

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

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

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

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

    Chrome 63 и более поздних версий;

    True, если выполняется сканирование мобильной сети.

  • ServingOperator

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

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

  • SignalStrength

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

    Текущий уровень сигнала сети.

  • SupportNetworkScan

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

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

CellularProviderProperties

Свойства

  • Код

    string

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

  • Страна

    Строка (необязательно)

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

  • Название

    string

    Название оператора.

CellularStateProperties

Свойства

CertificatePattern

Свойства

  • EnrollmentURI

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

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

  • Издатель

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

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

  • IssuerCARef

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

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

  • Тема

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

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

ClientCertificateType

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

"Ref"

"Pattern"

ConnectionStateType

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

"Подключено"

"Подключение"

"NotConnected"

DeviceStateProperties

Свойства

  • SIMLockStatus

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

    Chrome 62 и более поздних версий

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

  • SIMPresent

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

    Chrome 62 и более поздних версий

    Если тип устройства – Cellular, задайте значение, соответствующее наличию SIM-карты.

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

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

    Укажите, включено ли устройство. True, если устройство сейчас сканирует.

  • Штат

    DeviceStateType

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

  • Тип

    NetworkType

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

DeviceStateType

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

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

Отключено
Устройство инициализировано, но не включено.

Enabling (Включается)
Запрошено включение, но процесс ещё не завершен.

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

Prohibited
Устройство запрещено.

EAPProperties

Свойства

  • AnonymousIdentity

    Строка (необязательно)

  • ClientCertPKCS11Id

    Строка (необязательно)

    Chrome 60 и более поздних версий;
  • ClientCertPattern

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

  • ClientCertProvisioningProfileId

    Строка (необязательно)

    Chrome 93 и более поздних версий
  • ClientCertRef

    Строка (необязательно)

  • ClientCertType

    ClientCertificateType

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

    Строка (необязательно)

  • Внутреннее

    Строка (необязательно)

  • Внешний

    Строка (необязательно)

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

  • Пароль

    Строка (необязательно)

  • SaveCredentials

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

  • ServerCAPEMs

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

  • ServerCARefs

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

  • SubjectMatch

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

    Chrome 60 и более поздних версий;
  • UseProactiveKeyCaching

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

  • UseSystemCAs

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

EthernetProperties

Свойства

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

    Строка (необязательно)

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

  • AutoConnect

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

    Определяет, должно ли устройство автоматически подключаться к сети Ethernet.

  • Ранний доступ

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

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

EthernetStateProperties

Свойства

FoundNetworkProperties

Свойства

  • LongName

    Строка (необязательно)

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

  • NetworkId

    string

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

  • ShortName

    Строка (необязательно)

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

  • Статус

    string

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

  • Технологии

    string

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

GlobalPolicy

Свойства

  • AllowOnlyPolicyNetworksToAutoconnect

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

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

  • AllowOnlyPolicyNetworksToConnect

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

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

  • AllowOnlyPolicyNetworksToConnectIfAvailable

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

    Chrome 70 и более поздних версий;

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

  • BlockedHexSSIDs

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

    Chrome 86 и более поздних версий.

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

IPConfigProperties

Свойства

  • ExcludedRoutes

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

    Chrome 76 и более поздних версий;

    Массив блоков IP-адресов в нотации CIDR. Подробную информацию можно найти в файле onc_spec.md.

  • Шлюз

    Строка (необязательно)

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

  • IPAddress

    Строка (необязательно)

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

  • IncludedRoutes

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

    Chrome 76 и более поздних версий;

    Массив блоков IP-адресов в нотации CIDR. Подробную информацию можно найти в файле onc_spec.md.

  • NameServers

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

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

  • RoutingPrefix

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

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

  • SearchDomains

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

    Chrome 76 и более поздних версий;

    Массив строк для разрешения имен. Подробную информацию можно найти в файле onc_spec.md.

  • Тип

    Строка (необязательно)

    Тип конфигурации IP-адреса. Допустимые значения: IPv4 или IPv6.

  • WebProxyAutoDiscoveryUrl

    Строка (необязательно)

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

IPConfigType

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

DHCP

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

IssuerSubjectPattern

Свойства

  • CommonName

    Строка (необязательно)

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

  • Населенный пункт

    Строка (необязательно)

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

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

    Строка (необязательно)

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

  • OrganizationalUnit

    Строка (необязательно)

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

ManagedBoolean

Свойства

  • Активно

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • Эффективно

    Строка (необязательно)

    Источник, на основе которого было определено действующее значение свойства.

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedCellularProperties

Свойства

ManagedDOMString

Свойства

  • Активно

    Строка (необязательно)

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

  • DeviceEditable

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

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

  • DevicePolicy

    Строка (необязательно)

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

  • Эффективно

    Строка (необязательно)

    Источник, на основе которого было определено действующее значение свойства.

  • SharedSetting

    Строка (необязательно)

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

  • UserEditable

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

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

  • UserPolicy

    Строка (необязательно)

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

  • UserSetting

    Строка (необязательно)

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

ManagedDOMStringList

Свойства

  • Активно

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • Эффективно

    Строка (необязательно)

    Источник, на основе которого было определено действующее значение свойства.

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedEthernetProperties

Свойства

ManagedIPConfigProperties

Свойства

ManagedIPConfigType

Свойства

  • Активно

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • Эффективно

    Строка (необязательно)

    Источник, на основе которого было определено действующее значение свойства.

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedLong

Свойства

  • Активно

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • Эффективно

    Строка (необязательно)

    Источник, на основе которого было определено действующее значение свойства.

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedManualProxySettings

Свойства

ManagedProperties

Свойства

ManagedProxyLocation

Свойства

ManagedProxySettings

Свойства

ManagedProxySettingsType

Свойства

  • Активно

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

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

  • DeviceEditable

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

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

  • DevicePolicy

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

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

  • Эффективно

    Строка (необязательно)

    Источник, на основе которого было определено действующее значение свойства.

  • SharedSetting

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

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

  • UserEditable

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

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

  • UserPolicy

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

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

  • UserSetting

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

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

ManagedThirdPartyVPNProperties

Свойства

ManagedVPNProperties

Свойства

ManagedWiFiProperties

Свойства

ManualProxySettings

Свойства

  • FTPProxy

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

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

  • HTTPProxy

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

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

  • SOCKS

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

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

  • SecureHTTPProxy

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

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

NetworkConfigProperties

Свойства

NetworkFilter

Свойства

  • настроено

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

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

  • лимит

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

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

  • networkType

    NetworkType

    Тип сетей, которые нужно вернуть.

  • отображается

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

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

NetworkProperties

Свойства

  • Мобильная сеть

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

    Для мобильных сетей – свойства мобильной сети.

  • Connectable

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

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

  • ConnectionState

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

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

  • ErrorState

    Строка (необязательно)

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

  • Ethernet

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

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

  • GUID

    string

    Глобальный уникальный идентификатор сети.

  • IPAddressConfigType

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

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

  • IPConfigs

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

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

  • MacAddress

    Строка (необязательно)

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

  • Сеть с тарификацией трафика

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

    Chrome 85 и более поздних версий;

    Используется ли сеть с тарификацией.

  • Название

    Строка (необязательно)

    Понятное название сети.

  • NameServersConfigType

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

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

  • Приоритет

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

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

  • ProxySettings

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

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

  • RestrictedConnectivity

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

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

  • SavedIPConfig

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

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

  • Источник

    Строка (необязательно)

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

    • Device
    • DevicePolicy
    • User
    • UserPolicy
    • None

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

  • StaticIPConfig

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

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

  • TrafficCounterResetTime

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

    Chrome 125 и более поздних версий

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

  • Тип

    NetworkType

    Тип сети.

  • VPN

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

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

  • Wi-Fi

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

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

NetworkStateProperties

Свойства

NetworkType

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

Все

Мобильная сеть

Ethernet

"Tether"

VPN

Беспроводные сети

"WiFi"

PaymentPortal

Свойства

  • Метод

    string

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

  • PostData

    Строка (необязательно)

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

  • URL

    Строка (необязательно)

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

ProxyLocation

Свойства

  • Хост

    string

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

  • Порт

    число

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

ProxySettings

Свойства

  • ExcludeDomains

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

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

  • Вручную

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

    Настройки прокси-сервера вручную – используются только для настроек прокси-сервера Manual.

  • Комитет политических действий (PAC)

    Строка (необязательно)

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

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

ProxySettingsType

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

"Прямой"

"Вручную"

"PAC"

WPAD

SIMLockStatus

Свойства

  • LockEnabled

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

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

  • LockType

    string

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

  • RetriesLeft

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

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

ThirdPartyVPNProperties

Свойства

  • ExtensionID

    string

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

  • ProviderName

    Строка (необязательно)

    Название поставщика VPN-сервиса.

VPNProperties

Свойства

  • AutoConnect

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

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

  • Хост

    Строка (необязательно)

    Хост VPN.

  • Тип

    Строка (необязательно)

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

VPNStateProperties

Свойства

WiFiProperties

Свойства

  • AllowGatewayARPPolling

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

    Устарело с версии Chrome 131

    Удалено в версии M131. В настоящее время активный опрос ARP не выполняется.

  • AutoConnect

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

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

  • BSSID : идентификатор базового набора служб

    Строка (необязательно)

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

  • Ранний доступ

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

    Свойства EAP сети. Обязательно для сетей WEP-8021X и WPA-EAP.

  • Частота

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

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

  • FrequencyList

    number[] optional

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

  • HexSSID

    Строка (необязательно)

    HEX-кодированная копия SSID сети.

  • HiddenSSID

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

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

  • Кодовая фраза

    Строка (необязательно)

    Chrome 66 и более поздних версий;

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

  • RoamThreshold

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

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

  • SSID

    Строка (необязательно)

    SSID сети.

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

    Строка (необязательно)

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

  • SignalStrength

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

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

WiFiStateProperties

Свойства

  • BSSID : идентификатор базового набора служб

    Строка (необязательно)

    Подробнее WiFiProperties.BSSID…

  • Частота

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

    Подробнее WiFiProperties.Frequency…

  • HexSSID

    Строка (необязательно)

    Chrome 62 и более поздних версий

    Подробнее WiFiProperties.HexSSID…

  • SSID

    Строка (необязательно)

    Chrome 62 и более поздних версий

    Подробнее WiFiProperties.SSID…

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

    string

    Подробнее WiFiProperties.Security…

  • SignalStrength

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

    Подробнее WiFiProperties.SignalStrength…

WiMAXProperties

Свойства

  • AutoConnect

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

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

  • Ранний доступ

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

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

Методы

createNetwork()

Promise 
chrome.networking.onc.createNetwork(
  shared: boolean,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<string>

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

Параметры

  • Совместный

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

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

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

  • объекты

    NetworkConfigProperties

    Свойства, которые нужно настроить для новой сети.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: string) => void

    • Результат

      string

Возвраты

  • Promise<string>

    Chrome 125 и более поздних версий

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

disableNetworkType()

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

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

Параметры

  • networkType

    NetworkType

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

enableNetworkType()

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

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

Параметры

  • networkType

    NetworkType

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

forgetNetwork()

Promise 
chrome.networking.onc.forgetNetwork(
  networkGuid: string,
  callback?: function,
): Promise<void>

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

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

Параметры

  • networkGuid

    string

    Глобальный уникальный идентификатор сети, которую нужно удалить.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 125 и более поздних версий

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

getCaptivePortalStatus()

Promise 
chrome.networking.onc.getCaptivePortalStatus(
  networkGuid: string,
  callback?: function,
): Promise<CaptivePortalStatus>

Возвращает статус страницы входа для сети, соответствующей networkGuid.

Параметры

  • networkGuid

    string

    Глобальный уникальный идентификатор сети, для которой нужно получить статус страницы входа.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: CaptivePortalStatus) => void

Возвраты

  • Chrome 125 и более поздних версий

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

getDeviceStates()

Promise 
chrome.networking.onc.getDeviceStates(
  callback?: function,
): Promise<DeviceStateProperties[]>

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

Параметры

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: DeviceStateProperties[]) => void

Возвраты

  • Chrome 125 и более поздних версий

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

getGlobalPolicy()

Promise 
chrome.networking.onc.getGlobalPolicy(
  callback?: function,
): Promise<GlobalPolicy>

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

Параметры

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: GlobalPolicy) => void

Возвраты

  • Promise<GlobalPolicy>

    Chrome 125 и более поздних версий

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

getManagedProperties()

Promise 
chrome.networking.onc.getManagedProperties(
  networkGuid: string,
  callback?: function,
): Promise<ManagedProperties>

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

Параметры

  • networkGuid

    string

    Глобальный уникальный идентификатор сети, свойства которой нужно получить.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: ManagedProperties) => void

Возвраты

  • Chrome 125 и более поздних версий

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

getNetworks()

Promise 
chrome.networking.onc.getNetworks(
  filter: NetworkFilter,
  callback?: function,
): Promise<NetworkStateProperties[]>

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

Параметры

  • фильтр

    NetworkFilter

    Описывает, какие сети нужно вернуть.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: NetworkStateProperties[]) => void

Возвраты

  • Chrome 125 и более поздних версий

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

getProperties()

Promise 
chrome.networking.onc.getProperties(
  networkGuid: string,
  callback?: function,
): Promise<NetworkProperties>

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

Параметры

  • networkGuid

    string

    Глобальный уникальный идентификатор сети, свойства которой нужно получить.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: NetworkProperties) => void

Возвраты

  • Chrome 125 и более поздних версий

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

getState()

Promise 
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

    string

    Глобальный уникальный идентификатор сети, свойства которой нужно получить.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    (result: NetworkStateProperties) => void

Возвраты

  • Chrome 125 и более поздних версий

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

requestNetworkScan()

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

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

Параметры

  • networkType

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

    Chrome 63 и более поздних версий;

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

setProperties()

Promise 
chrome.networking.onc.setProperties(
  networkGuid: string,
  properties: NetworkConfigProperties,
  callback?: function,
): Promise<void>

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

Параметры

  • networkGuid

    string

    Глобальный уникальный идентификатор сети, для которой нужно задать свойства.

  • объекты

    NetworkConfigProperties

    Свойства, которые нужно задать.

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 125 и более поздних версий

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

startConnect()

Promise 
chrome.networking.onc.startConnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

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

Параметры

  • networkGuid

    string

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

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 125 и более поздних версий

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

startDisconnect()

Promise 
chrome.networking.onc.startDisconnect(
  networkGuid: string,
  callback?: function,
): Promise<void>

Отключает от сети с указанным идентификатором networkGuid.

Параметры

  • networkGuid

    string

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

  • обратный вызов

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

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 125 и более поздних версий

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

События

onDeviceStateListChanged

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

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

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    () => void

onNetworkListChanged

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

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

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (changes: string[]) => void

    • Изменения

      string[]

onNetworksChanged

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

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

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (changes: string[]) => void

    • Изменения

      string[]

onPortalDetectionCompleted

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

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

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

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