GitLocker: The Coding Marketplace

Description:

internet connection checker plus

Internet Connection Checker Plus #
A Flutter package to check your internet connection with subsecond response
times, even on mobile networks!

This library provides functionality to monitor and verify internet connectivity
by checking reachability to various Uris. It relies on the connectivity_plus
package for listening to connectivity changes and the http package for making
network requests.
Features #

Check internet connectivity status
Listen for internet connectivity changes

Supported Platforms #

Platform
Check Connectivity
Listen for Changes

Android
✅
✅

iOS
✅
✅

macOS
✅
✅

Linux
✅
✅

Windows
✅
✅

Web
✅
✅

Permissions #
Android #
Add the following permissions to your AndroidManifest.xml file:
<uses-permission android:name="android.permission.INTERNET" />
copied to clipboard
macOS #
Add the following permissions to your macOS .entitlements files:
<key>com.apple.security.network.client</key>
<true/>
copied to clipboard
For more information, see the Flutter Networking Documentation.
Usage #
1. Add dependency #
Add the internet_connection_checker_plus package to your pubspec.yaml file:
dependencies:
internet_connection_checker_plus: ^2.5.1
copied to clipboard
2. Import the package #
Import the internet_connection_checker_plus package into your Dart file:
import 'package:internet_connection_checker_plus/internet_connection_checker_plus.dart';
copied to clipboard
3. Checking for internet connectivity #
The simplest way to check for internet connectivity is to use the
InternetConnection class:
bool result = await InternetConnection().hasInternetAccess;
copied to clipboard
4. Listening for internet connectivity changes #
The InternetConnection class also provides a stream of InternetStatus that
can be used to listen for changes in internet connectivity:
final listener = InternetConnection().onStatusChange.listen((InternetStatus status) {
switch (status) {
case InternetStatus.connected:
// The internet is now connected
break;
case InternetStatus.disconnected:
// The internet is now disconnected
break;
}
});
copied to clipboard
Don't forget to cancel the subscription when it is no longer needed.
This will prevent memory leaks and free up resources:
listener.cancel();
copied to clipboard
5. Add custom Uris to check #
The InternetConnection class can be configured to check custom Uris for
internet connectivity:
final connection = InternetConnection.createInstance(
customCheckOptions: [
InternetCheckOption(uri: Uri.parse('https://example.com')),
],
);
copied to clipboard

Note
Make sure the custom Uris have no caching enabled. Otherwise, the results
may be inaccurate.

Note
On web platform, make sure the custom Uris are not CORS blocked.
Otherwise, the results may be inaccurate.

6. Add custom success criteria #
The InternetConnection class can be configured to check custom Uris for
internet connectivity using custom success criteria:
final connection = InternetConnection.createInstance(
customCheckOptions: [
InternetCheckOption(
uri: Uri.parse('https://example.com'),
responseStatusFn: (response) {
return response.statusCode >= 69 && response.statusCode < 169;
},
),
InternetCheckOption(
uri: Uri.parse('https://example2.com'),
responseStatusFn: (response) {
return response.statusCode >= 420 && response.statusCode < 1412;
},
),
],
);
copied to clipboard
Default Uris
The InternetConnection class uses the following Uris by default:

URI
Description

https://one.one.one.one
Response time is less than 100ms, CORS enabled, no-cache

https://icanhazip.com
Response time is less than 100ms, CORS enabled, no-cache

https://jsonplaceholder.typicode.com/todos/1
Response time is less than 100ms, CORS enabled, no-cache

https://reqres.in/api/users/1
Response time is less than 100ms, CORS enabled, no-cache

Some Tested URIs

URI
Description

https://ipapi.co/ip
CORS enabled, no-cache

https://api.adviceslip.com/advice
CORS enabled, no-cache

https://api.bitbucket.org/2.0/repositories
CORS enabled, no-cache

https://api.thecatapi.com/v1/images/search
CORS enabled, no-cache

https://api.coindesk.com/v1/bpi/currentprice.json
CORS enabled, no-cache

https://lenta.ru
Russia supported, CORS enabled, no-cache

https://www.gazeta.ru
Russia supported, CORS enabled, no-cache

If you liked the package, then please give it a Like 👍🏼 and Star ⭐ #
Credits #
This package is a cloned and modified version of the
internet_connection_checker package which is a cloned and modified version of
the data_connection_checker package which is no longer maintained.
The aim of this package is to support the web platform which is currently not
supported by the internet_connection_checker package.