[Cocoa] Get rid of WK_ macros for nullability
[WebKit-https.git] / Source / WebKit2 / UIProcess / API / Cocoa / WKUserContentController.h
index 6b8ce3de2bd1481e69b59525f54a3bf44f280e1f..c98ef2e03b8c35ef3e3181b77136fdbb407d9516 100644 (file)
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 
-#import <Foundation/Foundation.h>
 #import <WebKit/WKFoundation.h>
 
 #if WK_API_ENABLED
 
+#import <Foundation/Foundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class WKUserScript;
 @protocol WKScriptMessageHandler;
 
-/*! WKUserContentController provides a way for JavaScript to post messages to the @link WKWebView @/link.
- A @link WKWebView @/link can specify which WKUserContentController object it uses through its @link WKWebViewConfiguration @/link.
+/*! A WKUserContentController object provides a way for JavaScript to post
+ messages to a web view.
+ The user content controller associated with a web view is specified by its
+ web view configuration.
  */
-WK_API_CLASS
+WK_CLASS_AVAILABLE(10_10, 8_0)
 @interface WKUserContentController : NSObject
 
+/*! @abstract The user scripts associated with this user content
+ controller.
+*/
+@property (nonatomic, readonly, copy) WK_ARRAY(WKUserScript *) *userScripts;
+
+/*! @abstract Adds a user script.
+ @param userScript The user script to add.
+*/
+- (void)addUserScript:(WKUserScript *)userScript;
+
+/*! @abstract Removes all associated user scripts.
+*/
+- (void)removeAllUserScripts;
+
 /*! @abstract Adds a script message handler.
- @param scriptMessageHandler The message handler where the messages should be delivered.
+ @param scriptMessageHandler The message handler to add.
  @param name The name of the message handler.
- @discussion Adding a scriptMessageHandler adds a function window.webkit.messaging.<name>.postMessage(<messageBody>) for all frames.
+ @discussion Adding a scriptMessageHandler adds a function
+ window.webkit.messageHandlers.<name>.postMessage(<messageBody>) for all
+ frames.
  */
 - (void)addScriptMessageHandler:(id <WKScriptMessageHandler>)scriptMessageHandler name:(NSString *)name;
 
@@ -50,6 +72,6 @@ WK_API_CLASS
 
 @end
 
-#endif
-
+NS_ASSUME_NONNULL_END
 
+#endif