Source/WebKit/UIProcess/API/Cocoa/WKWebView.h - WebKit - Git at Google

 /*
  * Copyright (C) 2014 Apple Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions
  * are met:
  * 1. Redistributions of source code must retain the above copyright
  *    notice, this list of conditions and the following disclaimer.
  * 2. Redistributions in binary form must reproduce the above copyright
  *    notice, this list of conditions and the following disclaimer in the
  *    documentation and/or other materials provided with the distribution.
  *
  * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
  * THE POSSIBILITY OF SUCH DAMAGE.
  */

 #import <WebKit/WKFoundation.h>

 #if TARGET_OS_IPHONE
 #import <UIKit/UIKit.h>
 #else
 #import <AppKit/AppKit.h>
 #endif

 NS_ASSUME_NONNULL_BEGIN

 @class WKBackForwardList;
 @class WKBackForwardListItem;
 @class WKFindConfiguration;
 @class WKFindResult;
 @class WKNavigation;
 @class WKPDFConfiguration;
 @class WKSnapshotConfiguration;
 @class WKWebViewConfiguration;

 @protocol WKNavigationDelegate;
 @protocol WKUIDelegate;

 /*!
  A WKWebView object displays interactive Web content.
  @helperclass @link WKWebViewConfiguration @/link
  Used to configure @link WKWebView @/link instances.
  */
 #if TARGET_OS_IPHONE
 WK_CLASS_AVAILABLE(macos(10.10), ios(8.0))
 @interface WKWebView : UIView
 #else
 WK_CLASS_AVAILABLE(macos(10.10), ios(8.0))
 @interface WKWebView : NSView
 #endif

 /*! @abstract A copy of the configuration with which the web view was
  initialized. */
 @property (nonatomic, readonly, copy) WKWebViewConfiguration *configuration;

 /*! @abstract The web view's navigation delegate. */
 @property (nullable, nonatomic, weak) id <WKNavigationDelegate> navigationDelegate;

 /*! @abstract The web view's user interface delegate. */
 @property (nullable, nonatomic, weak) id <WKUIDelegate> UIDelegate;

 /*! @abstract The web view's back-forward list. */
 @property (nonatomic, readonly, strong) WKBackForwardList *backForwardList;

 /*! @abstract Returns a web view initialized with a specified frame and
  configuration.
  @param frame The frame for the new web view.
  @param configuration The configuration for the new web view.
  @result An initialized web view, or nil if the object could not be
  initialized.
  @discussion This is a designated initializer. You can use
  @link -initWithFrame: @/link to initialize an instance with the default
  configuration. The initializer copies the specified configuration, so
  mutating the configuration after invoking the initializer has no effect
  on the web view.
  */
 - (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration NS_DESIGNATED_INITIALIZER;

 - (nullable instancetype)initWithCoder:(NSCoder *)coder NS_DESIGNATED_INITIALIZER;

 /*! @abstract Navigates to a requested URL.
  @param request The request specifying the URL to which to navigate.
  @result A new navigation for the given request.
  */
 - (nullable WKNavigation *)loadRequest:(NSURLRequest *)request;

 /*! @abstract Navigates to the requested file URL on the filesystem.
  @param URL The file URL to which to navigate.
  @param readAccessURL The URL to allow read access to.
  @discussion If readAccessURL references a single file, only that file may be loaded by WebKit.
  If readAccessURL references a directory, files inside that file may be loaded by WebKit.
  @result A new navigation for the given file URL.
  */
 - (nullable WKNavigation *)loadFileURL:(NSURL *)URL allowingReadAccessToURL:(NSURL *)readAccessURL WK_API_AVAILABLE(macos(10.11), ios(9.0));

 /*! @abstract Sets the webpage contents and base URL.
  @param string The string to use as the contents of the webpage.
  @param baseURL A URL that is used to resolve relative URLs within the document.
  @result A new navigation.
  */
 - (nullable WKNavigation *)loadHTMLString:(NSString *)string baseURL:(nullable NSURL *)baseURL;

 /*! @abstract Sets the webpage contents and base URL.
  @param data The data to use as the contents of the webpage.
  @param MIMEType The MIME type of the data.
  @param characterEncodingName The data's character encoding name.
  @param baseURL A URL that is used to resolve relative URLs within the document.
  @result A new navigation.
  */
 - (nullable WKNavigation *)loadData:(NSData *)data MIMEType:(NSString *)MIMEType characterEncodingName:(NSString *)characterEncodingName baseURL:(NSURL *)baseURL WK_API_AVAILABLE(macos(10.11), ios(9.0));

 /*! @abstract Navigates to an item from the back-forward list and sets it
  as the current item.
  @param item The item to which to navigate. Must be one of the items in the
  web view's back-forward list.
  @result A new navigation to the requested item, or nil if it is already
  the current item or is not part of the web view's back-forward list.
  @seealso backForwardList
  */
 - (nullable WKNavigation *)goToBackForwardListItem:(WKBackForwardListItem *)item;

 /*! @abstract The page title.
  @discussion @link WKWebView @/link is key-value observing (KVO) compliant
  for this property.
  */
 @property (nullable, nonatomic, readonly, copy) NSString *title;

 /*! @abstract The active URL.
  @discussion This is the URL that should be reflected in the user
  interface.
  @link WKWebView @/link is key-value observing (KVO) compliant for this
  property.
  */
 @property (nullable, nonatomic, readonly, copy) NSURL *URL;

 /*! @abstract A Boolean value indicating whether the view is currently
  loading content.
  @discussion @link WKWebView @/link is key-value observing (KVO) compliant
  for this property.
  */
 @property (nonatomic, readonly, getter=isLoading) BOOL loading;

 /*! @abstract An estimate of what fraction of the current navigation has been completed.
  @discussion This value ranges from 0.0 to 1.0 based on the total number of
  bytes expected to be received, including the main document and all of its
  potential subresources. After a navigation completes, the value remains at 1.0
  until a new navigation starts, at which point it is reset to 0.0.
  @link WKWebView @/link is key-value observing (KVO) compliant for this
  property.
  */
 @property (nonatomic, readonly) double estimatedProgress;

 /*! @abstract A Boolean value indicating whether all resources on the page
  have been loaded over securely encrypted connections.
  @discussion @link WKWebView @/link is key-value observing (KVO) compliant
  for this property.
  */
 @property (nonatomic, readonly) BOOL hasOnlySecureContent;

 /*! @abstract A SecTrustRef for the currently committed navigation.
  @discussion @link WKWebView @/link is key-value observing (KVO) compliant
  for this property.
  */
 @property (nonatomic, readonly, nullable) SecTrustRef serverTrust WK_API_AVAILABLE(macos(10.12), ios(10.0));

 /*! @abstract A Boolean value indicating whether there is a back item in
  the back-forward list that can be navigated to.
  @discussion @link WKWebView @/link is key-value observing (KVO) compliant
  for this property.
  @seealso backForwardList.
  */
 @property (nonatomic, readonly) BOOL canGoBack;

 /*! @abstract A Boolean value indicating whether there is a forward item in
  the back-forward list that can be navigated to.
  @discussion @link WKWebView @/link is key-value observing (KVO) compliant
  for this property.
  @seealso backForwardList.
  */
 @property (nonatomic, readonly) BOOL canGoForward;

 /*! @abstract Navigates to the back item in the back-forward list.
  @result A new navigation to the requested item, or nil if there is no back
  item in the back-forward list.
  */
 - (nullable WKNavigation *)goBack;

 /*! @abstract Navigates to the forward item in the back-forward list.
  @result A new navigation to the requested item, or nil if there is no
  forward item in the back-forward list.
  */
 - (nullable WKNavigation *)goForward;

 /*! @abstract Reloads the current page.
  @result A new navigation representing the reload.
  */
 - (nullable WKNavigation *)reload;

 /*! @abstract Reloads the current page, performing end-to-end revalidation
  using cache-validating conditionals if possible.
  @result A new navigation representing the reload.
  */
 - (nullable WKNavigation *)reloadFromOrigin;

 /*! @abstract Stops loading all resources on the current page.
  */
 - (void)stopLoading;

 /* @abstract Evaluates the given JavaScript string.
  @param javaScriptString The JavaScript string to evaluate.
  @param completionHandler A block to invoke when script evaluation completes or fails.
  @discussion The completionHandler is passed the result of the script evaluation or an error.
 */
 - (void)evaluateJavaScript:(NSString *)javaScriptString completionHandler:(void (^ _Nullable)(_Nullable id, NSError * _Nullable error))completionHandler;

 /*! @abstract Get a snapshot for the visible viewport of WKWebView.
  @param snapshotConfiguration An object that specifies how the snapshot is configured.
  @param completionHandler A block to invoke when the snapshot is ready.
  @discussion If the WKSnapshotConfiguration is nil, the method will snapshot the bounds of the
  WKWebView and create an image that is the width of the bounds of the WKWebView and scaled to the
  device scale. The completionHandler is passed the image of the viewport contents or an error.
  */
 #if TARGET_OS_IPHONE
 - (void)takeSnapshotWithConfiguration:(nullable WKSnapshotConfiguration *)snapshotConfiguration completionHandler:(void (^)(UIImage * _Nullable snapshotImage, NSError * _Nullable error))completionHandler WK_API_AVAILABLE(ios(11.0));
 #else
 - (void)takeSnapshotWithConfiguration:(nullable WKSnapshotConfiguration *)snapshotConfiguration completionHandler:(void (^)(NSImage * _Nullable snapshotImage, NSError * _Nullable error))completionHandler WK_API_AVAILABLE(macos(10.13));
 #endif

 /*! @abstract Create a PDF document representation from the web page currently displayed in the WKWebView
 @param pdfConfiguration An object that specifies how the PDF capture is configured.
 @param completionHandler A block to invoke when the pdf document data is ready.
 @discussion If the WKPDFConfiguration is nil, the method will create a PDF document representing the bounds of the currently displayed web page.
 The completionHandler is passed the resulting PDF document data or an error.
 The data can be used to create a PDFDocument object.
 If the data is written to a file the resulting file is a valid PDF document.
 */
 - (void)createPDFWithConfiguration:(nullable WKPDFConfiguration *)pdfConfiguration completionHandler:(void (^)(NSData * _Nullable pdfDocumentData, NSError * _Nullable error))completionHandler NS_REFINED_FOR_SWIFT WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

 /* @abstract Create WebKit web archive data representing the current web content of the WKWebView
 @param completionHandler A block to invoke when the web archive data is ready.
 @discussion WebKit web archive data represents a snapshot of web content.
 It can be used to represent web content on a pasteboard, loaded into a WKWebView directly, and saved to a file for later use.
 The uniform type identifier kUTTypeWebArchive can be used get the related pasteboard type and MIME type.
 */
 - (void)createWebArchiveDataWithCompletionHandler:(void (^)(NSData *, NSError *))completionHandler NS_REFINED_FOR_SWIFT WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

 /*! @abstract A Boolean value indicating whether horizontal swipe gestures
  will trigger back-forward list navigations.
  @discussion The default value is NO.
  */
 @property (nonatomic) BOOL allowsBackForwardNavigationGestures;

 /*! @abstract The custom user agent string or nil if no custom user agent string has been set.
 */
 @property (nullable, nonatomic, copy) NSString *customUserAgent WK_API_AVAILABLE(macos(10.11), ios(9.0));

 /*! @abstract A Boolean value indicating whether link preview is allowed for any
  links inside this WKWebView.
  @discussion The default value is YES on Mac and iOS.
  */
 @property (nonatomic) BOOL allowsLinkPreview WK_API_AVAILABLE(macos(10.11), ios(9.0));

 #if TARGET_OS_IPHONE
 /*! @abstract The scroll view associated with the web view.
  */
 @property (nonatomic, readonly, strong) UIScrollView *scrollView;
 #endif

 #if !TARGET_OS_IPHONE
 /* @abstract A Boolean value indicating whether magnify gestures will
  change the web view's magnification.
  @discussion It is possible to set the magnification property even if
  allowsMagnification is set to NO.
  The default value is NO.
  */
 @property (nonatomic) BOOL allowsMagnification;

 /* @abstract The factor by which the viewport of the page is currently scaled.
  @discussion The default value is 1.0.
  */
 @property (nonatomic) CGFloat magnification;

 /* @abstract Scales the page content by a specified factor and centers the
  result on a specified point.
  * @param magnification The factor by which to scale the content.
  * @param point The point (in view space) on which to center magnification.
  */
 - (void)setMagnification:(CGFloat)magnification centeredAtPoint:(CGPoint)point;

 #endif

 /* @abstract The factor by which page content is scaled relative to the viewport.
 @discussion The default value is 1.0.
  Changing this value is equivalent to web content setting the CSS "zoom"
  property on all page content.
 */
 @property (nonatomic) CGFloat pageZoom WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

 /* @abstract Searches the page contents for the given string.
  @param string The string to search for.
  @param configuration A set of options configuring the search.
  @param completionHandler A block to invoke when the search completes.
  @discussion If the WKFindConfiguration is nil, all of the default WKFindConfiguration values will be used.
   A match found by the search is selected and the page is scrolled to reveal the selection.
   The completion handler is called after the search completes.
 */
 - (void)findString:(NSString *)string withConfiguration:(nullable WKFindConfiguration *)configuration completionHandler:(void (^)(WKFindResult *result))completionHandler NS_REFINED_FOR_SWIFT WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

 /* @abstract Checks whether or not WKWebViews handle the given URL scheme by default.
  @param scheme The URL scheme to check.
  */
 + (BOOL)handlesURLScheme:(NSString *)urlScheme WK_API_AVAILABLE(macos(10.13), ios(11.0));


 /* @abstract The media type for the WKWebView
  @discussion The value of mediaType will override the normal value of the CSS media property.
  Setting the value to nil will restore the normal value.
  The default value is nil.
 */
 @property (nonatomic, nullable, copy) NSString *mediaType;

 #if !TARGET_OS_IPHONE
 /* @abstract Returns an NSPrintOperation object configured to print the contents of this WKWebView
 @param printInfo The print info object used to configure the resulting print operation.
 */
 - (NSPrintOperation *)printOperationWithPrintInfo:(NSPrintInfo *)printInfo WK_API_AVAILABLE(macos(WK_MAC_TBA));
 #endif
 @end

 #if !TARGET_OS_IPHONE

 @interface WKWebView (WKIBActions) <NSUserInterfaceValidations>

 /*! @abstract Action method that navigates to the back item in the
  back-forward list.
  @param sender The object that sent this message.
  */
 - (IBAction)goBack:(nullable id)sender;

 /*! @abstract Action method that navigates to the forward item in the
  back-forward list.
  @param sender The object that sent this message.
  */
 - (IBAction)goForward:(nullable id)sender;

 /*! @abstract Action method that reloads the current page.
  @param sender The object that sent this message.
  */
 - (IBAction)reload:(nullable id)sender;

 /*! @abstract Action method that reloads the current page, performing
  end-to-end revalidation using cache-validating conditionals if possible.
  @param sender The object that sent this message.
  */
 - (IBAction)reloadFromOrigin:(nullable id)sender;

 /*! @abstract Action method that stops loading all resources on the current
  page.
  @param sender The object that sent this message.
  */
 - (IBAction)stopLoading:(nullable id)sender;

 @end

 WK_API_AVAILABLE(macos(WK_MAC_TBA))
 @interface WKWebView (WKNSTextFinderClient) <NSTextFinderClient>
 @end

 #endif

 @interface WKWebView (WKDeprecated)

 @property (nonatomic, readonly, copy) NSArray *certificateChain WK_API_DEPRECATED_WITH_REPLACEMENT("serverTrust", macos(10.11, 10.12), ios(9.0, 10.0));

 @end

 NS_ASSUME_NONNULL_END
	/*
	* Copyright (C) 2014 Apple Inc. All rights reserved.
	*
	* Redistribution and use in source and binary forms, with or without
	* modification, are permitted provided that the following conditions
	* are met:
	* 1. Redistributions of source code must retain the above copyright
	* notice, this list of conditions and the following disclaimer.
	* 2. Redistributions in binary form must reproduce the above copyright
	* notice, this list of conditions and the following disclaimer in the
	* documentation and/or other materials provided with the distribution.
	*
	* THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
	* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
	* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
	* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
	* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
	* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
	* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
	* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
	* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
	* THE POSSIBILITY OF SUCH DAMAGE.
	*/

	#import <WebKit/WKFoundation.h>

	#if TARGET_OS_IPHONE
	#import <UIKit/UIKit.h>
	#else
	#import <AppKit/AppKit.h>
	#endif

	NS_ASSUME_NONNULL_BEGIN

	@class WKBackForwardList;
	@class WKBackForwardListItem;
	@class WKFindConfiguration;
	@class WKFindResult;
	@class WKNavigation;
	@class WKPDFConfiguration;
	@class WKSnapshotConfiguration;
	@class WKWebViewConfiguration;

	@protocol WKNavigationDelegate;
	@protocol WKUIDelegate;

	/*!
	A WKWebView object displays interactive Web content.
	@helperclass @link WKWebViewConfiguration @/link
	Used to configure @link WKWebView @/link instances.
	*/
	#if TARGET_OS_IPHONE
	WK_CLASS_AVAILABLE(macos(10.10), ios(8.0))
	@interface WKWebView : UIView
	#else
	WK_CLASS_AVAILABLE(macos(10.10), ios(8.0))
	@interface WKWebView : NSView
	#endif

	/*! @abstract A copy of the configuration with which the web view was
	initialized. */
	@property (nonatomic, readonly, copy) WKWebViewConfiguration *configuration;

	/! @abstract The web view's navigation delegate. /
	@property (nullable, nonatomic, weak) id <WKNavigationDelegate> navigationDelegate;

	/! @abstract The web view's user interface delegate. /
	@property (nullable, nonatomic, weak) id <WKUIDelegate> UIDelegate;

	/! @abstract The web view's back-forward list. /
	@property (nonatomic, readonly, strong) WKBackForwardList *backForwardList;

	/*! @abstract Returns a web view initialized with a specified frame and
	configuration.
	@param frame The frame for the new web view.
	@param configuration The configuration for the new web view.
	@result An initialized web view, or nil if the object could not be
	initialized.
	@discussion This is a designated initializer. You can use
	@link -initWithFrame: @/link to initialize an instance with the default
	configuration. The initializer copies the specified configuration, so
	mutating the configuration after invoking the initializer has no effect
	on the web view.
	*/
	- (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration NS_DESIGNATED_INITIALIZER;

	- (nullable instancetype)initWithCoder:(NSCoder *)coder NS_DESIGNATED_INITIALIZER;

	/*! @abstract Navigates to a requested URL.
	@param request The request specifying the URL to which to navigate.
	@result A new navigation for the given request.
	*/
	- (nullable WKNavigation )loadRequest:(NSURLRequest )request;

	/*! @abstract Navigates to the requested file URL on the filesystem.
	@param URL The file URL to which to navigate.
	@param readAccessURL The URL to allow read access to.
	@discussion If readAccessURL references a single file, only that file may be loaded by WebKit.
	If readAccessURL references a directory, files inside that file may be loaded by WebKit.
	@result A new navigation for the given file URL.
	*/
	- (nullable WKNavigation )loadFileURL:(NSURL )URL allowingReadAccessToURL:(NSURL *)readAccessURL WK_API_AVAILABLE(macos(10.11), ios(9.0));

	/*! @abstract Sets the webpage contents and base URL.
	@param string The string to use as the contents of the webpage.
	@param baseURL A URL that is used to resolve relative URLs within the document.
	@result A new navigation.
	*/
	- (nullable WKNavigation )loadHTMLString:(NSString )string baseURL:(nullable NSURL *)baseURL;

	/*! @abstract Sets the webpage contents and base URL.
	@param data The data to use as the contents of the webpage.
	@param MIMEType The MIME type of the data.
	@param characterEncodingName The data's character encoding name.
	@param baseURL A URL that is used to resolve relative URLs within the document.
	@result A new navigation.
	*/
	- (nullable WKNavigation )loadData:(NSData )data MIMEType:(NSString )MIMEType characterEncodingName:(NSString )characterEncodingName baseURL:(NSURL *)baseURL WK_API_AVAILABLE(macos(10.11), ios(9.0));

	/*! @abstract Navigates to an item from the back-forward list and sets it
	as the current item.
	@param item The item to which to navigate. Must be one of the items in the
	web view's back-forward list.
	@result A new navigation to the requested item, or nil if it is already
	the current item or is not part of the web view's back-forward list.
	@seealso backForwardList
	*/
	- (nullable WKNavigation )goToBackForwardListItem:(WKBackForwardListItem )item;

	/*! @abstract The page title.
	@discussion @link WKWebView @/link is key-value observing (KVO) compliant
	for this property.
	*/
	@property (nullable, nonatomic, readonly, copy) NSString *title;

	/*! @abstract The active URL.
	@discussion This is the URL that should be reflected in the user
	interface.
	@link WKWebView @/link is key-value observing (KVO) compliant for this
	property.
	*/
	@property (nullable, nonatomic, readonly, copy) NSURL *URL;

	/*! @abstract A Boolean value indicating whether the view is currently
	loading content.
	@discussion @link WKWebView @/link is key-value observing (KVO) compliant
	for this property.
	*/
	@property (nonatomic, readonly, getter=isLoading) BOOL loading;

	/*! @abstract An estimate of what fraction of the current navigation has been completed.
	@discussion This value ranges from 0.0 to 1.0 based on the total number of
	bytes expected to be received, including the main document and all of its
	potential subresources. After a navigation completes, the value remains at 1.0
	until a new navigation starts, at which point it is reset to 0.0.
	@link WKWebView @/link is key-value observing (KVO) compliant for this
	property.
	*/
	@property (nonatomic, readonly) double estimatedProgress;

	/*! @abstract A Boolean value indicating whether all resources on the page
	have been loaded over securely encrypted connections.
	@discussion @link WKWebView @/link is key-value observing (KVO) compliant
	for this property.
	*/
	@property (nonatomic, readonly) BOOL hasOnlySecureContent;

	/*! @abstract A SecTrustRef for the currently committed navigation.
	@discussion @link WKWebView @/link is key-value observing (KVO) compliant
	for this property.
	*/
	@property (nonatomic, readonly, nullable) SecTrustRef serverTrust WK_API_AVAILABLE(macos(10.12), ios(10.0));

	/*! @abstract A Boolean value indicating whether there is a back item in
	the back-forward list that can be navigated to.
	@discussion @link WKWebView @/link is key-value observing (KVO) compliant
	for this property.
	@seealso backForwardList.
	*/
	@property (nonatomic, readonly) BOOL canGoBack;

	/*! @abstract A Boolean value indicating whether there is a forward item in
	the back-forward list that can be navigated to.
	@discussion @link WKWebView @/link is key-value observing (KVO) compliant
	for this property.
	@seealso backForwardList.
	*/
	@property (nonatomic, readonly) BOOL canGoForward;

	/*! @abstract Navigates to the back item in the back-forward list.
	@result A new navigation to the requested item, or nil if there is no back
	item in the back-forward list.
	*/
	- (nullable WKNavigation *)goBack;

	/*! @abstract Navigates to the forward item in the back-forward list.
	@result A new navigation to the requested item, or nil if there is no
	forward item in the back-forward list.
	*/
	- (nullable WKNavigation *)goForward;

	/*! @abstract Reloads the current page.
	@result A new navigation representing the reload.
	*/
	- (nullable WKNavigation *)reload;

	/*! @abstract Reloads the current page, performing end-to-end revalidation
	using cache-validating conditionals if possible.
	@result A new navigation representing the reload.
	*/
	- (nullable WKNavigation *)reloadFromOrigin;

	/*! @abstract Stops loading all resources on the current page.
	*/
	- (void)stopLoading;

	/* @abstract Evaluates the given JavaScript string.
	@param javaScriptString The JavaScript string to evaluate.
	@param completionHandler A block to invoke when script evaluation completes or fails.
	@discussion The completionHandler is passed the result of the script evaluation or an error.
	*/
	- (void)evaluateJavaScript:(NSString )javaScriptString completionHandler:(void (^ _Nullable)(_Nullable id, NSError _Nullable error))completionHandler;

	/*! @abstract Get a snapshot for the visible viewport of WKWebView.
	@param snapshotConfiguration An object that specifies how the snapshot is configured.
	@param completionHandler A block to invoke when the snapshot is ready.
	@discussion If the WKSnapshotConfiguration is nil, the method will snapshot the bounds of the
	WKWebView and create an image that is the width of the bounds of the WKWebView and scaled to the
	device scale. The completionHandler is passed the image of the viewport contents or an error.
	*/
	#if TARGET_OS_IPHONE
	- (void)takeSnapshotWithConfiguration:(nullable WKSnapshotConfiguration )snapshotConfiguration completionHandler:(void (^)(UIImage _Nullable snapshotImage, NSError * _Nullable error))completionHandler WK_API_AVAILABLE(ios(11.0));
	#else
	- (void)takeSnapshotWithConfiguration:(nullable WKSnapshotConfiguration )snapshotConfiguration completionHandler:(void (^)(NSImage _Nullable snapshotImage, NSError * _Nullable error))completionHandler WK_API_AVAILABLE(macos(10.13));
	#endif

	/*! @abstract Create a PDF document representation from the web page currently displayed in the WKWebView
	@param pdfConfiguration An object that specifies how the PDF capture is configured.
	@param completionHandler A block to invoke when the pdf document data is ready.
	@discussion If the WKPDFConfiguration is nil, the method will create a PDF document representing the bounds of the currently displayed web page.
	The completionHandler is passed the resulting PDF document data or an error.
	The data can be used to create a PDFDocument object.
	If the data is written to a file the resulting file is a valid PDF document.
	*/
	- (void)createPDFWithConfiguration:(nullable WKPDFConfiguration )pdfConfiguration completionHandler:(void (^)(NSData _Nullable pdfDocumentData, NSError * _Nullable error))completionHandler NS_REFINED_FOR_SWIFT WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

	/* @abstract Create WebKit web archive data representing the current web content of the WKWebView
	@param completionHandler A block to invoke when the web archive data is ready.
	@discussion WebKit web archive data represents a snapshot of web content.
	It can be used to represent web content on a pasteboard, loaded into a WKWebView directly, and saved to a file for later use.
	The uniform type identifier kUTTypeWebArchive can be used get the related pasteboard type and MIME type.
	*/
	- (void)createWebArchiveDataWithCompletionHandler:(void (^)(NSData , NSError ))completionHandler NS_REFINED_FOR_SWIFT WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

	/*! @abstract A Boolean value indicating whether horizontal swipe gestures
	will trigger back-forward list navigations.
	@discussion The default value is NO.
	*/
	@property (nonatomic) BOOL allowsBackForwardNavigationGestures;

	/*! @abstract The custom user agent string or nil if no custom user agent string has been set.
	*/
	@property (nullable, nonatomic, copy) NSString *customUserAgent WK_API_AVAILABLE(macos(10.11), ios(9.0));

	/*! @abstract A Boolean value indicating whether link preview is allowed for any
	links inside this WKWebView.
	@discussion The default value is YES on Mac and iOS.
	*/
	@property (nonatomic) BOOL allowsLinkPreview WK_API_AVAILABLE(macos(10.11), ios(9.0));

	#if TARGET_OS_IPHONE
	/*! @abstract The scroll view associated with the web view.
	*/
	@property (nonatomic, readonly, strong) UIScrollView *scrollView;
	#endif

	#if !TARGET_OS_IPHONE
	/* @abstract A Boolean value indicating whether magnify gestures will
	change the web view's magnification.
	@discussion It is possible to set the magnification property even if
	allowsMagnification is set to NO.
	The default value is NO.
	*/
	@property (nonatomic) BOOL allowsMagnification;

	/* @abstract The factor by which the viewport of the page is currently scaled.
	@discussion The default value is 1.0.
	*/
	@property (nonatomic) CGFloat magnification;

	/* @abstract Scales the page content by a specified factor and centers the
	result on a specified point.
	* @param magnification The factor by which to scale the content.
	* @param point The point (in view space) on which to center magnification.
	*/
	- (void)setMagnification:(CGFloat)magnification centeredAtPoint:(CGPoint)point;

	#endif

	/* @abstract The factor by which page content is scaled relative to the viewport.
	@discussion The default value is 1.0.
	Changing this value is equivalent to web content setting the CSS "zoom"
	property on all page content.
	*/
	@property (nonatomic) CGFloat pageZoom WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

	/* @abstract Searches the page contents for the given string.
	@param string The string to search for.
	@param configuration A set of options configuring the search.
	@param completionHandler A block to invoke when the search completes.
	@discussion If the WKFindConfiguration is nil, all of the default WKFindConfiguration values will be used.
	A match found by the search is selected and the page is scrolled to reveal the selection.
	The completion handler is called after the search completes.
	*/
	- (void)findString:(NSString )string withConfiguration:(nullable WKFindConfiguration )configuration completionHandler:(void (^)(WKFindResult *result))completionHandler NS_REFINED_FOR_SWIFT WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));

	/* @abstract Checks whether or not WKWebViews handle the given URL scheme by default.
	@param scheme The URL scheme to check.
	*/
	+ (BOOL)handlesURLScheme:(NSString *)urlScheme WK_API_AVAILABLE(macos(10.13), ios(11.0));


	/* @abstract The media type for the WKWebView
	@discussion The value of mediaType will override the normal value of the CSS media property.
	Setting the value to nil will restore the normal value.
	The default value is nil.
	*/
	@property (nonatomic, nullable, copy) NSString *mediaType;

	#if !TARGET_OS_IPHONE
	/* @abstract Returns an NSPrintOperation object configured to print the contents of this WKWebView
	@param printInfo The print info object used to configure the resulting print operation.
	*/
	- (NSPrintOperation )printOperationWithPrintInfo:(NSPrintInfo )printInfo WK_API_AVAILABLE(macos(WK_MAC_TBA));
	#endif
	@end

	#if !TARGET_OS_IPHONE

	@interface WKWebView (WKIBActions) <NSUserInterfaceValidations>

	/*! @abstract Action method that navigates to the back item in the
	back-forward list.
	@param sender The object that sent this message.
	*/
	- (IBAction)goBack:(nullable id)sender;

	/*! @abstract Action method that navigates to the forward item in the
	back-forward list.
	@param sender The object that sent this message.
	*/
	- (IBAction)goForward:(nullable id)sender;

	/*! @abstract Action method that reloads the current page.
	@param sender The object that sent this message.
	*/
	- (IBAction)reload:(nullable id)sender;

	/*! @abstract Action method that reloads the current page, performing
	end-to-end revalidation using cache-validating conditionals if possible.
	@param sender The object that sent this message.
	*/
	- (IBAction)reloadFromOrigin:(nullable id)sender;

	/*! @abstract Action method that stops loading all resources on the current
	page.
	@param sender The object that sent this message.
	*/
	- (IBAction)stopLoading:(nullable id)sender;

	@end

	WK_API_AVAILABLE(macos(WK_MAC_TBA))
	@interface WKWebView (WKNSTextFinderClient) <NSTextFinderClient>
	@end

	#endif

	@interface WKWebView (WKDeprecated)

	@property (nonatomic, readonly, copy) NSArray *certificateChain WK_API_DEPRECATED_WITH_REPLACEMENT("serverTrust", macos(10.11, 10.12), ios(9.0, 10.0));

	@end

	NS_ASSUME_NONNULL_END