react-native-vpn-detect
v1.0.0
Published
Checks for VPN on iOS
Downloads
991
Maintainers
Readme
react-native-vpn-detect
A React Native wrapper to determine if the current iOS network connection is on a VPN (NetInfo supplies this for Android).
Installation
npm i --save react-native-vpn-detect # npm syntax
yarn add react-native-vpn-detect # yarn syntax
then enter the ios
directory and run pod install
to link the pod to your React Native project.
Usage
Import the library along with the NativeEventEmitter exported from React Native:
import { ..., NativeEventEmitter } from "react-native";
import RNVPNDetect from "react-native-vpn-detect";
Setup:
in componentDidMount, instantiate a new NativeEventEmitter, passing in RNVPNDetect.
const RNVPNDetectEmitter = new NativeEventEmitter(RNVPNDetect);
Then, add a listener to the EventEmitter instance, and make sure to store it somewhere globally available on the component (e.g. instance variable) so you can unsubscribe from it later.
The listener should take: "RNVPNDetect.vpnStateDidChange"
as the event name to listen to, and a handler of your choosing as the second argument.
RootContainer._iosVpnDetectSubscribe = RNVPNDetectEmitter.addListener(
"RNVPNDetect.vpnStateDidChange",
this._handleVpnStateChanged
);
RNVPNDetect can be used in two ways:
- Using a timer, which will check for a change in the VPN state at the provided interval, and send an event IF the state has changed
- Manually asking for the current vpn state
Use Timer
After following the setup steps above:
You can then initialize the timer with an interval of your choosing. It defaults to 3s (3000ms) if nothing is passed in.
RNVPNDetect.startTimer(5000)
Make sure to unsubscribe from the listener when your component unmounts.
componentDidUnmount {
...
if (RootContainer._iosVpnDetectSubscribe) {
RootContainer._iosVpnDetectSubscribe.remove();
RootContainer._iosVpnDetectSubscribe = null;
RNVPNDetect.stopTimer();
}
}
Manual
After following the steps above, you can manually query the current vpn state by calling:
RNVPNDetect.checkIsVpnConnected()
This will check the current vpn state and trigger the listener you set up in componentDidMount
.
You should still unsubscribe from the listener on unmount, but you can skip the stopTimer
call if you never started one ;)
componentDidUnmount {
...
if (RootContainer._iosVpnDetectSubscribe) {
RootContainer._iosVpnDetectSubscribe.remove();
RootContainer._iosVpnDetectSubscribe = null;
}
}