Contents

webExtensionController(_:openNewWindowUsing:for:completionHandler:)

Called when an extension context requests a new window to be opened.

Declaration

optional func webExtensionController(_ controller: WKWebExtensionController, openNewWindowUsing configuration: WKWebExtension.WindowConfiguration, for extensionContext: WKWebExtensionContext, completionHandler: @escaping ((any WKWebExtensionWindow)?, (any Error)?) -> Void)
optional func webExtensionController(_ controller: WKWebExtensionController, openNewWindowUsing configuration: WKWebExtension.WindowConfiguration, for extensionContext: WKWebExtensionContext) async throws -> (any WKWebExtensionWindow)?

Parameters

  • controller:

    The web extension controller that is managing the extension.

  • configuration:

    The configuration specifying how the new window should be created.

  • extensionContext:

    The context in which the web extension is running.

  • completionHandler:

    A block to be called with the newly created window or nil if the window wasn’t created. An error should be provided if any errors occurred.

Discussion

This method should be implemented by the app to handle requests to open new windows. The app can decide how to handle the process based on the provided configuration and existing windows. Once handled, the app should call the completion handler with the opened window or nil if the request was declined or failed. If not implemented, the extension will be unable to open new windows.