<!--
{
  "availability" : [
    "iOS: 18.4.0 -",
    "iPadOS: 18.4.0 -",
    "macCatalyst: 18.4.0 -",
    "macOS: 15.4.0 -",
    "visionOS: 2.4.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "WebKit",
  "identifier" : "/documentation/WebKit/WKWebExtension",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "WebKit"
    ],
    "preciseIdentifier" : "c:objc(cs)WKWebExtension"
  },
  "title" : "WKWebExtension"
}
-->

# WKWebExtension

An object that encapsulates a web extension’s resources that the manifest file defines.

```
@MainActor class WKWebExtension
```

## Overview

This class reads and parses the `manifest.json` file along with the supporting resources like icons and localizations.

## Topics

### Classes

[`WKWebExtension.Action`](/documentation/WebKit/WKWebExtension/Action)

An object that encapsulates the properties for an individual web extension action.

[`WKWebExtension.Command`](/documentation/WebKit/WKWebExtension/Command)

An object that encapsulates the properties for an individual web extension command.

[`WKWebExtension.DataRecord`](/documentation/WebKit/WKWebExtension/DataRecord)

An object that represents a record of stored data for a specific web extension context.

[`WKWebExtension.MatchPattern`](/documentation/WebKit/WKWebExtension/MatchPattern)

An object that represents a way to specify groups of URLs.

[`WKWebExtension.MessagePort`](/documentation/WebKit/WKWebExtension/MessagePort)

An object that manages message-based communication with a web extension.

[`WKWebExtension.TabConfiguration`](/documentation/WebKit/WKWebExtension/TabConfiguration)

An object that encapsulates configuration options for a tab in an extension.

[`WKWebExtension.WindowConfiguration`](/documentation/WebKit/WKWebExtension/WindowConfiguration)

An object that encapsulates configuration options for a window in an extension.

[`WKWebExtensionController.Configuration`](/documentation/WebKit/WKWebExtensionController/Configuration-swift.class)

A [`WKWebExtensionController.Configuration`](/documentation/WebKit/WKWebExtensionController/Configuration-swift.class) object with which to initialize a web extension controller.

### Structures

[`WKWebExtension.DataType`](/documentation/WebKit/WKWebExtension/DataType)

Constants for specifying data types for a [`WKWebExtension.DataRecord`](/documentation/WebKit/WKWebExtension/DataRecord).

[`WKWebExtension.Error`](/documentation/WebKit/WKWebExtension/Error)

Constants that indicate errors in the [`WKWebExtension`](/documentation/WebKit/WKWebExtension) domain.

[`WKWebExtension.Permission`](/documentation/WebKit/WKWebExtension/Permission)

Constants for specifying permission in a [`WKWebExtensionContext`](/documentation/WebKit/WKWebExtensionContext).

[`WKWebExtension.TabChangedProperties`](/documentation/WebKit/WKWebExtension/TabChangedProperties)

Constants the web extension controller and web extension context use to indicate tab changes.

### Type Aliases

[`WKWebExtension.DataType`](/documentation/WebKit/WKWebExtension/DataType)

Constants for specifying data types for a [`WKWebExtension.DataRecord`](/documentation/WebKit/WKWebExtension/DataRecord).

[`WKWebExtension.Permission`](/documentation/WebKit/WKWebExtension/Permission)

Constants for specifying permission in a [`WKWebExtensionContext`](/documentation/WebKit/WKWebExtensionContext).

### Enumerations

[`WKWebExtension.TabChangedProperties`](/documentation/WebKit/WKWebExtension/TabChangedProperties)

Constants the web extension controller and web extension context use to indicate tab changes.

[`WKWebExtension.WindowState`](/documentation/WebKit/WKWebExtension/WindowState)

Constants used by [`WKWebExtensionWindow`](/documentation/WebKit/WKWebExtensionWindow) to indicate possible states of a window.

[`WKWebExtension.WindowType`](/documentation/WebKit/WKWebExtension/WindowType)

Constants used by [`WKWebExtensionWindow`](/documentation/WebKit/WKWebExtensionWindow) to indicate the type of a window.

### Enumerations

[`WKWebExtension.WindowState`](/documentation/WebKit/WKWebExtension/WindowState)

Constants used by [`WKWebExtensionWindow`](/documentation/WebKit/WKWebExtensionWindow) to indicate possible states of a window.

[`WKWebExtension.WindowType`](/documentation/WebKit/WKWebExtension/WindowType)

Constants used by [`WKWebExtensionWindow`](/documentation/WebKit/WKWebExtensionWindow) to indicate the type of a window.

### Errors

[`WKWebExtension.Error.Code`](/documentation/WebKit/WKWebExtension/Error/Code)

Constants that indicate errors in the [`WKWebExtension`](/documentation/WebKit/WKWebExtension) domain.

[`errorDomain`](/documentation/WebKit/WKWebExtension/errorDomain)

Indicates a web extension error.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)