PyQt6 WebEngine

6.11.0 · active · verified Sun Apr 12

PyQt6-WebEngine provides Python bindings for The Qt Company's Qt WebEngine framework, allowing developers to embed web content into their applications. It leverages Chromium, an open-source web browser project, to offer a fast and secure browsing experience. The library sits atop PyQt6, implementing the WebEngine functionality through three distinct modules. Releases typically occur roughly every six months, aligning with the upstream Qt WebEngine releases.

Warnings

breaking The QtWebEngineWidgets module, which was part of the main PyQt5 installation, has been moved to a separate `pyqt6-webengine` package for PyQt6. Direct imports from `PyQt6` (e.g., `from PyQt6 import QtWebEngineWidgets`) will fail if `pyqt6-webengine` is not explicitly installed and imported from `PyQt6.QtWebEngineWidgets`.
Fix: Ensure `pyqt6-webengine` is installed (`pip install PyQt6-WebEngine`) and update imports to `from PyQt6.QtWebEngineWidgets import ...`.
gotcha Initializing QtWebEngine components (like `QWebEngineView`) sometimes requires the `QApplication` instance to be created first. Attempting to import or use `QtWebEngineWidgets` before `QApplication` is set up can lead to `ImportError: DLL load failed` or other unexpected behavior, especially on Windows.
Fix: Always create your `QApplication` instance at the very beginning of your application's entry point before instantiating `QWebEngineView` or other related classes.
gotcha Users have reported performance issues, including flickering, with `QWebEngineView` when displaying WebGL content, particularly on Windows with secondary screens. This appears to be an upstream issue within Qt WebEngine 6.x and was less prevalent in Qt 5.15.
Fix: There is no direct fix from PyQt6-WebEngine; this is an upstream Qt issue. Consider simplifying WebGL content or exploring alternative rendering methods if this is a critical use case. Testing on different OS/hardware configurations may reveal variations in behavior.
gotcha JavaScript errors within `QWebEnginePage` (accessible via `QWebEngineView.page()`) when dealing with web requests, especially authentication systems, can often be traced back to invalid or unrecognized HTTP request headers.
Fix: Carefully review and debug request headers. Removing unnecessary headers or ensuring they conform to expected standards can resolve such JavaScript errors.
breaking In Qt6 (and thus PyQt6), many short-form enums (e.g., `Qt.Checked`) have been removed. Only the long-form equivalents (e.g., `Qt.CheckState.Checked`) are available. This is a general PyQt6 change but affects any code interacting with Qt APIs, including WebEngine.
Fix: Update all enum references to their long-form (scoped) equivalents. Using `enum.Enum` or `enum.IntEnum` is the standard approach.

Install

pip install PyQt6 PyQt6-WebEngine Install PyQt6 WebEngine and its core dependency PyQt6

Imports

QWebEngineView
```
from PyQt6.QtWebEngineWidgets import QWebEngineView
```
In PyQt6, QtWebEngineWidgets is a separate top-level package and needs to be imported explicitly from PyQt6.QtWebEngineWidgets.
QUrl
```
from PyQt6.QtCore import QUrl
```
Required for setting URLs in QWebEngineView.
QApplication
```
from PyQt6.QtWidgets import QApplication
```
The core application object for any PyQt6 application.

Quickstart

This basic example demonstrates how to embed a QWebEngineView widget within a PyQt6 application to display a web page. It initializes a QApplication, creates a window with a QVBoxLayout, adds a QWebEngineView, and loads Google.com.

import sys
from PyQt6.QtWidgets import QApplication, QWidget, QVBoxLayout
from PyQt6.QtWebEngineWidgets import QWebEngineView
from PyQt6.QtCore import QUrl

app = QApplication(sys.argv)

window = QWidget()
window.setWindowTitle('Simple Web Browser')
window.setGeometry(100, 100, 800, 600)

layout = QVBoxLayout()
window.setLayout(layout)

view = QWebEngineView()
layout.addWidget(view)

# Load a URL
view.setUrl(QUrl('https://www.google.com/'))

window.show()
sys.exit(app.exec())

view raw JSON →