Connect to Wifi through your capacitor plugin. Good for IoT device connections.
npm install @codext/capacitor-wifiConnect to Wifi through your capacitor plugin. Good for IoT device connections.
Capacitor Version 7
``bash`
npm install @codext/capacitor-wifi
npx cap sync
* scanWifi()
* getCurrentWifi()
* connectToWifiBySsidAndPassword(...)
* connectToWifiBySsidPrefixAndPassword(...)
* checkPermissions()
* requestPermissions()
* disconnectAndForget()
* Interfaces
* Type Aliases
* Enums
`typescript`
scanWifi() => Promise
Returns: Promise<ScanWifiResult>
--------------------
`typescript`
getCurrentWifi() => Promise
Returns: Promise<GetCurrentWifiResult>
--------------------
`typescript`
connectToWifiBySsidAndPassword(connectToWifiRequest: ConnectToWifiRequest) => Promise
| Param | Type |
| -------------------------- | --------------------------------------------------------------------- |
| connectToWifiRequest | ConnectToWifiRequest |
Returns: Promise<ConnectToWifiResult>
--------------------
`typescript`
connectToWifiBySsidPrefixAndPassword(connectToWifiPrefixRequest: ConnectToWifiPrefixRequest) => Promise
| Param | Type |
| -------------------------------- | --------------------------------------------------------------------------------- |
| connectToWifiPrefixRequest | ConnectToWifiPrefixRequest |
Returns: Promise<ConnectToWifiResult>
--------------------
`typescript`
checkPermissions() => Promise
Returns: Promise<PermissionStatus>
--------------------
`typescript`
requestPermissions() => Promise
Returns: Promise<PermissionStatus>
--------------------
`typescript`
disconnectAndForget() => Promise
--------------------
#### ScanWifiResult
| Prop | Type |
| ----------- | ------------------------ |
| wifis | WifiEntry[] |
#### WifiEntry
| Prop | Type |
| ------------------- | ----------------------------- |
| bssid | string |
| capabilities | WifiCapability[] |
| ssid | string |
| level | number |
| isCurrentWifi | boolean |
#### GetCurrentWifiResult
| Prop | Type |
| ----------------- | ----------------------------------------------- |
| currentWifi | WifiEntry |
#### ConnectToWifiResult
| Prop | Type |
| ---------------- | ----------------------------------------------- |
| wasSuccess | true |
| wifi | WifiEntry |
#### ConnectToWifiRequest
| Prop | Type |
| -------------- | ------------------- |
| ssid | string |
| password | string |
#### ConnectToWifiPrefixRequest
| Prop | Type |
| ---------------- | ------------------- |
| ssidPrefix | string |
| password | string |
#### PermissionStatus
| Prop | Type |
| -------------- | ----------------------------------------------------------- |
| LOCATION | PermissionState |
| NETWORK | PermissionState |
#### PermissionState
'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'
#### WifiCapability
| Members | Value |
| ----------------------- | -------------------------------- |
| WPA2_PSK_CCM | 'WPA2-PSK-CCM' |
| RSN_PSK_CCMP | 'RSN-PSK-CCMP' |
| RSN_SAE_CCM | 'RSN-SAE-CCM' |
| WPA2_EAP_SHA1_CCM | 'WPA2-EAP/SHA1-CCM' |
| RSN_EAP_SHA1_CCMP | 'RSN-EAP/SHA1-CCMP' |
| ESS | 'ESS' |
| ES | 'ES' |
| WP | 'WP' |
#### SpecialSsid
| Members | Value |
| ------------ | ---------------------------- |
| HIDDEN` | '[HIDDEN_SSID]' |