WebInspector#

class WebInspector(**properties: Any)#

Superclasses: Object

Access to the WebKit inspector.

The WebKit Inspector is a graphical tool to inspect and change the content of a WebView. It also includes an interactive JavaScript debugger. Using this class one can get a Widget which can be embedded into an application to show the inspector.

The inspector is available when the Settings of the WebView has set the Settings:enable-developer-extras to true, otherwise no inspector is available.

// Enable the developer extras
WebKitSettings *settings = webkit_web_view_get_settings (WEBKIT_WEB_VIEW(my_webview));
g_object_set (G_OBJECT(settings), "enable-developer-extras", TRUE, NULL);

// Load some data or reload to be able to inspect the page
webkit_web_view_load_uri (WEBKIT_WEB_VIEW(my_webview), "http://www.gnome.org");

// Show the inspector
WebKitWebInspector *inspector = webkit_web_view_get_inspector (WEBKIT_WEB_VIEW(my_webview));
webkit_web_inspector_show (WEBKIT_WEB_INSPECTOR(inspector));

Methods#

class WebInspector

attach() → None#

Request inspector to be attached.

The signal WebInspector::attach will be emitted. If the inspector is already attached it does nothing.

close() → None#: Request inspector to be closed.

detach() → None#

Request inspector to be detached.

The signal WebInspector::detach will be emitted. If the inspector is already detached it does nothing.

get_attached_height() → int#

Get the height that the inspector view when attached.

Get the height that the inspector view should have when it’s attached. If the inspector view is not attached this returns 0.

get_can_attach() → bool#: Whether the inspector can be attached to the same window that contains the inspected view.

Added in version 2.8.

get_inspected_uri() → str#

Get the URI that is currently being inspected.

This can be None if nothing has been loaded yet in the inspected view, if the inspector has been closed or when inspected view was loaded from a HTML string instead of a URI.

get_web_view() → WebViewBase#

Get the WebViewBase used to display the inspector.

This might be None if the inspector hasn’t been loaded yet, or it has been closed.

is_attached() → bool#: Whether the inspector view is currently attached to the same window that contains the inspected view.

show() → None#: Request inspector to be shown.

Properties#

class WebInspector

props.attached_height: int#: The type of the None singleton.

props.can_attach: bool#: The type of the None singleton.

Added in version 2.8.

props.inspected_uri: str#: The type of the None singleton.

Signals#

class WebInspector.signals

attach() → bool#

Emitted when the inspector is requested to be attached to the window where the inspected web view is. If this signal is not handled the inspector view will be automatically attached to the inspected view, so you only need to handle this signal if you want to attach the inspector view yourself (for example, to add the inspector view to a browser tab).

To prevent the inspector view from being attached you can connect to this signal and simply return True.

bring_to_front() → bool#: The type of the None singleton.

closed() → None#: The type of the None singleton.

detach() → bool#

Emitted when the inspector is requested to be detached from the window it is currently attached to. The inspector is detached when the inspector page is about to be closed, and this signal is emitted right before WebInspector::closed, or when the user clicks on the detach button in the inspector view to show the inspector in a separate window. In this case the signal WebInspector::open-window is emitted after this one.

To prevent the inspector view from being detached you can connect to this signal and simply return True.

open_window() → bool#: The type of the None singleton.

WebInspector#

Methods#

Properties#

Signals#

This Page