WebKitGTK+ Reference Manual: WebKitNetworkRequest

## WebKitNetworkRequest WebKitNetworkRequest — The target of a navigation request |

## Synopsis

                        WebKitNetworkRequest;
    WebKitNetworkRequest * webkit_network_request_new       (const gchar *uri);
    const gchar *       webkit_network_request_get_uri      (WebKitNetworkRequest *request);
    SoupMessage *       webkit_network_request_get_message  (WebKitNetworkRequest *request);
    void                webkit_network_request_set_uri      (WebKitNetworkRequest *request,
                                                             const gchar *uri);

## Object Hierarchy

      GObject
       +----WebKitNetworkRequest

## Properties

      "message"                  SoupMessage*          : Read / Write / Construct Only
      "uri"                      gchar*                : Read / Write

## Description

This class represents the network related aspects of a navigation request. It is used whenever WebKit wants to provide information about a request that will be sent, or has been sent. Inside it you can find the URI of the request, and, for valid URIs, a SoupMessage object, which provides access to further information such as headers.

## Details

### WebKitNetworkRequest

    typedef struct _WebKitNetworkRequest WebKitNetworkRequest;

### webkit_network_request_new ()

    WebKitNetworkRequest * webkit_network_request_new       (const gchar *uri);

Creates a new WebKitNetworkRequest initialized with an URI.

`uri` : | an URI
Returns : | a new WebKitNetworkRequest, or `NULL` if the URI is invalid.

### webkit_network_request_get_uri ()

    const gchar *       webkit_network_request_get_uri      (WebKitNetworkRequest *request);

`request` : | a WebKitNetworkRequest
Returns : | the URI of the WebKitNetworkRequest

Since 1.0.0

### webkit_network_request_get_message ()

    SoupMessage *       webkit_network_request_get_message  (WebKitNetworkRequest *request);

Obtains the SoupMessage held and used by the given request. Notice that modification of the SoupMessage of a request by signal handlers is only supported (as in, will only affect what is actually sent to the server) where explicitly documented.

`request` : | a WebKitNetworkRequest
Returns : | the SoupMessage. [transfer none]

Since 1.1.9

### webkit_network_request_set_uri ()

    void                webkit_network_request_set_uri      (WebKitNetworkRequest *request,
                                                             const gchar *uri);

Sets the URI held and used by the given request. When the request has an associated SoupMessage, its URI will also be set by this call.

`request` : | a WebKitNetworkRequest
`uri` : | an URI

## Property Details

### The `"message"` property

      "message"                  SoupMessage*          : Read / Write / Construct Only

The SoupMessage that backs the request.

Since 1.1.10

### The `"uri"` property

      "uri"                      gchar*                : Read / Write

The URI to which the request will be made.

Default value: NULL

Since 1.1.10

## See Also

"navigation-policy-decision-requested"