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" />

macOS

Add the following permissions to your macOS .entitlements files:

<key>com.apple.security.network.client</key>
<true/>

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.3.0

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';

3. Checking for internet connectivity

The simplest way to check for internet connectivity is to use the InternetConnection class:

bool result = await InternetConnection().hasInternetAccess;

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;
  }
});

Don't forget to cancel the subscription when it is no longer needed. This will prevent memory leaks and free up resources:

listener.cancel();

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')),
  ],
);

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;
      },
    ),
  ],
);

Default Uris

The InternetConnection class uses the following Uris by default:

URI	Description
https://icanhazip.com	Response time is less than 100ms, CORS enabled, no-cache
https://jsonplaceholder.typicode.com/posts/1	Response time is less than 100ms, CORS enabled, no-cache
https://pokeapi.co/api/v2/pokemon/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://ifconfig.me/ip	Payload is less than 50 bytes, CORS enabled, no-cache
https://ipecho.net/plain	Payload is less than 50 bytes, CORS enabled, no-cache
https://lenta.ru	Russia supported, CORS enabled, no-cache
https://www.gazeta.ru	Russia supported, CORS enabled, no-cache
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://www.boredapi.com/api/activity	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

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.