react-native-nitro-network-info

A React Native library for monitoring network connectivity status and connection type using Nitro Modules for high performance.

Features

• 🚀 High performance with Nitro Modules
• 📡 Real-time network status monitoring
• 🔄 Connection type detection (WiFi, Cellular, etc.)
• 📱 Cross-platform support (iOS & Android)
• 🎣 React hooks friendly with listeners

Requirements

• React Native v0.76.0 or higher
• Node 18.0.0 or higher

Installation

1bun add react-native-nitro-network-info react-native-nitro-modules

Usage

Basic Usage

1import React, { useEffect, useState } from 'react';
2import { View, Text } from 'react-native';
3import NitroNetworkInfo, {
4  type NitroNetworkStatusInfo
5} from 'react-native-nitro-network-info';
6
7function App() {
8  const [networkInfo, setNetworkInfo] = useState<NitroNetworkStatusInfo | null>(null);
9
10  useEffect(() => {
11    // Add listener for network changes
12    const unsubscribe = NitroNetworkInfo.addListener((networkInfo) => {
13      setNetworkInfo(networkInfo);
14    });
15
16    // Cleanup listener on unmount
17    return () => {
18      unsubscribe();
19    };
20  }, []);
21
22  return (
23    <View>
24      <Text>
25        Status: {NitroNetworkInfo.isConnected ? 'Connected' : 'Disconnected'}
26      </Text>
27      <Text>
28        Type: {NitroNetworkInfo.connectionType || 'Unknown'}
29      </Text>
30      <Text>
31        Network Info: {JSON.stringify(networkInfo, null, 2)}
32      </Text>
33    </View>
34  );
35}

API Reference

Properties

isConnected: boolean

A readonly property that indicates whether the device is currently connected to a network.

1const isConnected = NitroNetworkInfo.isConnected

connectionType: ConnectionType

A readonly property that returns the current connection type (e.g., 'wifi', 'cellular', 'ethernet', etc.).

1const connectionType = NitroNetworkInfo.connectionType

Methods

addListener(listener: NetworkInfoListener): () => void

Adds a listener for network status changes. Returns a function to unsubscribe the listener.

Parameters:

• listener: NetworkInfoListener - Callback function that receives network status updates

Returns:

• () => void - Unsubscribe function

1const unsubscribe = NitroNetworkInfo.addListener((networkInfo) => {
2  console.log('Network status changed:', networkInfo)
3})
4
5// Later, when you want to stop listening
6unsubscribe()

Types

Type	Description
NetworkInfoListener	Callback function type that receives network status updates. Signature: (networkInfo: NitroNetworkStatusInfo) => void
ConnectionType	Enum or string type representing the available connection types (e.g., 'wifi', 'cellular', 'ethernet'). Exact values depend on platform implementation.
NitroNetworkStatusInfo	Object containing detailed network status information passed to listeners. Structure depends on platform implementation and includes connection state and type details.

Credits

Bootstrapped with create-nitro-module.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.