Unreviewed, fix iOS build with recent SDKs.
[WebKit-https.git] / Source / WebKit / UIProcess / API / Cocoa / WKNavigationDelegate.h
1 /*
2  * Copyright (C) 2014-2019 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
14  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
15  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
17  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
19  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
21  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
22  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
23  * THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #import <WebKit/WKFoundation.h>
27
28 #import <Foundation/Foundation.h>
29
30 NS_ASSUME_NONNULL_BEGIN
31
32 @class WKNavigation;
33 @class WKNavigationAction;
34 @class WKNavigationResponse;
35 @class WKWebView;
36 @class WKWebpagePreferences;
37
38 /*! @enum WKNavigationActionPolicy
39  @abstract The policy to pass back to the decision handler from the
40  webView:decidePolicyForNavigationAction:decisionHandler: method.
41  @constant WKNavigationActionPolicyCancel   Cancel the navigation.
42  @constant WKNavigationActionPolicyAllow    Allow the navigation to continue.
43  */
44 typedef NS_ENUM(NSInteger, WKNavigationActionPolicy) {
45     WKNavigationActionPolicyCancel,
46     WKNavigationActionPolicyAllow,
47 } WK_API_AVAILABLE(macos(10.10), ios(8.0));
48
49 /*! @enum WKNavigationResponsePolicy
50  @abstract The policy to pass back to the decision handler from the webView:decidePolicyForNavigationResponse:decisionHandler: method.
51  @constant WKNavigationResponsePolicyCancel   Cancel the navigation.
52  @constant WKNavigationResponsePolicyAllow    Allow the navigation to continue.
53  */
54 typedef NS_ENUM(NSInteger, WKNavigationResponsePolicy) {
55     WKNavigationResponsePolicyCancel,
56     WKNavigationResponsePolicyAllow,
57 } WK_API_AVAILABLE(macos(10.10), ios(8.0));
58
59 /*! A class conforming to the WKNavigationDelegate protocol can provide
60  methods for tracking progress for main frame navigations and for deciding
61  policy for main frame and subframe navigations.
62  */
63 @protocol WKNavigationDelegate <NSObject>
64
65 @optional
66
67 /*! @abstract Decides whether to allow or cancel a navigation.
68  @param webView The web view invoking the delegate method.
69  @param navigationAction Descriptive information about the action
70  triggering the navigation request.
71  @param decisionHandler The decision handler to call to allow or cancel the
72  navigation. The argument is one of the constants of the enumerated type WKNavigationActionPolicy.
73  @discussion If you do not implement this method, the web view will load the request or, if appropriate, forward it to another application.
74  */
75 - (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction decisionHandler:(void (^)(WKNavigationActionPolicy))decisionHandler;
76
77 /*! @abstract Decides whether to allow or cancel a navigation.
78  @param webView The web view invoking the delegate method.
79  @param navigationAction Descriptive information about the action
80  triggering the navigation request.
81  @param preferences The default set of webpage preferences. This may be
82  changed by setting defaultWebpagePreferences on WKWebViewConfiguration.
83  @param decisionHandler The policy decision handler to call to allow or cancel
84  the navigation. The arguments are one of the constants of the enumerated type
85  WKNavigationActionPolicy, as well as an instance of WKWebpagePreferences.
86  @discussion If you implement this method,
87  -webView:decidePolicyForNavigationAction:decisionHandler: will not be called.
88  */
89 - (void)webView:(WKWebView *)webView decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction preferences:(WKWebpagePreferences *)preferences decisionHandler:(void (^)(WKNavigationActionPolicy, WKWebpagePreferences *))decisionHandler WK_API_AVAILABLE(macos(WK_MAC_TBA), ios(WK_IOS_TBA));
90
91 /*! @abstract Decides whether to allow or cancel a navigation after its
92  response is known.
93  @param webView The web view invoking the delegate method.
94  @param navigationResponse Descriptive information about the navigation
95  response.
96  @param decisionHandler The decision handler to call to allow or cancel the
97  navigation. The argument is one of the constants of the enumerated type WKNavigationResponsePolicy.
98  @discussion If you do not implement this method, the web view will allow the response, if the web view can show it.
99  */
100 - (void)webView:(WKWebView *)webView decidePolicyForNavigationResponse:(WKNavigationResponse *)navigationResponse decisionHandler:(void (^)(WKNavigationResponsePolicy))decisionHandler;
101
102 /*! @abstract Invoked when a main frame navigation starts.
103  @param webView The web view invoking the delegate method.
104  @param navigation The navigation.
105  */
106 - (void)webView:(WKWebView *)webView didStartProvisionalNavigation:(null_unspecified WKNavigation *)navigation;
107
108 /*! @abstract Invoked when a server redirect is received for the main
109  frame.
110  @param webView The web view invoking the delegate method.
111  @param navigation The navigation.
112  */
113 - (void)webView:(WKWebView *)webView didReceiveServerRedirectForProvisionalNavigation:(null_unspecified WKNavigation *)navigation;
114
115 /*! @abstract Invoked when an error occurs while starting to load data for
116  the main frame.
117  @param webView The web view invoking the delegate method.
118  @param navigation The navigation.
119  @param error The error that occurred.
120  */
121 - (void)webView:(WKWebView *)webView didFailProvisionalNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;
122
123 /*! @abstract Invoked when content starts arriving for the main frame.
124  @param webView The web view invoking the delegate method.
125  @param navigation The navigation.
126  */
127 - (void)webView:(WKWebView *)webView didCommitNavigation:(null_unspecified WKNavigation *)navigation;
128
129 /*! @abstract Invoked when a main frame navigation completes.
130  @param webView The web view invoking the delegate method.
131  @param navigation The navigation.
132  */
133 - (void)webView:(WKWebView *)webView didFinishNavigation:(null_unspecified WKNavigation *)navigation;
134
135 /*! @abstract Invoked when an error occurs during a committed main frame
136  navigation.
137  @param webView The web view invoking the delegate method.
138  @param navigation The navigation.
139  @param error The error that occurred.
140  */
141 - (void)webView:(WKWebView *)webView didFailNavigation:(null_unspecified WKNavigation *)navigation withError:(NSError *)error;
142
143 /*! @abstract Invoked when the web view needs to respond to an authentication challenge.
144  @param webView The web view that received the authentication challenge.
145  @param challenge The authentication challenge.
146  @param completionHandler The completion handler you must invoke to respond to the challenge. The
147  disposition argument is one of the constants of the enumerated type
148  NSURLSessionAuthChallengeDisposition. When disposition is NSURLSessionAuthChallengeUseCredential,
149  the credential argument is the credential to use, or nil to indicate continuing without a
150  credential.
151  @discussion If you do not implement this method, the web view will respond to the authentication challenge with the NSURLSessionAuthChallengeRejectProtectionSpace disposition.
152  */
153 - (void)webView:(WKWebView *)webView didReceiveAuthenticationChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAuthChallengeDisposition disposition, NSURLCredential * _Nullable credential))completionHandler;
154
155 /*! @abstract Invoked when the web view's web content process is terminated.
156  @param webView The web view whose underlying web content process was terminated.
157  */
158 - (void)webViewWebContentProcessDidTerminate:(WKWebView *)webView WK_API_AVAILABLE(macos(10.11), ios(9.0));
159
160 @end
161
162 NS_ASSUME_NONNULL_END