Skip to Content
Platform.Ontology

Network state

Lets the app see whether the device is online and what kind of network.

Gets silentlyNetwork and connectionConnectivityAndroid and iPhoneWhile you use itIn the background

In one line

Can see if your phone is online and what kind of network it uses

Lets the app see whether the device is online and what kind of network.

Shows online status and network type; slightly useful for fingerprinting. Auto-granted.

What it can and can't do

What the user does: Nothing. It happens when the app loads or the network changes

It can

  • Check if the phone is online
  • See the network type, metered state and rough speed estimate
  • Notice Low Data Mode on iPhone
  • React when the network changes

It cannot

  • See which Wi-Fi name you are on without location permission
  • See what you send or receive
  • Turn Wi-Fi on or off

How it differs between platforms: Android needs a normal permission granted at install. iPhone needs none.

On Android and iPhone

AndroidiPhone
StatusSupportedSupported
First versionAndroid 1.0 (API 1)iOS 12
Permission or entitlementACCESS_NETWORK_STATEnone
Protection levelnormalnone
How access is grantedinstallnone
What the user seesNone (granted at install)None
How long it lastsNot revocablen/a
How to take it backn/an/a
Store policyPlay: nonenone
APIConnectivityManager, NetworkCallbackNWPathMonitor
NotesProvides transport type, metered state and bandwidth estimates.Reports path status, interface type and Low Data Mode.

Data you get

What comes back: Connectivity state
Shape: object
How often: on change

FieldTypeUnitRangePrecision
transportenumtypeWi-Fi, cellular, ethernet, VPNexact

Technical limits

  • No prompt on either OS
  • No access to nearby networks without location permission

The story

What it is

An app can see whether your phone is online and what kind of network it is on.

For you

You do not see it. You notice an offline banner or an app that retries when the signal returns. Apps get this without asking.

For makers

Makers use it to avoid errors, save data and switch between online and offline mode. It adds a small amount to a device profile, but the value is low.

Where you see it

TypeExampleApps
messagingA chat app shows 'Connecting' and sends your queued messages the moment you are online.WhatsApp, Telegram
mediaA music app switches to offline mode and plays downloaded songs when you lose signal.Spotify
gamesA mobile game pauses a match and tries to reconnect when the network drops.Clash Royale
liveA live stream app lowers quality when your network becomes weaker.Twitch
productivityA notes app saves changes on the phone and syncs when you are back online.Notion, Evernote
analyticsA tracker logs when your connection changes, which hints at your daily path.None named

Risks

  • Slight fingerprint value
  • Reveals home or away

Android and iPhone in short

  • Android: Android grants this as a normal permission at install, with no prompt.
  • iPhone: iPhone needs no permission for this, and apps can watch changes live.

What the platform says

Good uses and abuse

Legitimate uses

  • Adapting streams

Known abuse

  • Fingerprinting

Scores

ScoreValueMeaning
Sensitivity1 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction0 of 5How much the user has to do
Fingerprint bits2Rough identifying entropy, when known

A real example: LinkedIn

Exodus lists Cedexis Radar in LinkedIn Android reports (4.1.1012 snippet). Radar is a real-user network measurement SDK used to pick CDNs; purpose in LinkedIn's app is inferred.

History

  • 2018-03, Android 8.1 (API 27): SSID reads gated behind location
  • 2018-08, Android 9 (API 28): Network request APIs refined; NetworkCallback preferred
  • 2019-09, iPhone iOS 13: SSID needs location permission

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page