PyQt5中QWebEngineView与QWebEnginePage用法及请求拦截问题

嘿，我来帮你理清PyQt5里QWebEngineView和QWebEnginePage的关系，以及怎么实现拦截页面跳转请求～

简单来说，QWebEngineView是负责展示网页内容的可视化组件，你看到的网页界面就是它渲染出来的。而QWebEnginePage是背后处理网页核心逻辑的“大脑”——所有和网页加载、导航、JS交互、资源请求相关的操作，其实都是由它来完成的。

默认情况下，当你创建一个QWebEngineView实例时，它会自动生成一个QWebEnginePage对象绑定自己。所以你之前直接用QWebEngineView，本质上还是在间接使用它内部的Page对象。

要拦截所有请求（包括页面内的跳转链接），你需要自定义QWebEnginePage的子类，重写它的acceptNavigationRequest()方法，然后把这个自定义的Page替换掉QWebEngineView默认的那个就行。下面是完整的实现示例：

1. 自定义QWebEnginePage子类 #

这个子类的核心就是重写acceptNavigationRequest()，在里面判断是否允许请求继续：

from PyQt5.QtWebEngineWidgets import QWebEnginePage
from PyQt5.QtCore import QUrl

class CustomWebPage(QWebEnginePage):
    def acceptNavigationRequest(self, url, nav_type, is_main_frame):
        # 打印请求信息方便调试
        print(f"拦截到请求: {url.toString()}")
        print(f"请求类型: {nav_type}, 是否为主框架: {is_main_frame}")
        
        # 这里可以根据需求自定义拦截逻辑
        # 示例：允许主框架加载初始URL，拦截页面内的跳转链接
        if is_main_frame:
            # 主框架请求就是你通过输入框加载的那个页面，允许加载
            return True
        else:
            # 非主框架请求通常是页面内的链接点击、iframe加载等，这里拦截
            print("已拦截页面内的跳转链接")
            # 如果想允许跳转，就return True；禁止就return False
            return False

acceptNavigationRequest()的三个参数说明：

• url：目标请求的URL对象，用url.toString()可以转成字符串
• nav_type：请求的类型（比如是用户点击链接、页面重定向、刷新等，对应QWebEnginePage.NavigationType枚举）
• is_main_frame：是否是主框架的请求（主框架就是WebView显示的核心页面，非主框架是页面内的子内容）

2. 绑定自定义Page到QWebEngineView #

接下来在你的主窗口里，创建QWebEngineView实例，然后把自定义的Page设置进去：

from PyQt5.QtWidgets import QApplication, QMainWindow, QLineEdit, QPushButton, QVBoxLayout, QWidget
from PyQt5.QtWebEngineWidgets import QWebEngineView

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("导航请求拦截示例")
        self.resize(800, 600)
        
        # 创建界面组件
        self.url_input = QLineEdit()
        self.url_input.setPlaceholderText("输入URL，比如https://www.example.com")
        self.load_btn = QPushButton("加载页面")
        self.web_view = QWebEngineView()
        
        # 替换WebView的默认Page为自定义的Page
        self.custom_page = CustomWebPage(self.web_view)
        self.web_view.setPage(self.custom_page)
        
        # 布局设置
        layout = QVBoxLayout()
        layout.addWidget(self.url_input)
        layout.addWidget(self.load_btn)
        layout.addWidget(self.web_view)
        
        central_widget = QWidget()
        central_widget.setLayout(layout)
        self.setCentralWidget(central_widget)
        
        # 绑定加载按钮的点击事件
        self.load_btn.clicked.connect(self.load_target_url)
        
    def load_target_url(self):
        url_text = self.url_input.text().strip()
        if not url_text:
            return
        # 补全URL协议（如果用户没输入的话）
        if not url_text.startswith(("http://", "https://")):
            url_text = f"https://{url_text}"
        self.web_view.load(QUrl(url_text))

if __name__ == "__main__":
    app = QApplication([])
    window = MainWindow()
    window.show()
    app.exec_()

3. 自定义拦截逻辑 #

你可以根据业务需求修改acceptNavigationRequest()里的判断逻辑，比如：

• 只允许加载特定域名的链接
• 拦截所有外部链接，只允许内部跳转
• 记录所有请求的URL用于分析

举个例子，拦截所有非指定域名的链接：

def acceptNavigationRequest(self, url, nav_type, is_main_frame):
    allowed_domain = "example.com"
    url_str = url.toString()
    if allowed_domain in url_str:
        print(f"允许加载: {url_str}")
        return True
    else:
        print(f"已拦截非法链接: {url_str}")
        return False

内容的提问来源于stack exchange，提问作者Praneet Mehta