@capacitor/network
TypeScript icon, indicating that this package has built-in type declarations

6.0.0 • Public • Published

@capacitor/network

The Network API provides network and connectivity information.

Install

npm install @capacitor/network
npx cap sync

Example

import { Network } from '@capacitor/network';

Network.addListener('networkStatusChange', status => {
  console.log('Network status changed', status);
});

const logCurrentNetworkStatus = async () => {
  const status = await Network.getStatus();

  console.log('Network status:', status);
};

API

getStatus()

getStatus() => Promise<ConnectionStatus>

Query the current status of the network connection.

Returns: Promise<ConnectionStatus>

Since: 1.0.0


addListener('networkStatusChange', ...)

addListener(eventName: 'networkStatusChange', listenerFunc: ConnectionStatusChangeListener) => Promise<PluginListenerHandle>

Listen for changes in the network connection.

Param Type
eventName 'networkStatusChange'
listenerFunc ConnectionStatusChangeListener

Returns: Promise<PluginListenerHandle>

Since: 1.0.0


removeAllListeners()

removeAllListeners() => Promise<void>

Remove all listeners (including the network status changes) for this plugin.

Since: 1.0.0


Interfaces

ConnectionStatus

Represents the state and type of the network connection.

Prop Type Description Since
connected boolean Whether there is an active connection or not. 1.0.0
connectionType ConnectionType The type of network connection currently in use. If there is no active network connection, connectionType will be 'none'. 1.0.0

PluginListenerHandle

Prop Type
remove () => Promise<void>

Type Aliases

ConnectionType

The type of network connection that a device might have.

'wifi' | 'cellular' | 'none' | 'unknown'

ConnectionStatusChangeListener

Callback to receive the status change notifications.

(status: ConnectionStatus): void

Dependencies (0)

    Dev Dependencies (14)

    Package Sidebar

    Install

    npm i @capacitor/network

    Weekly Downloads

    66,100

    Version

    6.0.0

    License

    MIT

    Unpacked Size

    75.2 kB

    Total Files

    28

    Last publish

    Collaborators

    • dtarnawsky
    • mark-ionic
    • itschaced
    • it_mike_s
    • jpender
    • ionicjs
    • jcesarmobile