PyQt6-WebEngine-Qt6

6.11.0 · active · verified Sun Apr 12

PyQt6-WebEngine-Qt6 is a supplementary package containing the essential subset of a Qt installation specifically required by PyQt6-WebEngine. It typically installs automatically as a dependency when a user installs PyQt6-WebEngine, which provides Python bindings for the Qt WebEngine framework. This framework enables embedding web content in applications using a Chromium-based engine. The current version is 6.11.0, and its release cadence generally aligns with updates to PyQt6 and the underlying Qt WebEngine.

Warnings

breaking When migrating from PyQt5, the import structure for WebEngine classes has changed. Classes are now strictly separated into `PyQt6.QtWebEngineWidgets` (for widgets like `QWebEngineView`) and `PyQt6.QtWebEngineCore` (for core functionalities like `QWebEnginePage`, `QWebEngineProfile`). Direct imports from the main `PyQt6` namespace or `QtWidgets` for WebEngine components will fail.
Fix: Update import statements: `from PyQt5.QtWebEngineWidgets import X` becomes `from PyQt6.QtWebEngineWidgets import X`, and `QWebEnginePage` (and similar core classes) should be imported from `PyQt6.QtWebEngineCore`.
breaking Several Qt WebEngine API methods have moved or changed signatures in Qt 6. For example, `QWebEnginePage::print()` no longer takes a callback and has moved to `QWebEngineView::print()`, signalling completion with `QWebEngineView::printFinished()`. Similarly, `QWebEngineDownloadItem` has been renamed to `QWebEngineDownloadRequest` and moved to `QtWebEngineCore`.
Fix: Consult the official Qt 6 WebEngine documentation and PyQt6 examples for updated method calls and class locations. Refactor code to use new signals/slots and class names.
gotcha The method to start the application's event loop has changed from `app.exec_()` (used in older Python 2 compatible PyQt5 code) to `app.exec()` in PyQt6. While `app.exec()` is also available and preferred in modern PyQt5, using `app.exec_()` will raise an error in PyQt6.
Fix: Always use `app.exec()` to start the application's event loop.
gotcha QWebEngineView does not automatically handle pop-up windows (e.g., those created by JavaScript `window.open()`). To support these, you must subclass `QWebEngineView` and reimplement its `createWindow()` method.
Fix: Create a custom `QWebEngineView` subclass and override `createWindow()` to instantiate and return a new `QWebEngineView` (or a custom `WebPopupWindow`) for each new window request.
gotcha Users have reported performance issues such as laggy scrolling and jerky videos with specific Qt WebEngine versions (e.g., Qt 6.7.0-1) on certain platforms, particularly Linux/X11, and sometimes involving specific GPU drivers. This may manifest as 'glitching' or 'Z-fighting'.
Fix: If encountering severe performance issues, try downgrading the `PyQt6-WebEngine-Qt6` package (or `PyQt6-WebEngine`) to an earlier minor version if possible. Report issues to the PyQt or Qt bug trackers, providing detailed system and GPU information. Disabling hardware acceleration might be a workaround in some cases.

Install

pip install PyQt6-WebEngine Install PyQt6-WebEngine (includes PyQt6-WebEngine-Qt6)

Imports

QWebEngineView
```
from PyQt6.QtWebEngineWidgets import QWebEngineView
```
In PyQt6, WebEngine components are in a dedicated submodule, not directly under QtWidgets or the main PyQt6 namespace.
QWebEnginePage
```
from PyQt6.QtWebEngineCore import QWebEnginePage
```
Many core WebEngine classes, including QWebEnginePage, moved from QtWebEngineWidgets to QtWebEngineCore in Qt6.
QUrl
```
from PyQt6.QtCore import QUrl
```

Quickstart

This quickstart demonstrates how to embed a basic web browser using `QWebEngineView` to display a URL. It initializes a `QApplication`, creates a `QWidget` to host the `QWebEngineView`, and sets a target URL. The `sys.exit(app.exec())` line starts the event loop, displaying the window.

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


class SimpleBrowser(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('PyQt6 WebEngine Browser')
        self.setGeometry(100, 100, 1024, 768)

        layout = QVBoxLayout(self)
        self.webview = QWebEngineView()
        layout.addWidget(self.webview)

        # Load a URL (e.g., Google or your own site)
        self.webview.setUrl(QUrl('https://www.google.com'))

        self.setLayout(layout)


if __name__ == '__main__':
    app = QApplication(sys.argv)
    browser = SimpleBrowser()
    browser.show()
    sys.exit(app.exec())

view raw JSON →