WKWebView所有API详解

原文链接：https://cloud.tencent.com/developer/article/1033743
本文只是稍作排版，如有侵权请联系我删除，文章较长，建议Mac电脑Command+F搜索。

WKWebView主要涉及到以下类或协议，各部分可能互相依赖，文章按照apple文档的划分对每一个模块进行了详细的解释

WKWebView
WKWebViewConfiguration 配置
WKPreferences 偏好
WKProcessPool 进程分配

页面导航管理:
WKNavigationDelegate
WKNavigation
WKNavigationAction
WKNavigationResponse
WKBackForwardList
WKBackForwardListItem

用户界面:
WKUIDelegate
WKWindowFeatures

脚本注入:
WKUserContentController
WKScriptMessage
WKUserScript

缓存数据和持久化:
WKWebsiteDataStore
WKHTTPCookieStore
WKHTTPCookieStoreObserver
WKWebsiteDataRecord

处理WebKit无法处理的URL Scheme类型的资源:
WKURLSchemeHandler
WKURLSchemeTask

页面结构:
WKFrameInfo
WKSecurityOrigin

内容拦截:
WKContentRuleList
WKContentRuleListStore

3D-Touch预览:
WKPreviewElementInfo
WKPreviewActionItem
UIPreviewActionItem

一. WKWebView

一个WKWebView对象显示交互式的web内容，比如在应用程序内的浏览器。
您可以使用WKWebView类来在应用程序中嵌入web内容，通过创建一个WKWebView对象，将其设置为视图，并发送一个请求来加载web内容。
从iOS 8.0和OS X 10.10开始，建议使WKWebView在应用程序中展示web内容，建议不要使用UIWebView
可以使用WKWebView如下:

  • 使用 initWithFrame:configuration: 方法来创建WKWebView对象；
  • 使用 loadHTMLString:baseURL: 方法来加载本地HTML文件；
  • 使用 loadRequest: 方法来加载web内容；
  • 使用 stopLoading 方法来停止加载；
  • 使用 loading 属性来判断网页是否正在加载中；
  • 使用 WKUIDelegate 协议来跟踪网页内容的加载过程；
1.决定是否加载内容
  • [iOS 11.0+] 返回WebKit是否原生地支持某一种URL Scheme
+ (BOOL)handlesURLScheme:(NSString *)urlScheme;
2.初始化WebView
  • 初始化配置
@property (nonatomic, readonly, copy) WKWebViewConfiguration *configuration;
  • 初始化
- (instancetype)initWithFrame:(CGRect)frame configuration:(WKWebViewConfiguration *)configuration;
1.如果初始化失败返回nil 
2.这是一个接收自定义WKWebViewConfiguration参数的初始化方法
3.其会对传入的WKWebViewConfiguration对象进行拷贝，因此，在初始化之后，你再对传入的对象进行修改是不会生效的
4.使用initWithFrame: 初始化方法会使用默认的WKWebViewConfiguration进行初始化
3.查看View的信息
  • WebView对应的ScrollView
@property(nonatomic, readonly, strong) UIScrollView *scrollView;
  • 当前页面的title
@property(nonatomic, readonly, copy) NSString *title; 
支持KVO
  • 当前的URL
@property(nonatomic, readonly, copy) NSURL *URL;
支持KVO
  • iOS 9.0+自定义User Agent
@property(nonatomic, copy) NSString *customUserAgent;
如果不想自定义User Agent，设为nil即可
  • iOS 10.0+当前浏览页面的SecTrustRef对象
@property(nonatomic, readonly) SecTrustRef serverTrust;
  • iOS 9.0 – 10.0当前浏览页面的证书链(已废弃)
@property(nonatomic, readonly, copy) NSArray *certificateChain;
其元素是SecCertificateRef
4.设置代理
  • 页面浏览代理
@property(nonatomic, weak) id<WKNavigationDelegate> navigationDelegate;
  • 界面代理
@property (nullable, nonatomic, weak) id <WKUIDelegate> UIDelegate;
5.加载内容
  • 当前浏览页面加载进度的比例（估算值）
@property(nonatomic, readonly) double estimatedProgress;
1.这个值根据预期接收的字节总数(包括主文档和所有潜在的子资源)从0.0到1.0不等
2.在页面加载完成后，估算的进度保持在1.0，直到新的导航开始，这时估算的进度重置为0.0
3.支持KVO
  • 是否页面内的所有资源都是通过安全链接加载的
@property(nonatomic, readonly) BOOL hasOnlySecureContent;
支持KVO
  • 设置网页的内容和基础URL
- (WKNavigation *)loadHTMLString:(NSString *)string baseURL:(NSURL *)baseURL;
1.string是网页的内容
2.baseURL是用于解析文档内相对URL的URL
3.返回一个新的WKNavigation对象
  • 是否正在加载内容
@property(nonatomic, readonly, getter=isLoading) BOOL loading;
支持KVO。
  • 重新加载当前页面
- (WKNavigation *)reload;
1.返回一个新的WKNavigation对象
2.是不带缓存的验证(对比reloadFromOrigin)
  • 重新加载当前页面(带缓存的验证)
- (WKNavigation *)reloadFromOrigin;
1.如果可能的话使用cache-validating条件执行end-to-end重新验证
2.是带缓存的验证
  • 停止加载当前网页中的所有资源
- (void)stopLoading;
  • iOS 9.0+设置网页内容和base URL
- (WKNavigation *)loadData:(NSData *)data MIMEType:(NSString *)MIMEType characterEncodingName:(NSString *)characterEncodingName baseURL:(NSURL *)baseURL;
1.data是网页内容
2.MIMEType是数据类型
3.characterEncodingName是编码名称
4.baseURL是用于解析文档内相对URL的URL
5.返回一个新的WKNavigation对象
  • iOS 9.0+浏览文件
- (WKNavigation *)loadFileURL:(NSURL *)URL allowingReadAccessToURL:(NSURL *)readAccessURL;
1.URL是文件的URL
2.readAccessURL是允许读取的URL，如果是文件夹，则文见夹下所有文件都可以被读取
6.放缩网页内容
  • 是否允许放大手势来放大网页内容
@property(nonatomic) BOOL allowsMagnification;
1.默认值是NO
2.这里只是限制手势而已，通过magnification属性仍然可以调节网页的放大比例
  • 影响网页内容放缩的因子
@property(nonatomic) CGFloat magnification;
默认值是1.0
  • 以指定中心点放缩页面内容
- (void)setMagnification:(CGFloat)magnification centeredAtPoint:(CGPoint)point;
按指定的因子（magnification属性）缩放页面内容，并将结果集中在指定的点上，即以指定的点为中心放大
7.浏览
  • 是否允许水平滑动手势来触发网页的前进和后退
@property(nonatomic) BOOL allowsBackForwardNavigationGestures;
  • 当前WebView的前进后退记录
@property (nonatomic, readonly, strong) WKBackForwardList *backForwardList;
  • 是否可以后退。
@property(nonatomic, readonly) BOOL canGoBack;
即在前进后退记录中，当前记录之前是否还有记录
  • 是否可以前进
@property(nonatomic, readonly) BOOL canGoForward;
即在前进后退记录中，当前记录之后是否还有记录
  • iOS 9.0+是否允许按住链接就展示链接的预览
@property(nonatomic) BOOL allowsLinkPreview;
1.在iOS上，这个属性只在支持3D Touch的设备上支持
2.在iOS 10及以后的系统版本默认值是YES，之前的默认值是NO
3.如果将该属性的值设置为YES，则iOS用户可以按下链接来预览链接，并可以检测到地址和电话号码等数据。这样的预览被用户称为peeks
4.如果用户在链接预览上更深入地按下，预览将pop到目标网址。该动作会将应用程序切换到Safari
5.如果您想在iOS中支持链接预览，但又想要在应用程序中保留用户，那么您可以将WKWebView类转换为SFSafariViewController类
6.如果您使用WebView作为应用内浏览器，那么进行这种更改是最佳选择
7.SFSafariViewController自动支持链接预览
8.iOS 10.0+开始支持自定义链接预览，你也可以通过这种方式来实现用户预览网页并pop后仍然留在应用内而不用切换到Safari，只是你需要做一些额外的适配工作
  • 后退
- (WKNavigation *)goBack;
1.即在前进后退列表中导航到上一个记录
2.返回一个新的WKNavigation对象
3.如果没有记录可以后退，则返回nil
  • 前进
- (WKNavigation *)goForward;
1.即在前进后退列表中导航到下一个记录
2.返回一个新的WKNavigation对象
3.如果没有记录可以前进，则返回nil
  • 前进/后退到一个指定的记录上
- (WKNavigation *)goToBackForwardListItem:(WKBackForwardListItem *)item;
1.item必须是WebView的WKBackForwardList中的一个记录
2.返回一个新的WKNavigation对象
3.如果已经在当前记录，或者没有找到，则会返回nil
  • 加载一个请求
- (WKNavigation *)loadRequest:(NSURLRequest *)request;
返回一个新的WKNavigation对象。
8.执行JavaScript
  • 执行JavaScript字符串
- (void)evaluateJavaScript:(NSString *)javaScriptString completionHandler:(void (^)(id, NSError *error))completionHandler;
1.completionHandler会在脚本执行完成或者失败时调用
2.id是代码执行成功的返回结果，error是执行失败的结果
3.completionHandler在主线程中执行
9.获取截图
  • 获取WebView的可见区域截图
- (void)takeSnapshotWithConfiguration:(WKSnapshotConfiguration *)snapshotConfiguration completionHandler:(void (^)(UIImage *snapshotImage, NSError *error))completionHandler;

二. WKWebViewConfiguration

使用WKWebViewConfiguration类，你可以决定网页的渲染时机，媒体的播放方式，用户选择项目的粒度，以及很多其他的选项。

WKWebViewConfiguration只会在webview第一次初始化的时候使用，你不能用此类来改变一个已经初始化完成的webview的配置。

  • UserAgent中的应用名称
@property(nonatomic, copy) NSString *applicationNameForUserAgent;
  • WebView使用的偏好选项
@property(nonatomic, strong) WKPreferences *preferences;
  • 进程池
@property(nonatomic, strong) WKProcessPool *processPool;
webview将会从该进程池中获取一个Web Content 进程
在初始化web视图时，将为它从指定的池中创建一个新的Web Content 进程，或者使用该池中的现有进程
  • 与WebView关联的WKUserContentController对象
@property(nonatomic, strong) WKUserContentController *userContentController;
  • 与WebView关联的WKWebsiteDataStore对象
@property(nonatomic, strong) WKWebsiteDataStore *websiteDataStore;
如果一个WebView关联了一个非持久化的WKWebsiteDataStore，将不会有数据被写入到文件系统
该特性可以用来实现隐私浏览。
  • 是否应该总是允许网页的缩放
@property(nonatomic) BOOL ignoresViewportScaleLimits;
将此属性设置为TRUE可以使页面被缩放，无论页面的意图是什么
设置为TRUE会覆盖网页中的user-scalable HTML属性
默认值为FALSE。
  • 是否抑制内容渲染呈现，直到它完全载入内存
@property(nonatomic) BOOL suppressesIncrementalRendering;
默认值NO
  • HTML5视频是否内联播放
@property(nonatomic) BOOL allowsInlineMediaPlayback;
内联播放就是指在页面内播放而非必须使用native的全屏播放控件
你必须设置此属性以播放内联视频
当在iPhone的HTML文档中添加视频元素时，还必须包括playsinline属性
在iOS 10.0之前创建的应用程序必须使用webkit-playsinline属性
iPhone的默认值为false，而iPad的默认值为true
  • 是否允许AirPlay播放媒体
@property(nonatomic) BOOL allowsAirPlayForMediaPlayback;
  • 是否允许HTML5视屏以画中画形式播放
@property(nonatomic) BOOL allowsPictureInPictureMediaPlayback;
默认YES
  • 哪些媒体类型需要用户手势才能开始播放
@property(nonatomic) WKAudiovisualMediaTypes mediaTypesRequiringUserActionForPlayback;
使用WKAudiovisualMediaTypeNone表明不需要用户手势开始播放媒体
  • 已废弃iOS 9.0以后使用allowsAirPlayForMediaPlayback
@property(nonatomic) BOOL mediaPlaybackAllowsAirPlay;
  • 已废弃iOS 10.0以后使用mediaTypesRequiringUserActionForPlayback
@property(nonatomic) BOOL requiresUserActionForMediaPlayback;
  • 已废弃iOS 10.0以后使用mediaTypesRequiringUserActionForPlayback
@property(nonatomic) BOOL mediaPlaybackRequiresUserAction;
  • 用户可以在WebView中交互式地选择内容的粒度级别
@property(nonatomic) WKSelectionGranularity selectionGranularity;
默认值是 WKSelectionGranularityDynamic
  • 用户界面元素的方向性
@property(nonatomic) WKUserInterfaceDirectionPolicy userInterfaceDirectionPolicy;
默认值是WKUserInterfaceDirectionPolicyContent

  • 设置需要检测的数据类型

    指定该属性将会给匹配的页面内容增加用户交互@property(nonatomic) WKDataDetectorTypes dataDetectorTypes;
    例如，如果将其设为WKDataDetectorTypeLink类型，浏览器将会对页面中的“Visit apple.com” 字符串中的 “apple.com”添加链接

  • 为指定的URL Scheme添加处理器（WKURLSchemeHandler）

- (void)setURLSchemeHandler:(id<WKURLSchemeHandler>)urlSchemeHandler forURLScheme:(NSString *)urlScheme;
一个URL Scheme只能有一个处理器
对一个不合法的URL Scheme注册处理器，注册多次，或者注册一个已经注册过的处理器，都会触发异常
你可以调用handlesURLScheme:方法来判断WebKit是否可以处理一个特定的URL Scheme
URL Scheme对大小写敏感
一个合法的URL Scheme只能是以ASCII字母开头并且只能是由ASCII字母，数字，'+',  '-' 和 '.'组成
  • 返回URL Scheme对应的WKURLSchemeHandler
- (id<WKURLSchemeHandler>)urlSchemeHandlerForURLScheme:(NSString *)urlScheme;

三. WKPreferences

一个WKPreferences封装了一个webview的偏好选项，在WKWebViewConfiguration中设置

  • 最小字体的尺寸
@property(nonatomic) CGFloat minimumFontSize;
默认值是0
  • 是否启用JavaScript
@property(nonatomic) BOOL javaScriptEnabled;
默认值YES
设置为NO将会禁用页面加载的或执行的JavaScript
但这个配置不会影响用户的script
  • 是否可以在没有用户操作的情况下自动打开窗口
@property (nonatomic) BOOL javaScriptCanOpenWindowsAutomatically;
iOS默认为NO，macOS默认为YES

四. WKProcessPool

一个WKProcessPool对象代表Web Content的进程池。

与WebView的进程池关联的进程池通过其configuration来配置。每个WebView都有自己的Web Content进程，最终由一个有具体实现的进程来限制;在此之后，具有相同进程池的WebView最终共享Web Content进程。

WKProcessPool对象只是一个简单的不透明token，本身没有属性或者方法。

五.WKUserContentController

WKUserContentController对象提供了一种向WebView发送JavaScript消息或者注入JavaScript脚本的方法

1.添加WKScriptMessageHandler

添加一个WKScriptMessageHandler
- (void)addScriptMessageHandler:(id<WKScriptMessageHandler>)scriptMessageHandler name:(NSString *)name;
添加一个名称为name的WKScriptMessageHandler将会导致在所有使用该WKScriptMessageHandler的WebView的所有frame中定义一个JavaScript函数window.webkit.messageHandlers.name.postMessage(messageBody)

2.添加或移除WKUserScript

添加一个WKUserScript
- (void)addUserScript:(WKUserScript *)userScript;
移除所有的WKUserScript
- (void)removeAllUserScripts;
移除name名字的WKScriptMessageHandler
- (void)removeScriptMessageHandlerForName:(NSString *)name;
关联的所有WKScriptMessageHandler
@property(nonatomic, readonly, copy) NSArray<WKUserScript *> *userScripts;

3.添加或移除Content Rules

iOS 11.0+添加一个WKContentRuleList
- (void)addContentRuleList:(WKContentRuleList *)contentRuleList;
iOS 11.0+移除一个WKContentRuleList
- (void)removeContentRuleList:(WKContentRuleList *)contentRuleList;
iOS 11.0+移除所有的WKContentRuleList
- (void)removeAllContentRuleLists;

六. WKScriptMessageHandler

为一个实现了WKScriptMessageHandler协议的类提供一个接收来自网页的JavaScript调用的方法

  • 当收到来自网页的一次JavaScipt调用时响应
- (void)userContentController:(WKUserContentController *)userContentController didReceiveScriptMessage:(WKScriptMessage *)message;
userContentController是调用该方法的WKUserContentController，message是收到的JavaScript消息

七. WKScriptMessage

一个WKScriptMessage对象包含了一个JavaScritp消息的相关信息

  • 消息体
@property(nonatomic, readonly, copy) id body;
只能是这些类型 NSNumber, NSString, NSDate, NSArray, NSDictionary, NSNull
  • 发送消息的frame
@property(nonatomic, readonly, copy) WKFrameInfo *frameInfo;
  • 发送消息的WKScriptMessageHandler的名字
@property(nonatomic, readonly, copy) NSString *name;
  • 发送消息的WKWebView
@property(nonatomic, readonly, weak) WKWebView *webView;

八. WKFrameInfo

一个WKFrameInfo对象包含了一个网页中的farme的相关信息。其只是一个描述瞬时状态的纯数据对象，不能用来在多次消息调用中唯一标识一个frame。

  • 该frame是否是该网页的main frame或者子frame
@property(nonatomic, readonly, getter=isMainFrame) BOOL mainFrame;
  • frame对应的当前的请求
@property(nonatomic, readonly, copy) NSURLRequest *request;
  • frame的securityOrigin
@property(nonatomic, readonly) WKSecurityOrigin *securityOrigin;
  • frame对应的webView
@property(nonatomic, readonly, weak) WKWebView *webView;

九. WKSecurityOrigin

一个WKSecurityOrigin对象由host，protocol和port组成。任何一个与正在加载的网页拥有相同WKSecurityOrigin的URL加载是一个First Party加载。First Party网页可以访问彼此的脚本和数据库资源。其只是一个描述瞬时状态的纯数据对象，不能用来在多次消息调用中唯一标识一个SecurityOrigin。

@property(nonatomic, readonly, copy) NSString *host;
@property(nonatomic, readonly) NSInteger port;
@property(nonatomic, readonly, copy) NSString *protocol;

十. WKUserScript

一个WKUserScript对象代表了一个可以被注入网页中的脚本

  • 初始化一个可以被添加到WKUserContentController的WKUserScript脚本对象
- (instancetype)initWithSource:(NSString *)source injectionTime:(WKUserScriptInjectionTime)injectionTime forMainFrameOnly:(BOOL)forMainFrameOnly;
如果脚本不能被注入则会返回nil
source 脚本的代码
injectionTime 脚本注入的时机，必须是这个WKUserScriptInjectionTime枚举值
forMainFrameOnly YES 只向main frame注入脚本， NO 则会向所有的frame注入脚本
  • 脚本的代码
@property(nonatomic, readonly, copy) NSString *source;
  • 脚本注入的时机
@property(nonatomic, readonly) WKUserScriptInjectionTime injectionTime;
必须是这个WKUserScriptInjectionTime枚举值
  • 是否只注入到main frame
@property(nonatomic, readonly, getter=isForMainFrameOnly) BOOL forMainFrameOnly;
YES 只向main frame注入脚本
NO 则会向所有的frame注入脚本

十一. WKUserScriptInjectionTime枚举

WKUserScriptInjectionTimeAtDocumentStart  在document element创建之后，在所有其他内容加载之前

WKUserScriptInjectionTimeAtDocumentEnd  在document加载完成之后，在其他子资源加载完成之前

十二. WKContentRuleList

一个编译过的规则列表，应用到Web Content上。从WKContentExtensionStore中创建或者取得。

  • 标识符
@property(nonatomic, readonly, copy) NSString *identifier;

十三. WKContentRuleListStore

  • 返回默认的Store
+ (instancetype)defaultStore;
  • 在url路径文件路径下创建一个Store并返回
+ (instancetype)storeWithURL:(NSURL *)url;
当创建时，Store的内容从该路径下的所有编译过的规则列表加载
新增的变化，如编译一个新的规则列表，删除一个已经存在的规则列表，都会持久化在相同的路径
  • 获取所有规则列表的identifier
- (void)getAvailableContentRuleListIdentifiers:(void (^)(NSArray<NSString *> *))completionHandler;
  • 查找指定identifier的WKContentRuleList
- (void)lookUpContentRuleListForIdentifier:(NSString *)identifier completionHandler:(void (^)(WKContentRuleList *, NSError *))completionHandler;
  • 编译一个新的规则列表并添加到Store
- (void)compileContentRuleListForIdentifier:(NSString *)identifier encodedContentRuleList:(NSString *)encodedContentRuleList completionHandler:(void (^)(WKContentRuleList *, NSError *))completionHandler;

encodedContentRuleList JSON格式的源文件，关于其规则见 Safari Content-Blocking Rules Reference

  • 移除指定identifier的WKContentRuleList
- (void)removeContentRuleListForIdentifier:(NSString *)identifier completionHandler:(void (^)(NSError *))completionHandler;

十四. WKWebsiteDataStore

一个WKWebsiteDataStore对象代表了被网页使用的各种类型的数据。包括cookies，磁盘文件，内存缓存以及持久化数据如WebSQL，IndexedDB数据库，local storage。

  • 返回默认的WKWebsiteDataStore
+ (WKWebsiteDataStore *)defaultDataStore;
  • 返回一个新的非持久化的WKWebsiteDataStore
+ (WKWebsiteDataStore \*)nonPersistentDataStore;
如果一个WebView关联了一个非持久化的WKWebsiteDataStore，将不会有数据被写入到文件系统
该特性可以用来实现隐私浏览
  • 是否是非持久化的
@property(nonatomic, readonly, getter=isPersistent) BOOL persistent;
  • 返回WKHTTPCookieStore对象
@property(nonatomic, readonly) WKHTTPCookieStore *httpCookieStore;
  • 获取指定类型的WKWebsiteDataRecord
- (void)fetchDataRecordsOfTypes:(NSSet<NSString *> *)dataTypes completionHandler:(void (^)(NSArray<WKWebsiteDataRecord *> *))completionHandler;
网站数据类型定义 Available Data Types
  • 获取所有可用的数据类型
+ (NSSet<NSString *> *)allWebsiteDataTypes;
网站数据类型定义 Available Data Types
  • 从指定的dataRecords中移除指定类型的WKWebsiteDataRecord
- (void)removeDataOfTypes:(NSSet<NSString *> *)dataTypes forDataRecords:(NSArray<WKWebsiteDataRecord *> *)dataRecords completionHandler:(void (^)(void))completionHandler;
  • 移除指定日期之后发生修改的指定类型的WKWebsiteDataRecord
- (void)removeDataOfTypes:(NSSet<NSString *> *)websiteDataTypes modifiedSince:(NSDate *)date completionHandler:(void (^)(void))completionHandler;

十五. WKHTTPCookieStore

管理与特定的WKWebsiteDataStore关联的HTTP cookie的对象

  • 获取所有的cookies
- (void)getAllCookies:(void (^)(NSArray<NSHTTPCookie *> *))completionHandler;
  • 设置一个cookie
- (void)setCookie:(NSHTTPCookie *)cookie completionHandler:(void (^)(void))completionHandler;
  • 移除一个cookie
- (void)deleteCookie:(NSHTTPCookie *)cookie completionHandler:(void (^)(void))completionHandler;
  • 添加一个WKHTTPCookieStoreObserver观察者
- (void)addObserver:(id<WKHTTPCookieStoreObserver>)observer;
WKHTTPCookieStore不会强引用持有该observer
你应当在不用observer的时候主动将其移除掉
  • 移除一个WKHTTPCookieStoreObserver
- (void)removeObserver:(id<WKHTTPCookieStoreObserver>)observer;

十六. WKHTTPCookieStoreObserver

  • 当WKHTTPCookieStore的cookies发生变化时调用
- (void)cookiesDidChangeInCookieStore:(WKHTTPCookieStore *)cookieStore;

十七. WKWebsiteDataRecord

一个WKWebsiteDataRecord对象代表了按照源URL的domain名和后缀分类的网页数据

  • 存在于此WKWebsiteDataRecord的网站数据类型
@property(nonatomic, readonly, copy) NSSet<NSString *> *dataTypes;
网站数据类型定义 Available Data Types
  • 显示名称。通常，显示名称是来自资源的SecurityOrigin的域名加后缀。
@property(nonatomic, readonly, copy) NSString *displayName;

十八.Available Data Types

定义WKWebsiteDataRecord中可用的数据类型的字符串常量

磁盘缓存
NSString *const WKWebsiteDataTypeDiskCache;

内存缓存
NSString *const WKWebsiteDataTypeMemoryCache;

HTML离线web应用缓存
NSString *const WKWebsiteDataTypeOfflineWebApplicationCache;

Cookies
NSString *const WKWebsiteDataTypeCookies;

HTML session storage
NSString *const WKWebsiteDataTypeSessionStorage;

HTML local storage
NSString *const WKWebsiteDataTypeLocalStorage;

WebSQL 数据库
NSString *const WKWebsiteDataTypeWebSQLDatabases;

IndexedDB 数据库
NSString *const WKWebsiteDataTypeIndexedDBDatabases;

十九. WKAudiovisualMediaTypes

WKAudiovisualMediaTypeNone 都不需要用户的手势就能开始播放

WKAudiovisualMediaTypeAudio 包含音频的媒体类型需要用户的手势才能开始播放

WKAudiovisualMediaTypeVideo 包含视频的媒体类型需要用户的手势才能开始播放

WKAudiovisualMediaTypeAll 所有的媒体类型都需要用户的手势才能开始播放

二十. WKSelectionGranularity

WKSelectionGranularityCharacter 选择端点可以放置在任何字符边界上

WKSelectionGranularityDynamic 选择的粒度取决于选择的不同。当选择是在单一块中时粒度可能是单个的字符，当选择不是局限于单一块，粒度可能是一个块

二十一. WKUserInterfaceDirectionPolicy

用于确定WebView中用户界面元素的方向性的策略。包括ltr（从左到右）和rtl（从右到左）两种方向。文本的书写方向就由此属性来指定。

WKUserInterfaceDirectionPolicyContent 方向性遵循CSS /HTML/ XHTML规范。这是userInterfaceDirectionPolicy的默认值。可以参见CSS direction属性或者HTML dir属性。

WKUserInterfaceDirectionPolicySystem 方向性遵循View的userInterfaceLayoutDirection属性。NSUserInterfaceLayoutDirection包括NSUserInterfaceLayoutDirectionLeftToRight和NSUserInterfaceLayoutDirectionRightToLeft两个枚举值。

二十二. WKDataDetectorTypes

WKDataDetectorTypeNone 不执行检测

WKDataDetectorTypePhoneNumber 电话号码

WKDataDetectorTypeLink 文本中的url

WKDataDetectorTypeAddress 地址

WKDataDetectorTypeCalendarEvent 在未来的日期和时间

WKDataDetectorTypeTrackingNumber 跟踪号码/查询号/运单号

WKDataDetectorTypeFlightNumber 航班号

WKDataDetectorTypeLookupSuggestion

WKDataDetectorTypeSpotlightSuggestion Spotlight的建议（已弃用）

WKDataDetectorTypeAll 上述所有检测类型。选择此值将自动包含添加到这个常量的任何新的检测类型

二十三. WKURLSchemeHandler

用来处理WebKit无法处理的URL Scheme类型的资源

  • 开始加载特定资源时调用
- (void)webView:(WKWebView *)webView startURLSchemeTask:(id<WKURLSchemeTask>)urlSchemeTask;
  • 停止载特定资源时调用
- (void)webView:(WKWebView *)webView stopURLSchemeTask:(id<WKURLSchemeTask>)urlSchemeTask;
WebKit将在你的handler停止处理这个任务时调用这个方法
在此此方法调用之后，你的handler不应该调用这个任务的任何方法，否则会触发异常

二十四. WKURLSchemeTask

用来加载资源的任务

  • 加载的请求
@property(nonatomic, readonly, copy) NSURLRequest *request;
  • 设置当前任务的response
- (void)didReceiveResponse:(NSURLResponse *)response;
每个任务必须至少调用一次这个方法
如果你尝试在任务完成后发送一个新的response对象，会触发异常
如果在任务已经停止加载后调用，将会触发异常
  • 为任务添加接收的数据
- (void)didReceiveData:(NSData *)data;
在任务接受到最终的response对象后，你应当开始发送数据
每次调用这个方法，新的数据都会append到之前的数据后
如果你尝试在发送response之前或者任务已经结束之后发送数据，将会触发异常
如果在任务已经停止加载后调用，将会触发异常
  • 将任务标记为成功完成
- (void)didFinish;
如果你尝试在发送response之前或者任务已经结束之后调用该方法，将会触发异常
如果在任务已经停止加载后调用，将会触发异常
  • 把任务标记为失败
- (void)didFailWithError:(NSError *)error;
如果在任务已经被标记为结束或失败后再调用这个方法会触发异常
如果在任务已经停止加载后调用，将会触发异常

正常情况的调用顺序应该是：
didReceiveResponse（至少1次）
didReceiveResponse
didReceiveResponse
...
didReceiveData（至少0次）
didReceiveData
didReceiveData
...
didFinish/didFailWithError（务必调用）
但是在任务被停止后，应该立即停止上面的任何调用

二十五. WKNavigationDelegate

通过实现WKNavigationDelegate协议的方法可以自定义WebView接受、加载和完成浏览请求过程的一些行为。

  • 当WebView开始接收网页内容时触发
- (void)webView:(WKWebView *)webView didCommitNavigation:(WKNavigation *)navigation;
  • 当WevView的内容开始加载时触发
- (void)webView:(WKWebView *)webView didStartProvisionalNavigation:(WKNavigation *)navigation;
  • 主机地址重定向时触发
- (void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(WKNavigation *)navigation;
  • 当WebView需要响应网页的登录请求时触发
- (void)webView:(WKWebView *)webView didReceiveAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *credential))completionHandler;
稍后再详细研究
  • 页面发生错误时触发
- (void)webView:(WKWebView *)webView didFailNavigation:(WKNavigation *)navigation withError:(NSError *)error;
  • 当页面加载内容过程中发生错误时触发
- (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(WKNavigation *)navigation withError:(NSError *)error;
  • 当前页面加载完成后触发
- (void)webView:(WKWebView *)webView didFinishNavigation:(WKNavigation *)navigation;
  • 当WebContent进程中止时触发
- (void)webViewWebContentProcessDidTerminate:(WKWebView *)webView;
  • 决定是否允许或者取消一次页面加载请求
- (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler;
WKNavigationAction描述了触发本次请求的行为
decisionHandler block在app已经决定允许或取消页面请求时调用
这个block携带一个参数，是WKNavigationActionPolicy枚举类型
WKNavigationActionPolicy枚举包括WKNavigationActionPolicyCancel取消和WKNavigationActionPolicyAllow允许两个枚举值
你可以立即调用该block或者保存block并在以后的时间异步调用它
  • 在已经收到response时决定是否允许或者取消页面的加载
- (void)webView:(WKWebView *)webView decidePolicyForNavigationResponse:(WKNavigationResponse *)navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler;
WKNavigationResponse描述了response的信息
decisionHandler block在app已经决定允许或取消页面加载时调用
这个block携带一个参数，是WKNavigationResponsePolicy枚举类型
WKNavigationResponsePolicy枚举类型包括WKNavigationResponsePolicyCancel取消和WKNavigationResponsePolicyAllow允许两个枚举值
你可以立即调用该block或者保存block并在以后的时间异步调用它。

二十六. WKNavigation

WKNavigation对象包含了跟踪页面加载过程的信息

WebView的load方法会返回一个WKNavigation对象，并会将其传递给WKNavigationDelegate的方法，从开始到结束唯一地标识一个网页加载过程。它没有自己的方法或属性。

二十七. WKNavigationActionPolicy

WKNavigationActionPolicyCancel 取消请求

WKNavigationActionPolicyAllow 允许继续

二十八. WKNavigationResponsePolicy

WKNavigationResponsePolicyCancel 取消加载

WKNavigationResponsePolicyAllow 允许继续

二十九. WKNavigationAction

WKNavigationAction对象包含了可能导致一次加载的操作的信息，用于制定策略决策。

  • 加载的请求信息
@property(nonatomic, readonly, copy) NSURLRequest *request;
  • 产生这次请求的frame信息
@property(nonatomic, readonly, copy) WKFrameInfo *sourceFrame;
  • 请求的目标frame，如果时一个新的窗口请求则是nil
@property(nonatomic, readonly, copy) WKFrameInfo *targetFrame;
  • 触发本次浏览请求的操作类型。见WKNavigationType枚举
@property(nonatomic, readonly) WKNavigationType navigationType;

三十. WKNavigationType

WKNavigationTypeLinkActivated 带有href属性的链接被用户激活

WKNavigationTypeFormSubmitted 一个表单提交

WKNavigationTypeBackForward 向前向后的导航请求

WKNavigationTypeReload 网页重新加载

WKNavigationTypeFormResubmitted 重新提交表单(例如后退、前进或重新加载)

WKNavigationTypeOther 由于其他原因

三十一. WKNavigationResponse

WKNavigationResponse对象包含用于制定策略决策的浏览响应信息

  • 指示WebKit是否可以原生地支持显示这种MIME类型
@property(nonatomic, readonly) BOOL canShowMIMEType;
  • 指示本次加载的frame是否是main frame
@property(nonatomic, readonly, getter=isForMainFrame) BOOL forMainFrame;
  • frame的response信息
@property(nonatomic, readonly, copy) NSURLResponse *response;
如果允许了一个带有无法显示的MIME类型响应，会导致浏览加载失败

三十二. WKUIDelegate

提供为网页展示native用户界面的方法。WebView用户界面通过实现这个协议来控制新窗口的打开，增强用户单击元素时显示的默认菜单项的表现，并执行其他用户界面相关的任务。这些方法可以通过处理JavaScript或其他插件内容来调用。默认每个WebView一个窗口，如果需要实现一个非常规用户界面，需要依靠WKUIDelegate来实现。

  • 创建一个新的WebView
- (WKWebView *)webView:(WKWebView *)webView createWebViewWithConfiguration:(WKWebViewConfiguration *)configuration forNavigationAction:(WKNavigationAction *)navigationAction windowFeatures:(WKWindowFeatures *)windowFeatures;
configuration是创建新WebView的配置
navigationAction是触发本次调用的操作
windowFeatures是本次请求的窗口属性
创建的新WebView一定要使用指定的configuration
WebKit将会在返回的WebView中加载请求
  • 显示一个JavScript 警告界面
- (void)webView:(WKWebView *)webView runJavaScriptAlertPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(void))completionHandler;
message是要显示的内容
frame的JavaScript进程发起这次调用
在警告界面被解除之后调用completionHandler来回调给页面
为了安全，实现这个方法的时候需要注意到警告的内容是有一个特定的网站指定的，这里有一个简单的准则就是用frame.request.URL.host属性来标识这个警告。
警告应该只有一个确定按钮
  • 显示一个JavScript 确认界面
- (void)webView:(WKWebView *)webView runJavaScriptConfirmPanelWithMessage:(NSString *)message initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(BOOL result))completionHandler;
message是要显示的内容
frame的JavaScript进程发起这次调用
在确认界面被解除之后调用completionHandler来回调给页面，点击确定传YES，取消传NO
为了安全，实现这个方法的时候需要注意到确认的内容是有一个特定的网站指定的，这里有一个简单的准则就是用frame.request.URL.host属性来标识这个确认界面
确认界面应该只有两个按钮，典型的就是确认和取消
  • 显示一个JavaScript输入界面
- (void)webView:(WKWebView *)webView runJavaScriptTextInputPanelWithPrompt:(NSString *)prompt defaultText:(NSString *)defaultText initiatedByFrame:(WKFrameInfo *)frame completionHandler:(void (^)(NSString *result))completionHandler;
message是要显示的内容
defaultText是在输入框中展示的默认文本
frame的JavaScript进程发起这次调用
在输入界面被解除之后调用completionHandler来回调给页面，点击确定传输入框的文本，取消传nil
为了安全，实现这个方法的时候需要注意到确认的内容是有一个特定的网站指定的，这里有一个简单的准则就是用frame.request.URL.host属性来标识这个确认界面
确认界面应该只有两个按钮（典型的就是确认和取消）和一个输入框
  • 通知app网页的DOM窗口已经关闭
- (void)webViewDidClose:(WKWebView *)webView;
app应该从控件关系中移除这个WebView并重新安排界面的显示
例如关闭一个浏览器tab或者窗口
  • iOS 10.0+决定是否要预览指定的WKPreviewElementInfo
- (BOOL)webView:(WKWebView *)webView shouldPreviewElement:(WKPreviewElementInfo *)elementInfo;
返回NO会禁止本次预览
这个方法只会在元素有默认的预览时调用
  • iOS 10.0+当用户发出了预览操作（比如3D Touch按压）时调用
- (UIViewController *)webView:(WKWebView *)webView previewingViewControllerForElement:(WKPreviewElementInfo *)elementInfo defaultActions:(NSArray<id<WKPreviewActionItem>> *)previewActions;
elementInfo是相关的预览信息
previewActions是元素使用的默认的操作选项（预览时上拉可见），比如打开链接，添加到阅读列表，拷贝链接，共享。返回nil则使用默认的预览表现
如果返回一个视图控制器则预览会显示这个视图控制器，并且在用户触发pop操作（继续按压）时触发webView:commitPreviewingViewController: 的调用
如果要使用默认预览操作，应用程序必须在返回的视图控制器的previewActionItems实现中运行这些操作
  • iOS 10.0+预览时用户触发pop操作（继续按压）时调用
- (void)webView:(WKWebView *)webView commitPreviewingViewController:(UIViewController *)previewingViewController;
previewingViewController就是即将展示的预览页面
你需要将这个预览界面在界面中继续展示，以保持预览的连贯性
如果你在这里什么也不做，用户的pop操作将什么也不会改变

三十三. WKWindowFeatures

WKWindowFeatures对象指定了请求一个新WebView时的窗口的可选属性

  • 窗口是否可以调整尺寸（Boolean）
@property(nonatomic, readonly) NSNumber *allowsResizing;
nil表示未被指定该属性
  • 窗口的高度（CGFloat）
@property(nonatomic, readonly) NSNumber *height;
nil表示未指定该属性
  • 窗口的宽度（CGFloat）
@property(nonatomic, readonly) NSNumber *width;
nil表示未指定该属性
  • 窗口的x坐标（CGFloat）
@property(nonatomic, readonly) NSNumber *x;
nil表示未指定该属性
  • 窗口的y坐标（CGFloat）
@property(nonatomic, readonly) NSNumber *y;
nil表示未指定该属性
  • 菜单栏是否应该可见（Boolean）
@property(nonatomic, readonly) NSNumber *menuBarVisibility;
nil表示未指定该属性
  • 状态栏是否应该可见（Boolean）
@property(nonatomic, readonly) NSNumber *statusBarVisibility;
nil表示未指定该属性
  • 工具栏是否应该可见（Boolean）
@property(nonatomic, readonly) NSNumber *toolbarsVisibility;
nil表示未指定该属性

三十四. WKPreviewElementInfo

WKPreviewElementInfo对象包含了预览网页的信息

  • 预览网页的链接
@property(nonatomic, readonly) NSURL *linkURL;

三十五. WKPreviewActionItem

WKPreviewActionItem协议提供预览操作的一些属性的访问方法。继承自UIPreviewActionItem。

  • 预览操作的标志符
@property(nonatomic, copy, readonly) NSString *identifier;

三十六. UIPreviewActionItem

快速选择操作：例如3D Touch桌面图标触发，会弹出一个或多个快速选择的表单。触发后也可以滑动选择，松开选中。

一组方法定义了您可以应用于快速选择操作和快速选择操作组的样式，并定义了一个只读访问器，用于用户可见的快速选择操作的标题。

UIPreviewActionItem被 UIPreviewAction 和 UIPreviewActionGroup 类采用，请不要应用到自定义的类上。

  • 快速选择操作的标题。系统将标题作为一个快速选择表单中的选项，当用户在上面滑动时可以看到。
@property(nonatomic, copy, readonly) NSString *title;

三十七. WKBackForwardList

一个WKBackForwardList对象维护了用户访问过的网页记录，用来前进后退到最近加载过的网页。WKBackForwardList对象仅仅维护的是列表数据，并不会执行任何实际的网页加载的操作，不会产生任何客户请求。如果你需要产生一次页面加载，请使用loadRequest: 这些方法。

  • 上一个记录
@property(nonatomic, readonly, strong) WKBackForwardListItem *backItem;
如果没有，则为nil
  • 当前记录
@property(nonatomic, readonly, strong) WKBackForwardListItem *currentItem;
  • 下一个记录
@property(nonatomic, readonly, strong) WKBackForwardListItem *forwardItem;
如果没有，则为nil
  • 相对于当前记录的位置的记录
- (WKBackForwardListItem *)itemAtIndex:(NSInteger)index;
当前位置的index为0，-1就是上一个记录，1就是下一个记录，依此类推
如果index超出范围，则返回nil
  • 当前记录之前的记录列表
@property(nonatomic, readonly, copy) NSArray<WKBackForwardListItem *> *backList;
顺序就是访问顺序
  • 当前记录之后的记录列表
@property(nonatomic, readonly, copy) NSArray<WKBackForwardListItem *> *forwardList;
顺序就是访问顺序

三十八. WKBackForwardListItem

WKBackForwardListItem对象代表了前进后退记录中的一个网页，包含了网页的一些信息（URL，标题和创建网页时的URL），前进后退记录由WKBackForwardList维护。

  • 网页的URL
@property(readonly, copy) NSURL *URL;
  • 创建记录时初始化传入的URL
@property(readonly, copy) NSURL *initialURL;
  • 网页的标题
@property(readonly, copy) NSString *title;
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,189评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,577评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,857评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,703评论 1赞 276
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,705评论 5赞 366
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,620评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,995评论 3赞 396
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,656评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,898评论 1赞 298
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,639评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,720评论 1赞 330
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,395评论 4赞 319
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,982评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,953评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,195评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 44,907评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,472评论 2赞 342

推荐阅读更多精彩内容

  • 面试题
    Swift1> Swift和OC的区别1.1> Swift没有地址/指针的概念1.2> 泛型1.3> 类型严谨 对...
    cosWriter阅读 11,084评论 1赞 32
  • WKWebView与JS交互实战技巧之API介绍
    前言 给大家介绍另外一种基于 iOS 8 新推出的 WKWebView 组件，构建出自己的混合开发框架。 WKWe...
    iwolfox阅读 1,111评论 1赞 3
  • 学习WKWebView使用、JS的交互
    前言: 目录:一、WKWebView基本介绍二、WKWebView新特性三、WebKit框架概览四、WKWebVi...
    麦穗0615阅读 1,146评论 0赞 8
  • IOS浏览控件之WKWebView
    WkWebView是IOS8中引入的新组件，苹果将UIWebViewDelegate 与 UIWebView 重构...
    i_belive阅读 5,007评论 1赞 25
  • 效能测试
    你有没有做过自己的效能测试呢？ 你的效能状态得分是多少分，通过上面的测试题可以检测。 每一项根据不同的符合程度分为...
    潘少侠阅读 1,190评论 0赞 1