summaryrefslogtreecommitdiffstats
path: root/src/core/api/qwebenginenavigationrequest.h
blob: 12fc2b4a1f8b52be48cc9d1bb23811bbf523d58a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only

#ifndef QWEBENGINENAVIGATIONREQUEST_H
#define QWEBENGINENAVIGATIONREQUEST_H

#include <QtWebEngineCore/qtwebenginecoreglobal.h>
#include <QtCore/qobject.h>
#include <QtCore/qurl.h>

QT_BEGIN_NAMESPACE

class QWebEngineNavigationRequestPrivate;

class Q_WEBENGINECORE_EXPORT QWebEngineNavigationRequest : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QUrl url READ url CONSTANT FINAL)
    Q_PROPERTY(bool isMainFrame READ isMainFrame CONSTANT FINAL)
    Q_PROPERTY(NavigationType navigationType READ navigationType CONSTANT FINAL)

public:
    ~QWebEngineNavigationRequest();

    // must match WebContentsAdapterClient::NavigationType
    enum NavigationType {
        LinkClickedNavigation,
        TypedNavigation,
        FormSubmittedNavigation,
        BackForwardNavigation,
        ReloadNavigation,
        OtherNavigation,
        RedirectNavigation,
    };
    Q_ENUM(NavigationType)

    QUrl url() const;
    bool isMainFrame() const;
    NavigationType navigationType() const;

    Q_INVOKABLE void accept();
    Q_INVOKABLE void reject();

#if QT_DEPRECATED_SINCE(6, 2)
    enum NavigationRequestAction {
        AcceptRequest,
        IgnoreRequest = 0xFF
    };
    Q_ENUM(NavigationRequestAction)

private:
    Q_PROPERTY(NavigationRequestAction action READ action WRITE setAction NOTIFY actionChanged FINAL)

    QT_DEPRECATED NavigationRequestAction action() const;
    QT_DEPRECATED_X("Use accept/reject methods to handle the request")
    void setAction(NavigationRequestAction action);

Q_SIGNALS:
    QT_DEPRECATED void actionChanged();
#endif

private:
    QWebEngineNavigationRequest(const QUrl &url, NavigationType navigationType, bool mainFrame,
                                QObject *parent = nullptr);

    friend class QWebEnginePagePrivate;
    friend class QQuickWebEngineViewPrivate;
    bool isAccepted() const;

    Q_DECLARE_PRIVATE(QWebEngineNavigationRequest)
    QScopedPointer<QWebEngineNavigationRequestPrivate> d_ptr;
};

QT_END_NAMESPACE

#endif // QWEBENGINENAVIGATIONREQUEST_H