If you want to embed (third-party) web content in an Electron
there are three options available to you:
BrowserViews. Each one offers slightly different functionality and is
useful in different situations. To help you choose between these, this guide
explains the differences and capabilities of each option.
Iframes in Electron behave like iframes in regular browsers. An
element in your page can show external web pages, provided that their
Content Security Policy
allows it. To limit the number of capabilities of a site in an
it is recommended to use the
and only allow the capabilities you want to support.
Important Note: we do not recommend you to use WebViews, as this tag undergoes dramatic architectural changes that may affect stability of your application. Consider switching to alternatives, like
BrowserView, or an architecture that avoids embedded content by design.
WebViews are based on Chromium's WebViews and are not
explicitly supported by Electron. We do not guarantee that the WebView API will
remain available in future versions of Electron. To use
<webview> tags, you
will need to set
true in the
webPreferences of your
WebView is a custom element (
<webview>) that will only work inside Electron.
They are implemented as an "out-of-process iframe". This means that all
communication with the
<webview> is done asynchronously using IPC. The
<webview> element has many custom methods and events, similar to
webContents, that provide you with greater control over the content.
Compared to an
<webview> tends to be slightly slower but offers
much greater control in loading and communicating with the third-party content
and handling various events.
BrowserViews are not a part of the DOM - instead,
they are created in and controlled by your Main process. They are simply
another layer of web content on top of your existing window. This means
that they are completely separate from your own
BrowserWindow content and
their position is not controlled by the DOM or CSS. Instead, it is controlled
by setting the bounds in the Main process.
BrowserViews offer the greatest control over their contents, since they
webContents similarly to how the
BrowserWindow does it.
BrowserViews are not a part of your DOM, but are rather overlaid
on top of them, you will have to manage their position manually.