@react-native-community/netinfo

@react-native-community/netinfo

React Native Network Info API for Android & iOS. It allows you to get information on:

• Connection type
• Connection quality

Getting started

Install the library using either Yarn:

yarn add @react-native-community/netinfo

or npm:

npm install --save @react-native-community/netinfo

You then need to link the native parts of the library for the platforms you are using. The easiest way to link the library is using the CLI tool by running this command from the root of your project:

react-native link @react-native-community/netinfo

If you can't or don't want to use the CLI tool, you can also manually link the library using the instructions below (click on the arrow to show them):

pod 'react-native-netinfo', :path => '../node_modules/@react-native-community/netinfo'

include ':react-native-community-netinfo'
project(':react-native-community-netinfo').projectDir = new File(rootProject.projectDir, '../node_modules/@react-native-community/netinfo/android')

dependencies {
   ...
   implementation project(':react-native-community-netinfo')
}

import com.reactnativecommunity.netinfo.NetInfoPackage;

@Override
protected List<ReactPackage> getPackages() {
    return Arrays.asList(
            new MainReactPackage(),
            new NetInfoPackage()
    );
}

Migrating from the core react-native module

This module was created when the NetInfo was split out from the core of React Native. To migrate to this module you need to follow the installation instructions above and then change you imports from:

import { NetInfo } from "react-native";

to:

import NetInfo from "@react-native-community/netinfo";

Note that the API was updated after it was extracted from NetInfo to support some new features, however, the previous API is still available and works with no updates to your code.

Usage

Import the library:

import NetInfo from "@react-native-community/netinfo";

Get the network state once:

NetInfo.fetch().then(state => {
  console.log("Connection type", state.type);
  console.log("Is connected?", state.isConnected);
});

Subscribe to network state updates:

// Subscribe
const subscription = NetInfo.addEventListener(state => {
  console.log("Connection type", state.type);
  console.log("Is connected?", state.isConnected);
});

// Unsubscribe
subscription();

API

• Types:
  • NetInfoState
  • NetInfoStateType
  • NetInfoCellularGeneration
• Methods:
  • fetch()
  • addEventListener()
  • useNetInfo()

Types

NetInfoState

Describes the current state of the network. It is an object with these properties:

The details value depends on the type value.

type is none or unknown

details is null.

type is wifi, blueeooth, ethernet, or wimax

details has these properties:

type is cellular

details has these properties:

NetInfoStateType

Describes the current type of network connection. It is an enum with these possible values:

NetInfoCellularGeneration

Describes the current generation of the cellular connection. It is an enum with these possible values:

Methods

fetch()

Returns a Promise that resolves to a NetInfoState object.

Example:

NetInfo.fetch().then(state => {
  console.log("Connection type", state.type);
  console.log("Is connected?", state.isConnected);
});

addEventListener()

Subscribe to connection information. The callback is called with a parameter of type NetInfoState whenever the connection state changes. Your listener will be called with the latest information soon after you subscribe and then with any subsequent changes afterwards. You should not assume that the listener is called in the same way across devices or platforms.

Example:

// Subscribe
const subscription = NetInfo.addEventListener(state => {
  console.log("Connection type", state.type);
  console.log("Is connected?", state.isConnected);
});

// Unsubscribe
subscription.remove();

useNetInfo()

A React Hook which can be used to get access to the latest state. It returns a hook with the NetInfoState type.

Example:

import {useNetInfo} from "@react-native-community/netinfo";

const YourComplement = () => {
  const netInfo = useNetInfo();

  return (
    <View>
      <Text>Type: {netInfo.type}</Text>
      <Text>Is Connected? {netInfo.isConnected}</Text>
    </View>
  );
};

Known issues with the iOS simulator

There is a known issue with the iOS Simulator which causes it to not receive network change notifications correctly when the host machine disconnects and then connects to Wifi. If you are having issues with iOS then please test on an actual device before reporting any bugs.

Maintainers

• Matt Oakes - Freelance React Native Developer
• Mike Diarmid - Invertase

Contributing

Please see the contributing guide.

License

The library is released under the MIT license. For more information see LICENSE.