Interface WebviewPanelOptions

Content settings for a webview panel.

interface WebviewPanelOptions {
    enableFindWidget?: boolean;
    retainContextWhenHidden?: boolean;
}

Properties

enableFindWidget?: boolean

Controls if the find widget is enabled in the panel.

Defaults to false.

retainContextWhenHidden?: boolean

Controls if the webview panel's content (iframe) is kept around even when the panel is no longer visible.

Normally the webview panel's html context is created when the panel becomes visible and destroyed when it is is hidden. Extensions that have complex state or UI can set the retainContextWhenHidden to make Theia keep the webview context around, even when the webview moves to a background tab. When a webview using retainContextWhenHidden becomes hidden, its scripts and other dynamic content are suspended. When the panel becomes visible again, the context is automatically restored in the exact same state it was in originally. You cannot send messages to a hidden webview, even with retainContextWhenHidden enabled.

retainContextWhenHidden has a high memory overhead and should only be used if your panel's context cannot be quickly saved and restored.