get_uri


Description:

public unowned string get_uri ()

Returns the current active URI of this.

The active URI might change during a load operation:

<orderedlist> <listitem><para> When nothing has been loaded yet on this the active URI is null. </para></listitem> <listitem><para> When a new load operation starts the active URI is the requested URI: <itemizedlist> <listitem><para> If the load operation was started by load_uri, the requested URI is the given one. </para></listitem> <listitem><para> If the load operation was started by load_html, the requested URI is "about:blank". </para></listitem> <listitem><para> If the load operation was started by load_alternate_html, the requested URI is content URI provided. </para></listitem> <listitem><para> If the load operation was started by go_back or go_forward , the requested URI is the original URI of the previous/next item in the BackForwardList of this. </para></listitem> <listitem><para> If the load operation was started by go_to_back_forward_list_item, the requested URI is the opriginal URI of the given BackForwardListItem. </para></listitem> </itemizedlist> </para></listitem> <listitem><para> If there is a server redirection during the load operation, the active URI is the redirected URI. When the signal load_changed is emitted with webkit_load_redirected event, the active URI is already updated to the redirected URI. </para></listitem> < listitem><para> When the signal load_changed is emitted with webkit_load_committed event, the active URI is the final one and it will not change unless a new load operation is started or a navigation action within the same page is performed. </para></listitem> </orderedlist>

You can monitor the active URI by connecting to the notify:uri signal of this.

Parameters:

this

a WebView

Returns:

the current active URI of this or null if nothing has been loaded yet.




2022 vala-language.org