WebKit.PolicyDecision¶

Subclasses:: WebKit.NavigationPolicyDecision, WebKit.ResponsePolicyDecision

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

	`download` ()
	`ignore` ()
	`use` ()
	`use_with_policies` (policies)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent_instance	`GObject.Object`	r

Class Details¶

class WebKit.PolicyDecision(**kwargs)¶

Bases:: GObject.Object
Abstract:: Yes
Structure:: WebKit.PolicyDecisionClass

A pending policy decision.

Often WebKit allows the client to decide the policy for certain operations. For instance, a client may want to open a link in a new tab, block a navigation entirely, query the user or trigger a download instead of a navigation. In these cases WebKit will fire the WebKit.WebView ::decide-policy signal with a WebKit.PolicyDecision object. If the signal handler does nothing, WebKit will act as if WebKit.PolicyDecision.use() was called as soon as signal handling completes. To make a policy decision asynchronously, simply increment the reference count of the WebKit.PolicyDecision object.

download()¶: Spawn a download from this decision.

ignore()¶

WebKit.ResponsePolicyDecision, this would cancel the request.

Ignore the action which triggered this decision. For instance, for a WebKit.ResponsePolicyDecision, this would cancel the request.

use()¶: Accept the action which triggered this decision.

use_with_policies(policies)¶

Parameters:: policies (WebKit.WebsitePolicies) – a WebKit.WebsitePolicies

Accept the navigation action and continue with provided policies.

Accept the navigation action which triggered this decision, and continue with policies affecting all subsequent loads of resources in the origin associated with the accepted navigation action.

For example, a navigation decision to a video sharing website may be accepted under the priviso no movies are allowed to autoplay. The autoplay policy in this case would be set in the policies.

New in version 2.30.