chromex.app.networking.onc — binaryage/chromex 0.9.3

clj

The chrome.networking.onc API is used for configuring network connections (Cellular, Ethernet, VPN or WiFi). This API is available in auto-launched Chrome OS kiosk sessions.

Network connection configurations are specified following

Open Network Configuration (ONC) specification.

NOTE: Most dictionary properties and enum values use UpperCamelCase to match the ONC specification instead of the JavaScript lowerCamelCase convention.

• available since Chrome 59
• https://developer.chrome.com/apps/networking.onc

api-table clj

create-network clj/s macro

(create-network shared properties)

Creates a new network configuration from properties. If a matching configured network already exists, this will fail. Otherwise returns the GUID of the new network.

|shared| - If true, share this network configuration with other users. This option is exposed only to Chrome's Web UI. When called by apps, false is the only allowed value. |properties| - The properties to configure the new network with.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-createNetwork.

create-network* cljs

(create-network* config shared properties)

disable-network-type clj/s macro

(disable-network-type network-type)

Disables any devices matching the specified network type. See note for 'enableNetworkType'.

|network-type| - The type of network to disable.

https://developer.chrome.com/apps/networking.onc#method-disableNetworkType.

disable-network-type* cljs

(disable-network-type* config network-type)

enable-network-type clj/s macro

(enable-network-type network-type)

Enables any devices matching the specified network type. Note, the type might represent multiple network types (e.g. 'Wireless').

|network-type| - The type of network to enable.

https://developer.chrome.com/apps/networking.onc#method-enableNetworkType.

enable-network-type* cljs

(enable-network-type* config network-type)

forget-network clj/s macro

(forget-network network-guid)

Forgets a network configuration by clearing any configured properties for the network with GUID networkGuid. This may also include any other networks with matching identifiers (e.g. WiFi SSID and Security). If no such configuration exists, an error will be set and the operation will fail. In kiosk sessions, this method will not be able to forget shared network configurations.

|network-guid| - The GUID of the network to forget.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [].

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-forgetNetwork.

forget-network* cljs

(forget-network* config network-guid)

gen-call clj

gen-wrap clj/s macro

(gen-wrap kind item-id config & args)

get-captive-portal-status clj/s macro

(get-captive-portal-status network-guid)

Returns captive portal status for the network matching 'networkGuid'.

|network-guid| - The GUID of the network to get captive portal status for.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-getCaptivePortalStatus.

get-captive-portal-status* cljs

(get-captive-portal-status* config network-guid)

get-device-states clj/s macro

(get-device-states)

Returns states of available networking devices.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-getDeviceStates.

get-device-states* cljs

(get-device-states* config)

get-global-policy clj/s macro

(get-global-policy)

Gets the global policy properties. These properties are not expected to change during a session.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-getGlobalPolicy.

get-global-policy* cljs

(get-global-policy* config)

get-managed-properties clj/s macro

(get-managed-properties network-guid)

Gets the merged properties of the network with id networkGuid from the sources: User settings, shared settings, user policy, device policy and the currently active settings.

|network-guid| - The GUID of the network to get properties for.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-getManagedProperties.

get-managed-properties* cljs

(get-managed-properties* config network-guid)

get-networks clj/s macro

(get-networks filter)

Returns a list of network objects with the same properties provided by 'getState'. A filter is provided to specify the type of networks returned and to limit the number of networks. Networks are ordered by the system based on their priority, with connected or connecting networks listed first.

|filter| - Describes which networks to return.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-getNetworks.

get-networks* cljs

(get-networks* config filter)

get-properties clj/s macro

(get-properties network-guid)

Gets all the properties of the network with id networkGuid. Includes all properties of the network (read-only and read/write values).

|network-guid| - The GUID of the network to get properties for.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-getProperties.

get-properties* cljs

(get-properties* config network-guid)

get-state clj/s macro

(get-state network-guid)

Gets the cached read-only properties of the network with id networkGuid. This is meant to be a higher performance function than 'getProperties', which requires a round trip to query the networking subsystem. The following properties are returned for all networks: GUID, Type, Name, WiFi.Security. Additional properties are provided for visible networks: ConnectionState, ErrorState, WiFi.SignalStrength, Cellular.NetworkTechnology, Cellular.ActivationState, Cellular.RoamingState.

|network-guid| - The GUID of the network to get properties for.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [result] where:

|result| - https://developer.chrome.com/apps/networking.onc#property-callback-result.

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-getState.

get-state* cljs

(get-state* config network-guid)

on-device-state-list-changed* cljs

(on-device-state-list-changed* config channel & args)

on-network-list-changed* cljs

(on-network-list-changed* config channel & args)

on-networks-changed* cljs

(on-networks-changed* config channel & args)

on-portal-detection-completed* cljs

(on-portal-detection-completed* config channel & args)

request-network-scan clj/s macro

(request-network-scan)

(request-network-scan network-type)

Requests that the networking subsystem scan for new networks and update the list returned by 'getVisibleNetworks'. This is only a request: the network subsystem can choose to ignore it. If the list is updated, then the 'onNetworkListChanged' event will be fired.

|network-type| - If provided, requests a scan specific to the type. For Cellular a mobile network scan will be requested if supported.

https://developer.chrome.com/apps/networking.onc#method-requestNetworkScan.

request-network-scan* cljs

(request-network-scan* config network-type)

set-properties clj/s macro

(set-properties network-guid properties)

Sets the properties of the network with id |networkGuid|. This is only valid for configured networks (Source != None). Unconfigured visible networks should use 'createNetwork' instead. In kiosk sessions, calling this method on a shared network will fail.

|network-guid| - The GUID of the network to set properties for. |properties| - The properties to set.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [].

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-setProperties.

set-properties* cljs

(set-properties* config network-guid properties)

start-connect clj/s macro

(start-connect network-guid)

Starts a connection to the network with networkGuid.

|network-guid| - The GUID of the network to connect to.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [].

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-startConnect.

start-connect* cljs

(start-connect* config network-guid)

start-disconnect clj/s macro

(start-disconnect network-guid)

Starts a disconnect from the network with networkGuid.

|network-guid| - The GUID of the network to disconnect from.

This function returns a core.async channel of type promise-chan which eventually receives a result value. Signature of the result value put on the channel is [].

In case of an error the channel closes without receiving any value and relevant error object can be obtained via chromex.error/get-last-error.

https://developer.chrome.com/apps/networking.onc#method-startDisconnect.

start-disconnect* cljs

(start-disconnect* config network-guid)

tap-all-events clj/s macro

(tap-all-events chan)

Taps all valid non-deprecated events in chromex.app.networking.onc namespace.

tap-on-device-state-list-changed-events clj/s macro

(tap-on-device-state-list-changed-events channel & args)

Fired when the list of devices has changed or any device state properties have changed.

Events will be put on the |channel| with signature [::on-device-state-list-changed []].

Note: |args| will be passed as additional parameters into Chrome event's .addListener call.

https://developer.chrome.com/apps/networking.onc#event-onDeviceStateListChanged.

tap-on-network-list-changed-events clj/s macro

(tap-on-network-list-changed-events channel & args)

Fired when the list of networks has changed. Sends a complete list of GUIDs for all the current networks.

Events will be put on the |channel| with signature [::on-network-list-changed [changes]] where:

|changes| - https://developer.chrome.com/apps/networking.onc#property-onNetworkListChanged-changes.

Note: |args| will be passed as additional parameters into Chrome event's .addListener call.

https://developer.chrome.com/apps/networking.onc#event-onNetworkListChanged.

tap-on-networks-changed-events clj/s macro

(tap-on-networks-changed-events channel & args)

Fired when the properties change on any of the networks. Sends a list of GUIDs for networks whose properties have changed.

Events will be put on the |channel| with signature [::on-networks-changed [changes]] where:

|changes| - https://developer.chrome.com/apps/networking.onc#property-onNetworksChanged-changes.

Note: |args| will be passed as additional parameters into Chrome event's .addListener call.

https://developer.chrome.com/apps/networking.onc#event-onNetworksChanged.

tap-on-portal-detection-completed-events clj/s macro

(tap-on-portal-detection-completed-events channel & args)

Fired when a portal detection for a network completes. Sends the GUID of the network and the corresponding captive portal status.

Events will be put on the |channel| with signature [::on-portal-detection-completed [network-guid status]] where:

|network-guid| - https://developer.chrome.com/apps/networking.onc#property-onPortalDetectionCompleted-networkGuid. |status| - https://developer.chrome.com/apps/networking.onc#property-onPortalDetectionCompleted-status.

Note: |args| will be passed as additional parameters into Chrome event's .addListener call.

https://developer.chrome.com/apps/networking.onc#event-onPortalDetectionCompleted.