28

I have an iPhone Web App, and I'm interested in detecting if the app was loaded either from:

  1. iPhone Safari
  2. iPhone installed web app (via the add to my home screen) which loads without the safari bars.

Any ideas?

8 Answers 8

70

You can determine whether a webpage is displayed in full-screen mode using the window.navigator.standalone read-only Boolean JavaScript property. https://developer.apple.com/library/content/documentation/AppleApplications/Reference/SafariHTMLRef/Articles/MetaTags.html

if (window.navigator.standalone) {
    // fullscreen mode

}
2
  • 2
    Freakin' awesome! I had no idea I could do this. May 21, 2010 at 21:52
  • 1
    I literally just laughed and high-fived myself. This is so much better than UA sniffing. Thank you!
    – mklickman
    Sep 1, 2014 at 16:10
11

You can detect the mode via Javascript as described above - or you can use PHP and the user agent.

<?
if (strpos(strtolower($_SERVER['HTTP_USER_AGENT']),"iphone")) {
   if (strpos(strtolower($_SERVER['HTTP_USER_AGENT']),"safari")) {
      echo('Running in browser on iPhone');
   }else{
      echo('Running as stand alone WebApp on iPhone');
   }
}else{
   echo('Running on device other than iPhone.');
}
?>

Enjoy!

0
4

This is what I use, works great:

if (window.navigator.userAgent.indexOf('iPhone') != -1) {
    if (window.navigator.standalone == true) {
        alert("Yes iPhone! Yes Full Screen!");
    } else {
        alert("Not Full Screen!");
    };} else {
        alert("Not iPhone!");
        document.location.href = 'please-open-from-an-iphone.html';
};
2

How to do it with PHP and filter false positives

I think that @strat 's answer is in the right direction, if you want to use PHP. Except that it won't work unless the mobile app capable meta is set. Otherwise the iPhone will place in home a bookmark opening mobile safari. Also, it returned false positives, for example when accessing the page from any other browser on iPhone, like the Facebook browser.

Luckily, the standalone user agent string has a particularity: it only has 3 slashes in it. I tested various other browsers and they all have more than 3. It's hackish, but we can use this at our advantage. Also, it's interesting to note that a standard webview in a app will have 2 slashes.

So this is the minimum working example:

<?php
// We need to add the mobile web app capable meta. Status bar is set to black to avoid our text go under the status bar.
?>

<html>
<head>
  <meta name="apple-mobile-web-app-capable" content="yes">
  <meta name="apple-mobile-web-app-status-bar-style" content="black">
</head>
<body>


<?php

$ua = strtolower($_SERVER['HTTP_USER_AGENT']);

if ( strpos($ua,"iphone") || strpos($ua,"ipad") ) {
   if ( strpos($ua,"safari") ) {
      echo('Running in safari on iPhone/iPad');
   } else if ( substr_count($ua, '/') === 3 ) {
      echo('Running as stand alone WebApp on iPhone/iPad');
   } else if ( substr_count($ua, '/') === 2 ) {
      echo('Running in a WebView on a iPhone/iPad app');
   } else {
      echo('Running in another browser on iPhone/iPad');
   }
} else {
   echo('Running on device other than iPhone/iPad.');
}

?>

</body>
</html>
1

I'm not sure how far back this behavior goes, but iOS will present different UserAgent strings to the server which can be used to detect if the page is being requested by a webapp or safari browser.

Safari Browser

Mozilla/5.0 (iPhone; CPU iPhone OS 8_1_1 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Version/8.0 Mobile/12B436 Safari/600.1.4

Home Screen Button/Web App

Mozilla/5.0 (iPhone; CPU iPhone OS 8_1_1 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Mobile/12B436

Notice it does not include 'Safari' in the UserAgent. I've confirmed that this behavior goes back to at least iOS 7, but I'd imagine even further.

So you can test for the presence of iPhone or iPad in the UserAgent string and lack of Safari to detect that it's been opened from the Home screen.

0

I prefer this one-liner to determine whether it's fullscreen/in a web app or not.

var webApp = (typeof window.navigator.standalone != 'undefined' && window.navigator.standalone ? true : false);
-1

Check the HTTP-Headers when accessing the site from iPhone Safari and the WebApp to see if they are different.

I don't know if they are, but if they are, I'm sure you'll be able to implement that somewhere in your website.

http://php.net/manual/en/function.headers-list.php

-1

Can be simplified to var webApp = window.navigator.standalone || false;

Can be simplified again to var webApp = window.navigator.standalone;

1
  • your second "simplification" actually breaks it, since .standalone is a property only existing on Apple's iOS Safari
    – Leon
    Jan 22, 2018 at 15:24

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.