Framework

SafariServices

Enable web views and services in your app.

Overview

Use the Safari Services framework to integrate Safari behaviors into your iOS or macOS app or to extend the behavior of Safari.

You can:

  • Provide a user interface that is almost identical to the user interface provided by the Safari app. Users can browse the web in this view and then return to your app’s content. This view is more consistent with the Safari user interface than implementing your own custom browsing solution and can be done using fewer lines of code. (iOS)

  • Add items to the user’s Safari Reading List. (iOS)

  • Determine from your app whether your content blocker extension is loaded, and if it is, tell it to refresh its contents. (iOS and macOS)

  • Implement Safari app extensions. Determine from your app whether a Safari app extension is loaded. (macOS)

  • Allow the user to share cookies and website data between an app and Safari for a single sign-on (SSO) experience with SFAuthenticationSession.

Topics

Availability

SFSafariServicesVersion

The version of Safari services.

Safari Content Display in Your App

SFSafariViewController

An object that provides a visible standard interface for browsing the web.

SFAuthenticationSession

A class that manages sharing a one-time login between Safari and an app, which can also be used for automatic login for associated apps.

Deprecated
SFAuthenticationCompletionHandler

The completion handler for an authentication session when the user cancels or finishes the login.

Safari Reading List

SSReadingList

An object used to add items to a user’s Safari Reading List.

SSReadingListErrorDomain

The domain for Safari Reading List errors.

SSReadingListErrorCode

Messages that describe a Safari Reading List error.

Content Blockers

Creating a Content Blocker

Create a Content Blocker for Safari in Xcode.

SFContentBlockerManager

A class used by your app to interact with a content blocker extension.

SFContentBlockerState

The state of a content blocker extension.

SFContentBlockerErrorDomain

The domain for content blocker errors.

Deprecated
SFContentBlockerErrorCode

Messages that describe a content blocker error.

Deprecated

Safari App Extensions

Safari App Extensions

Learn how Safari app extensions extend the web-browsing experience in Safari by leveraging web technologies and native code.

SFSafariApplication

A proxy for the Safari app.

SFSafariWindow

A proxy for a Safari window.

SFSafariPage

A proxy for a Safari webpage.

SFSafariTab

A proxy for a tab in a Safari window.

Miscellaneous Errors

SFAuthenticationError

Messages that describe an authentication error.

Deprecated
SFAuthenticationErrorDomain

The domain for authentication errors.

Deprecated
SFErrorCode

Messages that describe a content blocker or Safari app extension error.

SFErrorDomain

The domain for content blocker or Safari app extension errors.