struct · iOS 26.0+ · SDK 27.1
struct NavigationPreferencesA type that specifies the behaviors to use when loading and rendering page content. Create a `NavigationPreferences` value when you want to change the default rendering behavior of your web page. Typically, iOS devices render web content for a mobile experience, and Mac devices render content for a desktop experience.
get allowsJSHandleCreationInPageWorld(): Promise<boolean>var allowsJSHandleCreationInPageWorld: BoolIndicates whether `window.webkit.createJSHandle` will be available in `WKContentWorld.page` The default value of this property is `false`.
setAllowsJSHandleCreationInPageWorld(value: boolean): Promise<void>var allowsJSHandleCreationInPageWorld: BoolIndicates whether `window.webkit.createJSHandle` will be available in `WKContentWorld.page` The default value of this property is `false`.
get alternateRequest(): Promise<(_Foundation_URLRequest) | null>var alternateRequest: URLRequest?Used to make changes to the network request that will be used for this navigation's main resource load.
setAlternateRequest(value?: (_Foundation_URLRequest) | null): Promise<void>var alternateRequest: URLRequest?Used to make changes to the network request that will be used for this navigation's main resource load.
get overrideReferrer(): Promise<(string) | null>var overrideReferrer: String?Used to apply a custom `referer` header to all resource loads in the frame of this navigation.
setOverrideReferrer(value?: (string) | null): Promise<void>var overrideReferrer: String?Used to apply a custom `referer` header to all resource loads in the frame of this navigation.
get preferredContentMode(): Promise<WebPage_NavigationPreferences_ContentMode>var preferredContentMode: WebPage.NavigationPreferences.ContentModeThe content mode for the web view to use when it loads and renders a webpage. The default value of this property is `recommended`. The web page ignores this preference for subframe navigation.
setPreferredContentMode(value: WebPage_NavigationPreferences_ContentMode): Promise<void>var preferredContentMode: WebPage.NavigationPreferences.ContentModeThe content mode for the web view to use when it loads and renders a webpage. The default value of this property is `recommended`. The web page ignores this preference for subframe navigation.
get isLockdownModeEnabled(): Promise<boolean>var isLockdownModeEnabled: Bool { get set }A Boolean value that indicates whether to use Lockdown Mode in the web page. By default, this reflects whether the user has enabled Lockdown Mode on the device. Update this preference to override the device setting when you implement a per-website or similar setting.
setIsLockdownModeEnabled(value: boolean): Promise<void>var isLockdownModeEnabled: Bool { get set }A Boolean value that indicates whether to use Lockdown Mode in the web page. By default, this reflects whether the user has enabled Lockdown Mode on the device. Update this preference to override the device setting when you implement a per-website or similar setting.
get allowsContentJavaScript(): Promise<boolean>var allowsContentJavaScript: BoolIndicates whether JavaScript from web content is allowed to run. The default value of this property is `true`. If you change the value to `false`, the web page doesn’t execute JavaScript code referenced by the web content. That includes JavaScript code found in inline `<script>` elements, `javascript:` URLs, and all other referenced JavaScript content.
setAllowsContentJavaScript(value: boolean): Promise<void>var allowsContentJavaScript: BoolIndicates whether JavaScript from web content is allowed to run. The default value of this property is `true`. If you change the value to `false`, the web page doesn’t execute JavaScript code referenced by the web content. That includes JavaScript code found in inline `<script>` elements, `javascript:` URLs, and all other referenced JavaScript content.
get securityRestrictionMode(): Promise<WebPage_NavigationPreferences_SecurityRestrictionMode>var securityRestrictionMode: WebPage.NavigationPreferences.SecurityRestrictionMode { get set }Security restriction mode for this navigation. Security restriction modes provide different levels of security hardening for high-risk browsing contexts. `SecurityRestrictionMode.maximizeCompatibility` provides additional hardening while maintaining full web compatibility: - JavaScript JIT compilation disabled (interpreter-only execution) - Increased Memory Tagging Extension (MTE) coverage across allocations in the WebContent process Setting a security restriction mode creates separate, isolated WebContent processes for the specified protection level. This preference only applies to main frame navigations and will be ignored for subframe navigations. When set for a main frame, all subframe content and opened windows inherit the same security restrictions. When the system has chosen `SecurityRestrictionMode.lockdown` (e.g., in Lockdown Mode), attempts to set a less restrictive mode will fail silently. The default value is `SecurityRestrictionMode.none`.
setSecurityRestrictionMode(value: WebPage_NavigationPreferences_SecurityRestrictionMode): Promise<void>var securityRestrictionMode: WebPage.NavigationPreferences.SecurityRestrictionMode { get set }Security restriction mode for this navigation. Security restriction modes provide different levels of security hardening for high-risk browsing contexts. `SecurityRestrictionMode.maximizeCompatibility` provides additional hardening while maintaining full web compatibility: - JavaScript JIT compilation disabled (interpreter-only execution) - Increased Memory Tagging Extension (MTE) coverage across allocations in the WebContent process Setting a security restriction mode creates separate, isolated WebContent processes for the specified protection level. This preference only applies to main frame navigations and will be ignored for subframe navigations. When set for a main frame, all subframe content and opened windows inherit the same security restrictions. When the system has chosen `SecurityRestrictionMode.lockdown` (e.g., in Lockdown Mode), attempts to set a less restrictive mode will fail silently. The default value is `SecurityRestrictionMode.none`.
get isGlobalPrivacyControlEnabled(): Promise<boolean>var isGlobalPrivacyControlEnabled: BoolWhether the Global Privacy Control (GPC) signal is enabled for the navigation. The default value of this property is `false`. When enabled, both `navigator.globalPrivacyControl` and the `Sec-GPC: 1` request header are active for the main frame, its subframes, and their subresources.
setIsGlobalPrivacyControlEnabled(value: boolean): Promise<void>var isGlobalPrivacyControlEnabled: BoolWhether the Global Privacy Control (GPC) signal is enabled for the navigation. The default value of this property is `false`. When enabled, both `navigator.globalPrivacyControl` and the `Sec-GPC: 1` request header are active for the main frame, its subframes, and their subresources.
get preferredHTTPSNavigationPolicy(): Promise<WebPage_NavigationPreferences_UpgradeToHTTPSPolicy>var preferredHTTPSNavigationPolicy: WebPage.NavigationPreferences.UpgradeToHTTPSPolicyUsed when performing a top-level navigation to a webpage. The default value is `.keepAsRequested`. The stated preference is ignored on subframe navigation, and it may be ignored based on system configuration. The `WebPage.Configuration.upgradeKnownHostsToHTTPS` property supersedes this property for known hosts.
setPreferredHTTPSNavigationPolicy(value: WebPage_NavigationPreferences_UpgradeToHTTPSPolicy): Promise<void>var preferredHTTPSNavigationPolicy: WebPage.NavigationPreferences.UpgradeToHTTPSPolicyUsed when performing a top-level navigation to a webpage. The default value is `.keepAsRequested`. The stated preference is ignored on subframe navigation, and it may be ignored based on system configuration. The `WebPage.Configuration.upgradeKnownHostsToHTTPS` property supersedes this property for known hosts.
static init(): Promise<WebPage_NavigationPreferences>init()Creates a new NavigationPreferences value.
No declarations were skipped in this snapshot.