chromex.app.networking.config — binaryage/chromex 0.6.5

clj

Use the networking.config API to authenticate to captive portals.

• available since Chrome 42
• https://developer.chrome.com/apps/networking.config

api-table clj

finish-authentication clj/s macro

(finish-authentication guid result)

Called by the extension to notify the network config API that it finished a captive portal authentication attempt and hand over the result of the attempt. This function must only be called with the GUID of the latest 'onCaptivePortalDetected' event.

|guid| - Unique network identifier obtained from 'onCaptivePortalDetected'. |result| - The result of the authentication attempt.

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.config#method-finishAuthentication.

finish-authentication* cljs

(finish-authentication* config guid result)

gen-call clj

gen-wrap clj/s macro

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

on-captive-portal-detected* cljs

(on-captive-portal-detected* config channel & args)

set-network-filter clj/s macro

(set-network-filter networks)

Allows an extension to define network filters for the networks it can handle. A call to this function will remove all filters previously installed by the extension before setting the new list.

|networks| - Network filters to set. Every NetworkInfo must either have the SSID or HexSSID set. Other fields will be ignored.

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.config#method-setNetworkFilter.

set-network-filter* cljs

(set-network-filter* config networks)

tap-all-events clj/s macro

(tap-all-events chan)

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

tap-on-captive-portal-detected-events clj/s macro

(tap-on-captive-portal-detected-events channel & args)

This event fires everytime a captive portal is detected on a network matching any of the currently registered network filters and the user consents to use the extension for authentication. Network filters may be set using the 'setNetworkFilter'. Upon receiving this event the extension should start its authentication attempt with the captive portal. When the extension finishes its attempt, it must call 'finishAuthentication' with the GUID received with this event and the appropriate authentication result.

Events will be put on the |channel| with signature [::on-captive-portal-detected [network-info]] where:

|network-info| - Information about the network on which a captive portal was detected.

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

https://developer.chrome.com/apps/networking.config#event-onCaptivePortalDetected.