Top |
WebKitSecurityOrigin is a representation of a security domain defined by websites. A security origin normally consists of a protocol, a hostname, and a port number. It is also possible for a security origin to be opaque, as defined by the HTML standard, in which case it has no associated protocol, host, or port.
Websites with the same security origin can access each other's resources for client-side scripting or database access.
WebKitSecurityOrigin * webkit_security_origin_new (const gchar *protocol
,const gchar *host
,guint16 port
);
Create a new security origin from the provided protocol, host and port.
protocol |
The protocol for the new origin |
|
host |
The host for the new origin |
|
port |
The port number for the new origin, or 0 to indicate the
default port for |
Since: 2.16
WebKitSecurityOrigin *
webkit_security_origin_new_for_uri (const gchar *uri
);
Create a new security origin from the provided URI. Components of
uri
other than protocol, host, and port do not affect the created
WebKitSecurityOrigin.
Since: 2.16
WebKitSecurityOrigin *
webkit_security_origin_ref (WebKitSecurityOrigin *origin
);
Atomically increments the reference count of origin
by one.
This function is MT-safe and may be called from any thread.
Since: 2.16
void
webkit_security_origin_unref (WebKitSecurityOrigin *origin
);
Atomically decrements the reference count of origin
by one.
If the reference count drops to 0, all memory allocated by
WebKitSecurityOrigin is released. This function is MT-safe and may be
called from any thread.
Since: 2.16
const gchar *
webkit_security_origin_get_protocol (WebKitSecurityOrigin *origin
);
Gets the protocol of origin
, or NULL
if origin
is opaque.
Returns (allow-none): The protocol of the WebKitSecurityOrigin
Since: 2.16
const gchar *
webkit_security_origin_get_host (WebKitSecurityOrigin *origin
);
Gets the hostname of origin
, or NULL
if origin
is opaque or if its
protocol does not require a host component.
Since: 2.16
guint16
webkit_security_origin_get_port (WebKitSecurityOrigin *origin
);
Gets the port of origin
. This function will always return 0 if the
port is the default port for the given protocol. For example,
http://example.com has the same security origin as
http://example.com:80, and this function will return 0 for a
WebKitSecurityOrigin constructed from either URI. It will also
return 0 if origin
is opaque.
Since: 2.16
gboolean
webkit_security_origin_is_opaque (WebKitSecurityOrigin *origin
);
Gets whether origin
is an opaque security origin, which does not
possess an associated protocol, host, or port.
Since: 2.16
gchar *
webkit_security_origin_to_string (WebKitSecurityOrigin *origin
);
Gets a string representation of origin
. The string representation
is a valid URI with only protocol, host, and port components. It may
be NULL
, but usually only if origin
is opaque.
Since: 2.16