1 files changed, 72 insertions, 0 deletions
diff --git a/src/core/api/qwebengineframe.h b/src/core/api/qwebengineframe.h
new file mode 100644
index 000000000..988d50d8e
--- /dev/null
+++ b/src/core/api/qwebengineframe.h
@@ -0,0 +1,72 @@
+// Copyright (C) 2024 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 QWEBENGINEFRAME_H
+#define QWEBENGINEFRAME_H
+
+#include <QtWebEngineCore/qtwebenginecoreglobal.h>
+#include <QtQml/qqmlregistration.h>
+#include <QtQml/qjsvalue.h>
+#include <QtCore/qcompare.h>
+#include <QtCore/QList>
+#include <QtCore/QSizeF>
+#include <QtCore/QString>
+#include <QtCore/QUrl>
+
+namespace QtWebEngineCore {
+class WebContentsAdapterClient;
+}
+
+QT_BEGIN_NAMESPACE
+
+class Q_WEBENGINECORE_EXPORT QWebEngineFrame
+{
+    Q_GADGET
+
+    Q_PROPERTY(bool isValid READ isValid FINAL)
+    Q_PROPERTY(QString name READ name FINAL)
+    Q_PROPERTY(QString htmlName READ htmlName FINAL)
+    Q_PROPERTY(QUrl url READ url FINAL)
+    Q_PROPERTY(QSizeF size READ size FINAL)
+
+public:
+    QML_VALUE_TYPE(webEngineFrame)
+    QML_ADDED_IN_VERSION(6, 8)
+
+    bool isValid() const;
+    QString name() const;
+    QString htmlName() const;
+    QList<QWebEngineFrame> children() const;
+    QUrl url() const;
+    QSizeF size() const;
+
+    void runJavaScript(const QString &script,
+                       const std::function<void(const QVariant &)> &callback);
+    void runJavaScript(const QString &script, quint32 worldId,
+                       const std::function<void(const QVariant &)> &callback);
+    Q_INVOKABLE void runJavaScript(const QString &script, quint32 worldId = 0);
+    Q_INVOKABLE void runJavaScript(const QString &script, const QJSValue &callback);
+    Q_INVOKABLE void runJavaScript(const QString &script, quint32 worldId,
+                                   const QJSValue &callback);
+
+    friend inline bool comparesEqual(const QWebEngineFrame &lhs,
+                                     const QWebEngineFrame &rhs) noexcept
+    {
+        return lhs.m_adapterClient == rhs.m_adapterClient && lhs.m_id == rhs.m_id;
+    }
+
+    Q_DECLARE_EQUALITY_COMPARABLE(QWebEngineFrame);
+
+private:
+    friend class QWebEnginePage;
+    friend class QQuickWebEngineView;
+
+    QWebEngineFrame(QtWebEngineCore::WebContentsAdapterClient *page, quint64 id);
+
+    QtWebEngineCore::WebContentsAdapterClient *m_adapterClient;
+    quint64 m_id;
+};
+
+QT_END_NAMESPACE
+
+#endif // QWEBENGINEFRAME_H