Sur cette page

QWebEngineHttpRequest Class

La classe QWebEngineHttpRequest contient une requête à envoyer à WebEngine. Plus...

En-tête : #include <QWebEngineHttpRequest>
CMake : find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake : QT += webenginecore

Types publics

enum Method { Get, Post }

Fonctions publiques

QWebEngineHttpRequest(const QUrl &url = QUrl(), const QWebEngineHttpRequest::Method &method = QWebEngineHttpRequest::Get)
QWebEngineHttpRequest(const QWebEngineHttpRequest &other)
~QWebEngineHttpRequest()
bool hasHeader(const QByteArray &headerName) const
QByteArray header(const QByteArray &headerName) const
QList<QByteArray> headers() const
QWebEngineHttpRequest::Method method() const
QByteArray postData() const
void setHeader(const QByteArray &headerName, const QByteArray &headerValue)
void setMethod(QWebEngineHttpRequest::Method method)
void setPostData(const QByteArray &postData)
void setUrl(const QUrl &url)
void swap(QWebEngineHttpRequest &other)
void unsetHeader(const QByteArray &key)
QUrl url() const
bool operator!=(const QWebEngineHttpRequest &other) const
QWebEngineHttpRequest &operator=(const QWebEngineHttpRequest &other)
bool operator==(const QWebEngineHttpRequest &other) const

Membres publics statiques

QWebEngineHttpRequest postRequest(const QUrl &url, const QMap<QString, QString> &postData)

Description détaillée

QWebEngineHttpRequest représente une requête HTTP dans la pile réseau WebEngine. Il contient les informations nécessaires pour envoyer une requête sur le réseau. Il contient une URL et quelques informations auxiliaires qui peuvent être utilisées pour modifier la demande. QWebEnginePage::load () et QWebEngineView::load() acceptent tous deux un QWebEngineHttpRequest comme paramètre.

Documentation sur les types de membres

enum QWebEngineHttpRequest::Method

Ce type d'énumération décrit la méthode utilisée pour envoyer la requête HTTP :

ConstanteValeurDescription de la méthode
QWebEngineHttpRequest::Get0La méthode GET.
QWebEngineHttpRequest::Post1La méthode POST.

Documentation des fonctions membres

[explicit] QWebEngineHttpRequest::QWebEngineHttpRequest(const QUrl &url = QUrl(), const QWebEngineHttpRequest::Method &method = QWebEngineHttpRequest::Get)

Construit un objet QWebEngineHttpRequest avec url comme URL à demander et method comme méthode à utiliser.

Voir aussi url() et setUrl().

QWebEngineHttpRequest::QWebEngineHttpRequest(const QWebEngineHttpRequest &other)

Crée une copie de other.

[noexcept] QWebEngineHttpRequest::~QWebEngineHttpRequest()

Se débarrasse de l'objet QWebEngineHttpRequest.

bool QWebEngineHttpRequest::hasHeader(const QByteArray &headerName) const

Renvoie true si l'en-tête headerName est présent dans cette requête WebEngine.

Voir aussi setHeader(), header(), unsetHeader() et headers().

Renvoie l'en-tête spécifié par headerName. Si un tel en-tête n'est pas présent, un QByteArray vide est renvoyé, ce qui peut être impossible à distinguer d'un en-tête présent mais sans contenu (utilisez hasHeader() pour savoir si l'en-tête existe ou non).

Les en-têtes peuvent être définis avec setHeader().

Voir aussi setHeader(), hasHeader(), unsetHeader() et headers().

QList<QByteArray> QWebEngineHttpRequest::headers() const

Renvoie une liste de tous les en-têtes définis dans cette requête WebEngine. La liste est établie dans l'ordre dans lequel les en-têtes ont été définis.

Voir aussi setHeader(), header(), hasHeader() et unsetHeader().

QWebEngineHttpRequest::Method QWebEngineHttpRequest::method() const

Renvoie la méthode utilisée par cette requête WebEngine.

Voir aussi setMethod().

QByteArray QWebEngineHttpRequest::postData() const

Renvoie les données POST (brutes) que contient cette requête WebEngine.

Voir aussi setPostData().

[static] QWebEngineHttpRequest QWebEngineHttpRequest::postRequest(const QUrl &url, const QMap<QString, QString> &postData)

Construit un QWebEngineHttpRequest vers url qui utilise la méthode POST.

Remarque : postData peut contenir des chaînes arbitraires. Elles sont traduites en données brutes appropriées.

Voir aussi postData et setPostData().

void QWebEngineHttpRequest::setHeader(const QByteArray &headerName, const QByteArray &headerValue)

Définit l'en-tête headerName comme étant de valeur headerValue.

Remarque : le fait de définir deux fois le même en-tête annule le paramètre précédent. Pour obtenir le comportement de plusieurs en-têtes HTTP du même nom, vous devez concaténer les deux valeurs, en les séparant par une virgule (",") et définir un seul en-tête.

Voir aussi header(), hasHeader(), unsetHeader() et headers().

void QWebEngineHttpRequest::setMethod(QWebEngineHttpRequest::Method method)

Définit la méthode utilisée par cette requête WebEngine comme étant method.

Voir aussi method().

void QWebEngineHttpRequest::setPostData(const QByteArray &postData)

Définit les données POST (brutes) que cette requête WebEngine contient comme étant postData.

Voir aussi postData().

void QWebEngineHttpRequest::setUrl(const QUrl &url)

Définit l'URL à laquelle cette requête WebEngine fait référence comme étant url.

Voir aussi url().

[noexcept] void QWebEngineHttpRequest::swap(QWebEngineHttpRequest &other)

Remplace cette requête WebEngine par other. Cette fonction est très rapide et n'échoue jamais.

void QWebEngineHttpRequest::unsetHeader(const QByteArray &key)

Supprime l'en-tête spécifié par key, s'il est présent.

Voir aussi setHeader(), header(), hasHeader() et headers().

QUrl QWebEngineHttpRequest::url() const

Renvoie l'URL à laquelle cette requête WebEngine fait référence.

Voir aussi setUrl().

bool QWebEngineHttpRequest::operator!=(const QWebEngineHttpRequest &other) const

Renvoie false si cet objet est différent de other.

Voir aussi operator==().

QWebEngineHttpRequest &QWebEngineHttpRequest::operator=(const QWebEngineHttpRequest &other)

Crée une copie de other.

bool QWebEngineHttpRequest::operator==(const QWebEngineHttpRequest &other) const

Renvoie true si cet objet est identique à other (c'est-à-dire s'ils ont la même méthode, la même URL et les mêmes en-têtes).

Voir aussi operator!=().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.