who-am-i-now

Which platform am I on?

Do you need to run platform specific code?

If you need to (programmatically) find the answer to one of the following questions then this package is for you:

• "is my app a react frontend?"
• "is my app a nextjs app?"
• "is my app a PWA standalone (installed) app?"
• "is my app a react-native app?"
• "is my app an expo app?"
• "is my react-native or expo app running on ios, android or web?"
• "is my app a plain node server?"
• etc.

This package is extending the functionality of react-device-detect, by additionally detecting which 'platform' your code is running on and other things.

Live demos

Using who-am-i-now in an expo app

https://snack.expo.dev/@maks-io/who-am-i-now-demo

Using who-am-i-now in a react app

https://stackblitz.com/edit/who-am-i-now-react

Using who-am-i-now in a next.js app

https://stackblitz.com/edit/who-am-i-now-nextjs

Installation

Via npm:

npm i who-am-i-now --save

Via yarn:

yarn add who-am-i-now

Usage

import WhoAmINow, { Who } from "who-am-i-now";

const who: Who = WhoAmINow();

// Example result:
// who = {
//     isMobile: true,
//     isBrowser: false,
//     isReactNativeApp: true,
//     isReactNativeAppIOS: true,
//     isReactNativeAppAndroid: false,
//     isReactNativeAppWeb: false,
//     isExpoApp: true,
//     isReactApp: false,
//     isNextApp: false,
//     isTWA: false,
//     isPWAStandalone: false,
//     isServerApp: false,
//     ... and many others - check section below for details
// }

Selectors

The result of calling whoAmINow() is an object holding various selectors/booleans/values. Every prop is either

• inheriting the behaviour from the original react-device-detect library (entries marked with **), or
• having a different behaviour compared to the original react-device-detect library (entries marked with *), or
• completely new (entries in table without asterisks)

| selector | type | explanation | | ----------------------- | -------------------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | isReactNativeApp | boolean | returns true if code is running in a react-native app (with and without expo) | | isReactNativeAppIOS | boolean | returns true if code is running in a react-native app (with and without expo) and if the platform is ios | | isReactNativeAppAndroid | boolean | returns true if code is running in a react-native app (with and without expo) and if the platform is android | | isReactNativeAppWeb | boolean | returns true if code is running in a react-native app (with and without expo) and if the platform is web (Note that this will be false if code is running in a plain react web app!) | | isExpoApp | boolean | returns true if code is running in a react-native app via expo | | isExpoAppRunningInGo | boolean | undefined | returns true if code is running in expo Go, returns false otherwise, if it is still an expo app, and returns undefined in every other case | | isExpoSnack | boolean | undefined | returns true if code is running in an expo snack, returns false otherwise, if it is still an expo app, and returns undefined in every other case | | isReactApp | boolean | returns true if code is running in a react app | | isNextApp | boolean | returns true if code is running in a nextjs app | | isTWA | boolean | returns true if code is running as part of an android trusted web activities app | | isPWAStandalone | boolean | returns true if code is running as part of a progressive web app / PWA in standalone mode, meaning in an installed way (for instance, after user decided to "add app to homescreen" etc.) | | isServerApp | boolean | returns true if code is running in a plain node "server" app (imagine a classical express api/server for instance) | | isCI | boolean | returns true if code is running as part of a continuous integration / CI pipeline (since version 2.1.0 it relies on the is-ci package) | | isTestRun | boolean | returns true if code is running as part of a test run (for instance jest unit tests, etc. - it relies on the environment to set the variable NODE_ENV=test) | | isJestTestRun | boolean | returns true if code is running as part of a jest test run | | isCypressTestRun | boolean | returns true if code is running as part of a cypress test run | | isBrowser* | boolean | returns true if code is running in a browser - the behaviour from react-device-detect was slightly changed | | isMobile* | boolean | returns true if code is running in a react-native app (with and without expo) but not in web browser (via react-native-web) | | isDesktop* | boolean | returns true if code is NOT running in a react-native app (with and without expo) - in other words, this is the opposite of isMobile above | | isMobileOnly** | boolean | returns the same value react-device-detect returns | | isTablet** | boolean | returns the same value react-device-detect returns | | isSmartTV** | boolean | returns the same value react-device-detect returns | | isWearable** | boolean | returns the same value react-device-detect returns | | isConsole** | boolean | returns the same value react-device-detect returns | | isEmbedded** | boolean | returns the same value react-device-detect returns | | isAndroid** | boolean | returns the same value react-device-detect returns | | isWinPhone** | boolean | returns the same value react-device-detect returns | | isIOS** | boolean | returns the same value react-device-detect returns | | isChrome** | boolean | returns the same value react-device-detect returns | | isFirefox** | boolean | returns the same value react-device-detect returns | | isSafari** | boolean | returns the same value react-device-detect returns | | isOpera** | boolean | returns the same value react-device-detect returns | | isIE** | boolean | returns the same value react-device-detect returns | | isEdge** | boolean | returns the same value react-device-detect returns | | isYandex** | boolean | returns the same value react-device-detect returns | | isChromium** | boolean | returns the same value react-device-detect returns | | isMobileSafari** | boolean | returns the same value react-device-detect returns | | isSamsungBrowser** | boolean | returns the same value react-device-detect returns | | osVersion** | string | returns the same value react-device-detect returns | | osName** | string | returns the same value react-device-detect returns | | fullBrowserVersion** | string | returns the same value react-device-detect returns | | browserVersion** | string | returns the same value react-device-detect returns | | browserName** | string | returns the same value react-device-detect returns | | mobileVendor** | string | returns the same value react-device-detect returns | | mobileModel** | string | returns the same value react-device-detect returns | | engineName** | string | returns the same value react-device-detect returns | | engineVersion** | string | returns the same value react-device-detect returns | | getUA** | string | returns the same value react-device-detect returns | | deviceType** | string | returns the same value react-device-detect returns | | isIOS13** | boolean | returns the same value react-device-detect returns | | isIPhone13** | boolean | returns the same value react-device-detect returns | | isIPad13** | boolean | returns the same value react-device-detect returns | | isIPod13** | boolean | returns the same value react-device-detect returns | | isElectron** | boolean | returns the same value react-device-detect returns | | isEdgeChromium** | boolean | returns the same value react-device-detect returns | | isLegacyEdge** | boolean | returns the same value react-device-detect returns | | isWindows** | boolean | returns the same value react-device-detect returns | | isMacOs** | boolean | returns the same value react-device-detect returns |

Misc

Youtube short: https://youtube.com/shorts/sKyRYo9h514?feature=share

If you enjoy using this...