import { getNetworkState } from 'react-native-network-state';

const state = await getNetworkState();

console.log(state.isConnected); // true | false
console.log(state.isInternetReachable); // true | false | null
console.log(state.type); // 'wifi' | 'cellular' | 'ethernet' | 'none' | 'unknown'

Listen for changes

import { addNetworkStateListener } from 'react-native-network-state';

const unsubscribe = addNetworkStateListener((state) => {
  console.log('Network changed:', state);
});

// Later
unsubscribe();

React hook

import { useNetworkState } from 'react-native-network-state';

function NetworkBanner() {
  const { isConnected, isInternetReachable, type } = useNetworkState();

  if (!isConnected) {
    return <Text>You are offline</Text>;
  }

  if (isInternetReachable === false) {
    return <Text>Connected, but internet is unreachable</Text>;
  }

  return <Text>Online via {type}</Text>;
}

API

`getNetworkState(): Promise<NetworkState>`

Returns the current network state.

`addNetworkStateListener(handler): () => void`

Registers a listener for network state changes. Returns an unsubscribe function.

`useNetworkState(): NetworkState`

React hook that returns the current state and updates automatically.

`NetworkState`

Property	Type	Description
`isConnected`	`boolean`	Whether a network interface is available
`isInternetReachable`	`boolean \| null`	Whether the internet is reachable (`null` while checking)
`type`	`NetworkType`	Connection type: `wifi`, `cellular`, `ethernet`, `none`, or `unknown`

Requirements

React Native 0.76+
New Architecture enabled (Turbo Modules)

Contributing

License

MIT

Keywords

react-native ios android