ios/web/public/web_state/crw_web_user_interface_delegate.h

// Copyright 2014 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef IOS_WEB_PUBLIC_WEB_STATE_CRW_WEB_USER_INTERFACE_DELEGATE_H_
#define IOS_WEB_PUBLIC_WEB_STATE_CRW_WEB_USER_INTERFACE_DELEGATE_H_

#include <Foundation/Foundation.h>

@class CRWWebController;
class GURL;

@protocol CRWWebUserInterfaceDelegate<NSObject>

 @optional
// The JavaScript panel selectors below are only called by the web controller
// for builds with WKWebView enabled.

// Displays a JavaScript alert with an OK button, showing the provided message.
// |completionHandler| is called after the OK button on the alert is tapped.
// If this selector isn't implemented, the completion handler provided by the
// web view will be called without any UI displayed. If this method is
// implemented, but |completionHandler| is not called then
// NSInternalInconsistencyException will be thrown.
- (void)webController:(CRWWebController*)webController
    runJavaScriptAlertPanelWithMessage:(NSString*)message
                            requestURL:(const GURL&)requestURL
                     completionHandler:(void (^)(void))completionHandler;

// Displays a JavaScript confirm alert with an OK and Cancel button, showing the
// provided message.  |completionHandler| is called after a button is pressed,
// with |isConfirmed| indicating whether OK was pressed.  If this selector isn't
// implemented, the completion handler provided by the web view will be called
// with |isConfirmed| = NO. If this method is implemented, but
// |completionHandler| is not called then NSInternalInconsistencyException will
// be thrown.
- (void)webController:(CRWWebController*)webController
    runJavaScriptConfirmPanelWithMessage:(NSString*)message
                              requestURL:(const GURL&)requestURL
                       completionHandler:
        (void (^)(BOOL isConfirmed))completionHandler;

// Displays a JavaScript input alert with an OK and Cancel button, showing the
// provided message and default text.  |completionHandler| is called after a
// button is pressed.  If the OK button is pressed, |input| contains the user
// text.  If the cancel but is pressed, |input| will be nil.  If this selector
// isn't implemented, the completion handler provided by the web view will be
// called with |input| = nil. If this method is implemented, but
// |completionHandler| is not called then NSInternalInconsistencyException will
// be thrown.
- (void)webController:(CRWWebController*)webController
    runJavaScriptTextInputPanelWithPrompt:(NSString*)message
                              defaultText:(NSString*)defaultText
                               requestURL:(const GURL&)requestURL
                        completionHandler:
                            (void (^)(NSString* input))completionHandler;

// Displays an HTTP authentication dialog.  |completionHandler| should be called
// with non-nil |username| and |password| if embedder wants to proceed with
// authentication.  If this selector isn't implemented or completion is called
// with nil |username| and nil |password|, authentication will be cancelled.
// If this method is implemented, but |handler| is not called then
// NSInternalInconsistencyException will be thrown.
- (void)webController:(CRWWebController*)webController
    runAuthDialogForProtectionSpace:(NSURLProtectionSpace*)protectionSpace
                 proposedCredential:(NSURLCredential*)credential
                  completionHandler:
                      (void (^)(NSString* user, NSString* password))handler;

// Cancels any outstanding dialogs requested by the methods above.
- (void)cancelDialogsForWebController:(CRWWebController*)webController;

@end

#endif  // IOS_WEB_PUBLIC_WEB_STATE_CRW_WEB_USER_INTERFACE_DELEGATE_H_