[ios] Refactored dialogs suppression.

ios/web/public/web_state/ui/crw_web_delegate.h

 // Copyright 2012 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_UI_CRW_WEB_DELEGATE_H_
 #define IOS_WEB_PUBLIC_WEB_STATE_UI_CRW_WEB_DELEGATE_H_
 
 #include <stdint.h>
 #import <UIKit/UIKit.h>
 #include <vector>
@@ skipping 181 matching lines @@
 - (BOOL)webController:(CRWWebController*)webController
     shouldBlockPopupWithURL:(const GURL&)popupURL
                   sourceURL:(const GURL&)sourceURL;
 
 // Called when CRWWebController has detected and blocked a popup. In order to
 // allow the blocked pop up CRWWebDelegate must call
 // |blockedPopupInfo.ShowPopup()| instead of attempting to open a new window.
 - (void)webController:(CRWWebController*)webController
         didBlockPopup:(const web::BlockedPopupInfo&)blockedPopupInfo;
 
-// Called when CRWWebController did suppress a dialog (only if kSuppressDialogs
-// policy is set via -[CRWWebController setPageDialogsOpenPolicy:] method).
+// Called when CRWWebController did suppress a dialog (JavaScript, HTTP
+// authentication or window.open).
+// NOTE: Called only if CRWWebController.suppressDialogs is set to YES.
 - (void)webControllerDidSuppressDialog:(CRWWebController*)webController;
 
 // Called to retrieve the height of any header that is overlaying on top of the
 // web view. This can be used to implement, for e.g. a toolbar that changes
 // height dynamically. Returning a non-zero height affects the visible frame
 // shown by the CRWWebController. 0.0 is assumed if not implemented.
 - (CGFloat)headerHeightForWebController:(CRWWebController*)webController;
 
 // Called when CRWWebController updated the SSL status for the current
 // NagivationItem.
@@ skipping 10 matching lines @@
 // Called when a PassKit file is downloaded. |data| should be the data from a
 // PassKit file, but this is not guaranteed, and the delegate is responsible for
 // error handling non PassKit data using -[PKPass initWithData:error:]. If the
 // download does not successfully complete, |data| will be nil.
 - (void)webController:(CRWWebController*)webController
     didLoadPassKitObject:(NSData*)data;
 
 @end
 
 #endif  // IOS_WEB_PUBLIC_WEB_STATE_UI_CRW_WEB_DELEGATE_H_