Package org.gnome.webkit

Class PermissionStateQuery

java.lang.Object

io.github.jwharm.javagi.base.ProxyInstance

org.gnome.webkit.PermissionStateQuery

All Implemented Interfaces:

Proxy

@Generated("io.github.jwharm.JavaGI")
public class PermissionStateQuery
extends ProxyInstance

This query represents a user's choice to allow or deny access to "powerful features" of the platform, as specified in the [Permissions W3C Specification](https://w3c.github.io/permissions/).

When signalled by the WebKitWebView through the query-permission-state signal, the application has to eventually respond, via webkit_permission_state_query_finish(), whether it grants, denies or requests a dedicated permission prompt for the given query.

When a WebKitPermissionStateQuery is not handled by the user, the user-agent is instructed to prompt the user for the given permission.

Constructor Summary

Constructors

Constructor	Description
PermissionStateQuery(MemorySegment address)	Create a PermissionStateQuery proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
void	finish(PermissionState state)	Notify the web-engine of the selected permission state for the given query.
String	getName()	Get the permission name for which access is being queried.
SecurityOrigin	getSecurityOrigin()	Get the permission origin for which access is being queried.
static Type	getType()	Get the GType of the PermissionStateQuery class
PermissionStateQuery	ref()	Atomically increments the reference count of this PermissionStateQuery by one.
void	unref()	Atomically decrements the reference count of this PermissionStateQuery by one.

Methods inherited from class io.github.jwharm.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Details

PermissionStateQuery

public PermissionStateQuery(MemorySegment address)

Create a PermissionStateQuery proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Method Details

getType

public static Type getType()

Get the GType of the PermissionStateQuery class

Returns:

the GType

finish

public void finish(PermissionState state)

Notify the web-engine of the selected permission state for the given query. This function should only be called as a response to the WebKitWebView::query-permission-state signal.

Parameters:

state - a WebKitPermissionState

getName

public String getName()

Get the permission name for which access is being queried.

Returns:

the permission name for this PermissionStateQuery

getSecurityOrigin

public SecurityOrigin getSecurityOrigin()

Get the permission origin for which access is being queried.

Returns:

A WebKitSecurityOrigin representing the origin from which the this PermissionStateQuery was emitted.

ref

public PermissionStateQuery ref()

Atomically increments the reference count of this PermissionStateQuery by one.

This function is MT-safe and may be called from any thread.

Returns:

The passed WebKitPermissionStateQuery

unref

public void unref()

Atomically decrements the reference count of this PermissionStateQuery by one.

If the reference count drops to 0, all memory allocated by WebKitPermissionStateQuery is released. This function is MT-safe and may be called from any thread.