App & Browser Testing Made Easy

Give your users a seamless experience by testing on 3000+ real devices and browsers. Don't compromise with emulators and simulators

Home Guide How to Debug Websites on iPhone Safari

How to Debug Websites on iPhone Safari

By Jash Unadkat, Technical Content Writer at BrowserStack -

Table of Contents

With iOS holding 27% of the global mobile OS market share, its popularity speaks for itself. Safari holds 18% of the global browser market share. Therefore, it is safe to assume that millions of users across the world expect to access websites and web apps via the Safari browsers on their iOS devices, most commonly iPhones.

Consequently, testers will have to test websites on iPhone-Safari combinations to ensure flawless functionality. This forms a crucial part of a project’s cross browser testing mandate.

This article will highlight two methods by which developers or QAs can debug websites and web apps on iPhone via the Safari browser.

Note: For developers or QA engineers seeking to debug errors on specific iOS devices (For example iPhone X, iPhone 11Pro) the second method will be more effective.

Why is it important to debug on iPhone?

iPhone holds a significant share of Apple’s revenue and has been one of its pioneer products. With the rising iPhone Sales from 40 million units in 2010 to more than 206 million units in 2020, which is ever-increasing, the prominence of iPhone and its user base is also growing. This makes debugging websites on iPhone important.

Let’s understand how to debug safari on iPhones and iPads using two different methods.

Method 1: Debug using the Web Inspector feature on iPhones or iPads

Debugging issues for mobile web pages can be difficult at times. However, starting from iOS 6, Apple provides a Web Inspector, which makes debugging web pages much easier on iPhones or iPads. Follow the steps below to use it:

  • Connect the iOS device to the machine.
  • Enable the Web-Inspector option. To do so:
    Go to Settings > Safari > Scroll down to the bottom > Open Advanced Menu>
    Turn on Web Inspector How to inspect Safari in iPhone using Web Inspector
  • Open the desired web page to debug or preview on your mobile Safari browser. Once done, enable the Develop menu on the Mac device.

To enable the Develop menu, follow the steps below:

  1. Launch Safari browser
  2. Click on Safari at the top > Open Preferences > Advanced
  3. Mark the checkbox – Show Develop menu in the menu bar to enable itHow to debug on iphone using safari
  4. Now, you’ll be able to view the Develop menu in the top bar. Click on it and it will show the connected iPhone or iPad along with the URL that is active on Safari.How to Debug on iOS devices
  5. By Clicking on that URL, a new inspector window will open that allows the developer to inspect, preview, or debug the page on a mobile browser from their Mac. Just click on the Resources section, and then all interactions with the web elements will be highlighted in real-time on that iPhone.remote debugging on iOS safari
    Image source

How to debug errors on iPad or iPhone using the Safari Console menu?

  • Select “Console” from the iPhone Safari Web Inspector Menu iPhone Safari Web Inspector Menu
  • Console is a Command Line API that allows you to debug Safari on iPhone using Developer Tools. The Console allows access to the DOM and JavaScript of the open page, allowing you to inspect HTML nodes and JavaScript objects in more detail by using the console commands.

iPhone Safari Debug Console 1

Method 2: Debugging on Real iPhones or iPads on BrowserStack’s Real Device Cloud

Developers or QAs often have to deal with rendering bugs for a specific device or platform (Android, iOS). In such cases, they need to use specific mobile devices for testing, debugging, and optimizing websites for mobile devices to ensure the consistent cross-device user experience.

Test on Real iPhones for Free

Here’s where BrowserStack empowers teams by offering them a real device cloud for manual and automated testing of websites and apps on real devices.

Teams can instantly choose from a range of Android or iOS devices installed with popular browsers like Chrome, Safari, Firefox, and much more. Team members also receive upfront access to Devtools of specific browsers for both platforms during live testing. This simplifies the debugging process on the desired device by letting users test on any iOS device like iPhone X, iPhone 11 pro, etc.

The image below displays a BrowserStack Live test session on iPhone XS:

How to debug on iPhones

As developers and QAs get the flexibility to preview and inspect elements on any iPhone, debugging on those iPhones becomes an effortless task. They can also choose to switch between multiple device-browser combinations from the dashboard.

Test and Debug on Real iOS Devices

Also read: How to test mobile applications manually

UI bugs can range from being annoying to being majorly disruptive for user experience. Thorough testing on real devices is the most effective way to discover and deal with these bugs. Debugging on iPhones is mandatory for iOS app developers and testers so as to create apps that work perfectly in real user conditions. Instead of wondering how to debug iOS apps in Safari, just follow the steps in this article, and start releasing highly functioning web apps on iOS.

Cross browser testing Emulator and Simulator Manual Testing Mobile App Testing

Featured Articles

How to request a desktop site on the iPhone

How to Inspect Element on Mac ?

Curated for all your Testing Needs

Actionable Insights, Tips, & Tutorials delivered in your Inbox
By subscribing , you agree to our Privacy Policy.
thank you illustration

Thank you for Subscribing!

Expect a curated list of guides shortly.