En esta página

QNetworkRequest Class

La clase `QNetworkRequest` contiene una solicitud que se enviará con ` QNetworkAccessManager`. Más información...

Cabecera: #include <QNetworkRequest>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network

Tipos públicos

enum Attribute { HttpStatusCodeAttribute, HttpReasonPhraseAttribute, RedirectionTargetAttribute, ConnectionEncryptedAttribute, CacheLoadControlAttribute, …, UserMax }
enum CacheLoadControl { AlwaysNetwork, PreferNetwork, PreferCache, AlwaysCache }
enum KnownHeaders { ContentDispositionHeader, ContentTypeHeader, ContentLengthHeader, LocationHeader, LastModifiedHeader, …, ServerHeader }
enum LoadControl { Automatic, Manual }
enum Priority { HighPriority, NormalPriority, LowPriority }
enum RedirectPolicy { ManualRedirectPolicy, NoLessSafeRedirectPolicy, SameOriginRedirectPolicy, UserVerifiedRedirectPolicy }
enum TransferTimeoutConstant { DefaultTransferTimeoutConstant }

Funciones públicas

QNetworkRequest()
QNetworkRequest(const QUrl &url)
QNetworkRequest(const QNetworkRequest &other)
~QNetworkRequest()
QVariant attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const
(since 6.2) qint64 decompressedSafetyCheckThreshold() const
bool hasRawHeader(QAnyStringView headerName) const
QVariant header(QNetworkRequest::KnownHeaders header) const
(since 6.8) QHttpHeaders headers() const
(since 6.5) QHttp1Configuration http1Configuration() const
QHttp2Configuration http2Configuration() const
int maximumRedirectsAllowed() const
QObject *originatingObject() const
QString peerVerifyName() const
QNetworkRequest::Priority priority() const
QByteArray rawHeader(QAnyStringView headerName) const
QList<QByteArray> rawHeaderList() const
void setAttribute(QNetworkRequest::Attribute code, const QVariant &value)
(since 6.2) void setDecompressedSafetyCheckThreshold(qint64 threshold)
void setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)
(since 6.8) void setHeaders(QHttpHeaders &&newHeaders)
(since 6.8) void setHeaders(const QHttpHeaders &newHeaders)
(since 6.5) void setHttp1Configuration(const QHttp1Configuration &configuration)
void setHttp2Configuration(const QHttp2Configuration &configuration)
void setMaximumRedirectsAllowed(int maxRedirectsAllowed)
void setOriginatingObject(QObject *object)
void setPeerVerifyName(const QString &peerName)
void setPriority(QNetworkRequest::Priority priority)
void setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)
void setSslConfiguration(const QSslConfiguration &config)
(since 6.11) void setTcpKeepAliveIdleTimeBeforeProbes(std::chrono::seconds idle)
(since 6.11) void setTcpKeepAliveIntervalBetweenProbes(std::chrono::seconds interval)
(since 6.11) void setTcpKeepAliveProbeCount(int probes)
void setTransferTimeout(int timeout)
(since 6.7) void setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout)
void setUrl(const QUrl &url)
QSslConfiguration sslConfiguration() const
void swap(QNetworkRequest &other)
(since 6.11) std::chrono::seconds tcpKeepAliveIdleTimeBeforeProbes() const
(since 6.11) std::chrono::seconds tcpKeepAliveIntervalBetweenProbes() const
(since 6.11) int tcpKeepAliveProbeCount() const
int transferTimeout() const
(since 6.7) std::chrono::milliseconds transferTimeoutAsDuration() const
QUrl url() const
bool operator!=(const QNetworkRequest &other) const
QNetworkRequest &operator=(const QNetworkRequest &other)
bool operator==(const QNetworkRequest &other) const

Miembros públicos estáticos

const std::chrono::std::chrono::milliseconds DefaultTransferTimeout

Descripción detallada

QNetworkRequest forma parte de la API de acceso a la red y es la clase que contiene la información necesaria para enviar una solicitud a través de la red. Contiene una URL y cierta información complementaria que puede utilizarse para modificar la solicitud.

Véase también QNetworkReply y QNetworkAccessManager.

Documentación sobre los tipos de miembros

enum QNetworkRequest::Attribute

Códigos de atributos para QNetworkRequest y QNetworkReply.

Los atributos son metadatos adicionales que se utilizan para controlar el comportamiento de la solicitud y para devolver información adicional de la respuesta a la aplicación. Los atributos también son extensibles, lo que permite que las implementaciones personalizadas pasen valores personalizados.

La siguiente tabla explica cuáles son los códigos de atributos por defecto, los tipos de QVariant asociados, el valor por defecto si falta dicho atributo y si se utiliza en solicitudes o en respuestas.

ConstanteValorDescripción
QNetworkRequest::HttpStatusCodeAttribute0Solo en respuestas, tipo: QMetaType::Int (sin valor predeterminado) Indica el código de estado HTTP recibido del servidor HTTP (como 200, 304, 404, 401, etc.). Si la conexión no se basaba en HTTP, este atributo no estará presente.
QNetworkRequest::HttpReasonPhraseAttribute1Solo en respuestas, tipo: QMetaType::QByteArray (sin valor por defecto) Indica la frase de motivo HTTP tal y como se recibió del servidor HTTP (como «Ok», «Found», «Not Found», «Access Denied», etc.). Se trata de la representación legible para el usuario del código de estado (véase más arriba). Si la conexión no se basaba en HTTP, este atributo no estará presente. Nota: La frase de motivo no se utiliza cuando se emplea HTTP/2.
QNetworkRequest::RedirectionTargetAttribute2Solo en respuestas, tipo: QMetaType::QUrl (sin valor por defecto). Si está presente, indica que el servidor está redirigiendo la solicitud a una URL diferente. La API de acceso a la red sigue las redirecciones de forma predeterminada, a menos que se utilice QNetworkRequest::ManualRedirectPolicy. Además, si se utiliza QNetworkRequest::UserVerifiedRedirectPolicy, este atributo se establecerá si no se ha seguido la redirección. La URL devuelta puede ser relativa. Utiliza QUrl::resolved() para crear una URL absoluta a partir de ella.
QNetworkRequest::ConnectionEncryptedAttribute3Solo para respuestas, tipo: QMetaType::Bool (por defecto: false) Indica si los datos se obtuvieron a través de una conexión cifrada (segura).
QNetworkRequest::CacheLoadControlAttribute4Solo para solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::PreferNetwork). Controla cómo se debe acceder a la caché. Los valores posibles son los de QNetworkRequest::CacheLoadControl. Ten en cuenta que la implementación predeterminada de QNetworkAccessManager no admite el almacenamiento en caché. Sin embargo, este atributo puede ser utilizado por ciertos backends para modificar sus solicitudes (por ejemplo, para proxies de caché).
QNetworkRequest::CacheSaveControlAttribute5Solo solicitudes, tipo: QMetaType::Bool (por defecto: true) Controla si los datos obtenidos deben guardarse en la caché para usos futuros. Si el valor es false, los datos obtenidos no se almacenarán automáticamente en la caché. Si es true, los datos pueden almacenarse en la caché, siempre que sean almacenables (lo que es almacenable depende del protocolo que se utilice).
QNetworkRequest::SourceIsFromCacheAttribute6Solo respuestas, tipo: QMetaType::Bool (por defecto: false) Indica si los datos se han obtenido de la caché o no.
QNetworkRequest::DoNotBufferUploadDataAttribute7Solo solicitudes, tipo: QMetaType::Bool (por defecto: false) Indica si se permite que el código QNetworkAccessManager almacene en búfer los datos de carga, p. ej., al realizar un HTTP POST. Al utilizar este indicador con datos de carga secuenciales, debe establecerse el encabezado ContentLengthHeader.
QNetworkRequest::HttpPipeliningAllowedAttribute8Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Indica si se permite que el código QNetworkAccessManager utilice el pipelining HTTP con esta solicitud.
QNetworkRequest::HttpPipeliningWasUsedAttribute9Solo respuestas, tipo: QMetaType::Bool Indica si se utilizó el pipelining HTTP para recibir esta respuesta.
QNetworkRequest::CustomVerbAttribute10Solo para solicitudes, tipo: QMetaType::QByteArray Contiene el valor del verbo HTTP personalizado que se va a enviar (destinado al uso de verbos distintos de GET, POST, PUT y DELETE). Este verbo se establece al llamar a QNetworkAccessManager::sendCustomRequest().
QNetworkRequest::CookieLoadControlAttribute11Solo en solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::Automatic) Indica si se deben enviar encabezados «Cookie» en la solicitud. Qt WebKit establece este atributo en «false» al crear una solicitud XMLHttpRequest de origen cruzado cuando el código JavaScript que ha creado la solicitud no ha establecido explícitamente «withCredentials» en «true». Consulta aquí para obtener más información. (Este valor se introdujo en la versión 4.7.)
QNetworkRequest::CookieSaveControlAttribute13Solo para solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::Automatic) Indica si se deben guardar los encabezados «Cookie» recibidos del servidor en respuesta a la solicitud. Qt WebKit establece este atributo en «false» al crear una solicitud XMLHttpRequest de origen cruzado en la que el código JavaScript que ha creado la solicitud no haya establecido explícitamente «withCredentials» en «true». Consulta aquí para obtener más información. (Este valor se introdujo en la versión 4.7.)
QNetworkRequest::AuthenticationReuseAttribute12Solo para solicitudes, tipo: QMetaType::Int (por defecto: QNetworkRequest::Automatic). Indica si se deben utilizar las credenciales de autorización almacenadas en caché en la solicitud, si están disponibles. Si se establece en QNetworkRequest::Manual y el mecanismo de autenticación es «Basic» o «Digest», Qt no enviará un encabezado HTTP «Authorization» con las credenciales almacenadas en caché que pueda tener para la URL de la solicitud. Qt WebKit establece este atributo en QNetworkRequest::Manual al crear una solicitud XMLHttpRequest de origen cruzado cuando el código JavaScript que ha creado la solicitud no ha establecido explícitamente withCredentials en true. Consulta aquí para obtener más información. (Este valor se introdujo en la versión 4.7.)
QNetworkRequest::BackgroundRequestAttribute17Tipo: QMetaType::Bool (por defecto: false) Indica que se trata de una transferencia en segundo plano, en lugar de una transferencia iniciada por el usuario. Dependiendo de la plataforma, las transferencias en segundo plano pueden estar sujetas a políticas diferentes.
QNetworkRequest::Http2AllowedAttribute19Solo solicitudes, tipo: QMetaType::Bool (por defecto: true) Indica si se permite que el código QNetworkAccessManager utilice HTTP/2 con esta solicitud. Esto se aplica a las solicitudes SSL o a HTTP/2 en «texto sin cifrar» si se ha establecido Http2CleartextAllowedAttribute.
QNetworkRequest::Http2WasUsedAttribute20Solo respuestas, tipo: QMetaType::Bool (por defecto: false) Indica si se utilizó HTTP/2 para recibir esta respuesta. (Este valor se introdujo en la versión 5.9.)
QNetworkRequest::EmitAllUploadProgressSignalsAttribute18Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Indica si deben emitirse todas las señales de carga. Por defecto, la señal uploadProgress solo se emite en intervalos de 100 milisegundos. (Este valor se introdujo en la versión 5.5.)
QNetworkRequest::OriginalContentLengthAttribute21Solo respuestas, tipo: QMetaType::Int Conserva el atributo «content-length» original antes de que quede invalidado y se elimine del encabezado cuando los datos se comprimen y la solicitud se ha marcado para que se descomprima automáticamente. (Este valor se introdujo en la versión 5.9.)
QNetworkRequest::RedirectPolicyAttribute22Solo para solicitudes, tipo: QMetaType::Int; debe ser uno de los valores de QNetworkRequest::RedirectPolicy (por defecto: NoLessSafeRedirectPolicy). (Este valor se introdujo en la versión 5.9.)
QNetworkRequest::Http2DirectAttribute23Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false). Si se establece, este atributo obligará a QNetworkAccessManager a utilizar el protocolo HTTP/2 sin negociación inicial del protocolo HTTP/2. El uso de este atributo implica el conocimiento previo de que un servidor concreto es compatible con HTTP/2. El atributo funciona con SSL o con HTTP/2 en «texto sin cifrar» si se establece Http2CleartextAllowedAttribute. Si resulta que un servidor no es compatible con HTTP/2, cuando se ha especificado HTTP/2 directo, QNetworkAccessManager abandona la conexión sin intentar recurrir a HTTP/1.1. Si se establecen tanto Http2AllowedAttribute como Http2DirectAttribute, Http2DirectAttribute tiene prioridad. (Este valor se introdujo en la versión 5.11.)
QNetworkRequest::AutoDeleteReplyOnFinishAttribute25Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Si se activa, este atributo hará que QNetworkAccessManager elimine el QNetworkReply tras haber emitido «finished». (Este valor se introdujo en la versión 5.14.)
QNetworkRequest::ConnectionCacheExpiryTimeoutSecondsAttribute26Solo para solicitudes, tipo: QMetaType::Int Controla cuándo deben cerrarse las conexiones TCP con un servidor (HTTP1 y HTTP2) una vez procesada la última solicitud pendiente. Si no se configura, se utiliza el tiempo de espera predeterminado de 120 segundos. Si se establece en un valor negativo (por ejemplo, -1), se desactiva el almacenamiento en caché de la conexión para esta solicitud: la conexión no se almacenará ni se recuperará de la caché, y se cerrará inmediatamente después de que finalice la solicitud. Establecerlo en 0 significa que la conexión se comparte mientras está en uso, pero se libera tan pronto como no haya nada en la cola. Un valor positivo especifica un tiempo de caducación personalizado en segundos. (Este valor se introdujo en la versión 6.3.)
QNetworkRequest::Http2CleartextAllowedAttribute27Solo para solicitudes, tipo: QMetaType::Bool (por defecto: false) Si se establece, este atributo indicará a QNetworkAccessManager que intente una actualización a HTTP/2 sobre texto sin cifrar (también conocido como h2c). Hasta Qt 7, el valor por defecto de este atributo se puede anular y establecer en «true» configurando la variable de entorno QT_NETWORK_H2C_ALLOWED. Este atributo se ignora si no se ha establecido Http2AllowedAttribute. (Este valor se introdujo en la versión 6.3.)
QNetworkRequest::UseCredentialsAttribute28Solo para peticiones, tipo: QMetaType::Bool (por defecto: false) Indica si las peticiones de control de acceso entre sitios de XMLHttpRequest subyacentes deben realizarse utilizando credenciales. No tiene ningún efecto en las peticiones del mismo origen. Esto solo afecta a la plataforma WebAssembly. (Este valor se introdujo en la versión 6.5.)
QNetworkRequest::FullLocalServerNameAttribute29Solo para solicitudes, tipo: QMetaType::String Contiene el nombre completo del servidor local que se utilizará para el QLocalSocket subyacente. Este atributo lo utiliza el QNetworkAccessManager para conectarse a un servidor local específico, cuando el comportamiento de QLocalSocket para un nombre simple no es suficiente. La URL en QNetworkRequest debe seguir utilizando el esquema unix+http: o local+http:. Además, el nombre de host de la URL se utilizará para el encabezado Host en la solicitud HTTP. (Este valor se introdujo en la versión 6.8.)
QNetworkRequest::User1000Tipo especial. Se puede pasar información adicional en QVariants con tipos que van desde «User» hasta «UserMax». La implementación predeterminada de «Network Access» ignorará cualquier atributo de solicitud dentro de este rango y no generará ningún atributo de este rango en las respuestas. El rango está reservado para extensiones de QNetworkAccessManager.
QNetworkRequest::UserMax32767Tipo especial. Véase «User».

enum QNetworkRequest::CacheLoadControl

Controla el mecanismo de almacenamiento en caché de QNetworkAccessManager.

ConstanteValorDescripción
QNetworkRequest::AlwaysNetwork0cargar siempre desde la red y no comprobar si la caché tiene una entrada válida (similar a la función «Actualizar» de los navegadores); además, obliga a las cachés intermedias a volver a validar.
QNetworkRequest::PreferNetwork1valor por defecto; se carga desde la red si la entrada almacenada en caché es más antigua que la entrada de la red. Esto nunca devolverá datos obsoletos de la caché, pero revalidará los recursos que se hayan vuelto obsoletos.
QNetworkRequest::PreferCache2Cargar desde la caché si está disponible; de lo contrario, cargar desde la red. Ten en cuenta que esto puede devolver elementos posiblemente obsoletos (pero no caducados) de la caché.
QNetworkRequest::AlwaysCache3Solo cargar desde la caché, indicando un error si el elemento no estaba almacenado en la caché (es decir, modo sin conexión).

enum QNetworkRequest::KnownHeaders

Lista de tipos de encabezado conocidos que analiza QNetworkRequest. Cada encabezado conocido también se muestra en formato sin procesar con su nombre HTTP completo.

ConstanteValorDescripción
QNetworkRequest::ContentDispositionHeader6Corresponde al encabezado HTTP «Content-Disposition» y contiene una cadena con el tipo de disposición (por ejemplo, «attachment») y un parámetro (por ejemplo, «filename»).
QNetworkRequest::ContentTypeHeader0Corresponde al encabezado HTTP «Content-Type» y contiene una cadena con el tipo de medio (MIME) y cualquier dato auxiliar (por ejemplo, el juego de caracteres).
QNetworkRequest::ContentLengthHeader1Corresponde al encabezado HTTP «Content-Length» y contiene la longitud en bytes de los datos transmitidos.
QNetworkRequest::LocationHeader2Corresponde al encabezado HTTP «Location» y contiene una URL que representa la ubicación real de los datos, incluida la URL de destino en caso de redireccionamientos.
QNetworkRequest::LastModifiedHeader3Corresponde al encabezado HTTP «Last-Modified» y contiene un « QDateTime » que representa la fecha de la última modificación del contenido.
QNetworkRequest::IfModifiedSinceHeader9Corresponde al encabezado HTTP «If-Modified-Since» y contiene un « QDateTime ». Suele añadirse a un « QNetworkRequest ». El servidor enviará una respuesta 304 (Not Modified) si el recurso no ha cambiado desde ese momento.
QNetworkRequest::ETagHeader10Corresponde al encabezado HTTP «ETag» y contiene un « QString » que representa el estado de la última modificación del contenido.
QNetworkRequest::IfMatchHeader11Corresponde al encabezado HTTP If-Match y contiene un QStringList. Suele añadirse a un QNetworkRequest. El servidor enviará una respuesta 412 (Precondition Failed) si el recurso no coincide.
QNetworkRequest::IfNoneMatchHeader12Corresponde al encabezado HTTP «If-None-Match» y contiene un QStringList. Suele añadirse a un QNetworkRequest. El servidor enviará una respuesta 304 (Not Modified) si el recurso coincide.
QNetworkRequest::CookieHeader4Corresponde al encabezado HTTP «Cookie» y contiene un QList<QNetworkCookie> que representa las cookies que se deben enviar de vuelta al servidor.
QNetworkRequest::SetCookieHeader5Corresponde al encabezado HTTP «Set-Cookie» y contiene un QList<QNetworkCookie> que representa las cookies enviadas por el servidor para su almacenamiento local.
QNetworkRequest::UserAgentHeader7El encabezado User-Agent enviado por los clientes HTTP.
QNetworkRequest::ServerHeader8El encabezado «Server» recibido por los clientes HTTP.

Véase también header(), setHeader(), rawHeader() y setRawHeader().

enum QNetworkRequest::LoadControl

Indica si se ha anulado manualmente algún aspecto del mecanismo de carga de la solicitud, por ejemplo, mediante Qt WebKit.

ConstanteValorDescripción
QNetworkRequest::Automatic0valor por defecto: indica el comportamiento predeterminado.
QNetworkRequest::Manual1indica que el comportamiento se ha anulado manualmente.

enum QNetworkRequest::Priority

Esta enumeración enumera las posibles prioridades de las solicitudes de red.

ConstanteValorDescripción
QNetworkRequest::HighPriority1Prioridad alta
QNetworkRequest::NormalPriority3Prioridad normal
QNetworkRequest::LowPriority5Prioridad baja

enum QNetworkRequest::RedirectPolicy

Indica si la API de acceso a la red debe seguir automáticamente una respuesta de redireccionamiento HTTP o no.

ConstanteValorDescripción
QNetworkRequest::ManualRedirectPolicy0No seguir ninguna redirección.
QNetworkRequest::NoLessSafeRedirectPolicy1Valor por defecto: solo se permiten redireccionamientos de «http» a «http», de «http» a «https» o de «https» a «https».
QNetworkRequest::SameOriginRedirectPolicy2Se requiere que el protocolo, el host y el puerto sean los mismos. Ten en cuenta que http://example.com y http://example.com:80 fallarán con esta política (los puertos implícitos/explícitos se consideran una discrepancia).
QNetworkRequest::UserVerifiedRedirectPolicy3El cliente decide si seguir cada redirección gestionando la señal `redirected()`, emitiendo `redirectAllowed()` en el objeto ` QNetworkReply ` para permitir la redirección o abortándola/finalizándola para rechazarla. Esto se puede utilizar, por ejemplo, para preguntar al usuario si acepta la redirección o para decidir en función de alguna configuración específica de la aplicación.

Nota: Cuando Qt gestiona redirecciones, por motivos de compatibilidad y con vistas al futuro, enviará la solicitud redirigida utilizando el método GET cuando el servidor devuelva una respuesta 301 o 302, independientemente del método original utilizado, a menos que fuera HEAD.

enum QNetworkRequest::TransferTimeoutConstant

Una constante que se puede utilizar para activar los tiempos de espera de transferencia con un valor preestablecido.

ConstanteValorDescripción
QNetworkRequest::DefaultTransferTimeoutConstant30000El tiempo de espera de la transferencia en milisegundos. Se utiliza si se llama a setTransferTimeout() sin ningún argumento.

Véase también QNetworkRequest::DefaultTransferTimeout.

Documentación de funciones de miembro

QNetworkRequest::QNetworkRequest()

Crea un objeto `QNetworkRequest` sin ninguna URL que solicitar. Utiliza ` setUrl()` para establecer una.

Véase también url() y setUrl().

[explicit] QNetworkRequest::QNetworkRequest(const QUrl &url)

Crea un objeto QNetworkRequest con url como URL a solicitar.

Véase también url() y setUrl().

QNetworkRequest::QNetworkRequest(const QNetworkRequest &other)

Crea una copia de other.

[noexcept] QNetworkRequest::~QNetworkRequest()

Elimina el objeto ` QNetworkRequest `.

QVariant QNetworkRequest::attribute(QNetworkRequest::Attribute code, const QVariant &defaultValue = QVariant()) const

Devuelve el atributo asociado al código code. Si el atributo no se ha establecido, devuelve defaultValue.

Nota: Esta función no aplica los valores por defecto que figuran en QNetworkRequest::Attribute.

Véase también setAttribute() y QNetworkRequest::Attribute.

[since 6.2] qint64 QNetworkRequest::decompressedSafetyCheckThreshold() const

Devuelve el umbral para las comprobaciones de «archive bomb».

Si el tamaño descomprimido de una respuesta es inferior a este valor, Qt simplemente la descomprimirá, sin realizar comprobaciones adicionales.

Esta función se introdujo en Qt 6.2.

Véase también setDecompressedSafetyCheckThreshold().

bool QNetworkRequest::hasRawHeader(QAnyStringView headerName) const

Devuelve ` true ` si el encabezado sin procesar ` headerName ` está presente en esta solicitud de red.

Nota: En las versiones de Qt anteriores a la 6.7, esta función solo aceptaba QByteArray.

Véase también rawHeader() y setRawHeader().

Devuelve el valor del encabezado de red conocido « header » si está presente en esta solicitud. Si no está presente, devuelve QVariant() (es decir, una variante no válida).

Véase también KnownHeaders, rawHeader() y setHeader().

[since 6.8] QHttpHeaders QNetworkRequest::headers() const

Devuelve los encabezados que se han establecido en esta solicitud de red.

Esta función se introdujo en Qt 6.8.

Véase también ` setHeaders()`.

[since 6.5] QHttp1Configuration QNetworkRequest::http1Configuration() const

Devuelve los parámetros actuales que utiliza QNetworkAccessManager para la conexión HTTP/1 subyacente de esta solicitud.

Esta función se introdujo en Qt 6.5.

Véase también setHttp1Configuration.

QHttp2Configuration QNetworkRequest::http2Configuration() const

Devuelve los parámetros actuales que QNetworkAccessManager está utilizando para esta solicitud y su conexión HTTP/2 subyacente. Se trata bien de una configuración establecida previamente por una aplicación, bien de una configuración predeterminada.

Los valores predeterminados que utiliza QNetworkAccessManager son:

  • El tamaño de ventana para el control de flujo a nivel de conexión es de 2147483647 octetos
  • El tamaño de ventana para el control de flujo a nivel de flujo es de 214748364 octetos
  • El tamaño máximo de trama es de 16 384

Por defecto, el «server push» está desactivado, mientras que la compresión Huffman y la indexación de cadenas están activadas.

Véase también setHttp2Configuration.

int QNetworkRequest::maximumRedirectsAllowed() const

Devuelve el número máximo de redirecciones que se pueden seguir para esta solicitud.

Véase también setMaximumRedirectsAllowed().

QObject *QNetworkRequest::originatingObject() const

Devuelve una referencia al objeto que inició esta solicitud de red; devuelve « nullptr » si no se ha establecido o si el objeto se ha destruido.

Véase también setOriginatingObject().

QString QNetworkRequest::peerVerifyName() const

Devuelve el nombre de host establecido para la validación del certificado, tal y como se ha configurado en setPeerVerifyName. Por defecto, devuelve una cadena nula.

Véase también setPeerVerifyName.

QNetworkRequest::Priority QNetworkRequest::priority() const

Devuelve la prioridad de esta solicitud.

Véase también setPriority().

QByteArray QNetworkRequest::rawHeader(QAnyStringView headerName) const

Devuelve la forma sin procesar del encabezado headerName. Si no existe dicho encabezado, se devuelve un QByteArray vacío, lo que puede resultar indistinguible de un encabezado que sí existe pero que no tiene contenido (utiliza hasRawHeader() para comprobar si el encabezado existe o no).

Los encabezados sin procesar se pueden establecer con setRawHeader() o con setHeader().

Nota: En las versiones de Qt anteriores a la 6.7, esta función solo aceptaba ` QByteArray `.

Véase también header() y setRawHeader().

QList<QByteArray> QNetworkRequest::rawHeaderList() const

Devuelve una lista de todos los encabezados sin procesar que se han establecido en esta solicitud de red. La lista aparece en el orden en que se establecieron los encabezados.

Véase también hasRawHeader() y rawHeader().

void QNetworkRequest::setAttribute(QNetworkRequest::Attribute code, const QVariant &value)

Establece el atributo asociado al código code con el valor value. Si el atributo ya está establecido, se descarta el valor anterior. En particular, si value es un QVariant no válido, se desactiva el atributo.

Véase también attribute() y QNetworkRequest::Attribute.

[since 6.2] void QNetworkRequest::setDecompressedSafetyCheckThreshold(qint64 threshold)

Establece el valor de « threshold » para las comprobaciones de archivos de gran tamaño.

Algunos algoritmos de compresión compatibles pueden, en un archivo comprimido minúsculo, codificar un archivo descomprimido de un tamaño espectacularmente grande. Esto solo es posible si el contenido descomprimido es extremadamente monótono, lo cual rara vez ocurre con archivos reales que se transmiten de buena fe: los archivos que presentan ratios de compresión tan desmesuradamente altos suelen ser cargas útiles de ataques de desbordamiento de búfer o de denegación de servicio (al consumir demasiada memoria). Por consiguiente, es mejor rechazar como malware sospechoso los archivos que, al descomprimirse, alcanzan tamaños enormes, especialmente si proceden de formatos comprimidos minúsculos.

Si el tamaño descomprimido de una respuesta supera este umbral (por defecto, 10 MiB, es decir, 10 * 1024 * 1024), Qt comprobará la relación de compresión: si es desproporcionadamente alta (40:1 para GZip y Deflate, o 100:1 para Brotli y ZStandard), la respuesta se tratará como un error. Establecer el umbral en -1 desactiva esta comprobación.

Nota: Esta comprobación solo detecta respuestas con relaciones de compresión inusualmente altas. No impone un límite absoluto al tamaño total de la salida descomprimida. Una respuesta que mantenga una relación de compresión moderada (por ejemplo, 39:1 para GZip) puede descomprimirse hasta alcanzar un tamaño arbitrariamente grande sin activar la comprobación. Las aplicaciones que se comuniquen con servidores no fiables deben supervisar QNetworkReply::bytesAvailable() o QNetworkReply::downloadProgress() e interrumpir las transferencias que superen un tamaño aceptable.

Esta función se introdujo en Qt 6.2.

Véase también decompressedSafetyCheckThreshold().

void QNetworkRequest::setHeader(QNetworkRequest::KnownHeaders header, const QVariant &value)

Establece el valor del encabezado conocido « header » en « value », anulando cualquier encabezado establecido anteriormente. Esta operación también establece el encabezado HTTP sin procesar equivalente.

Véase también KnownHeaders, setRawHeader() y header().

[since 6.8] void QNetworkRequest::setHeaders(QHttpHeaders &&newHeaders)

Establece « newHeaders » como encabezados en esta solicitud de red, sustituyendo cualquier encabezado establecido anteriormente.

Si algunos encabezados coinciden con los encabezados conocidos, se analizarán los valores y también se establecerá el formulario analizado correspondiente.

Esta función se introdujo en Qt 6.8.

Véase también headers() y KnownHeaders.

[since 6.8] void QNetworkRequest::setHeaders(const QHttpHeaders &newHeaders)

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.8.

[since 6.5] void QNetworkRequest::setHttp1Configuration(const QHttp1Configuration &configuration)

Establece los parámetros HTTP/1 de la solicitud a partir de configuration.

Esta función se introdujo en Qt 6.5.

Véase también http1Configuration, QNetworkAccessManager y QHttp1Configuration.

void QNetworkRequest::setHttp2Configuration(const QHttp2Configuration &configuration)

Establece los parámetros HTTP/2 de la solicitud a partir de configuration.

Nota: La configuración debe establecerse antes de realizar una solicitud.

Nota: HTTP/2 multiplexa varios flujos en una única conexión HTTP/2. Esto implica que QNetworkAccessManager utilizará la configuración que se encuentre en la primera solicitud de una serie de solicitudes enviadas al mismo servidor.

Véase también http2Configuration, QNetworkAccessManager y QHttp2Configuration.

void QNetworkRequest::setMaximumRedirectsAllowed(int maxRedirectsAllowed)

Establece el número máximo de redireccionamientos que se pueden seguir para esta solicitud a maxRedirectsAllowed.

Véase también maximumRedirectsAllowed().

void QNetworkRequest::setOriginatingObject(QObject *object)

Permite establecer una referencia al objeto « object » que inicia la solicitud.

Por ejemplo, Qt WebKit establece el objeto de origen como el QWebFrame que inició la solicitud.

Véase también originatingObject().

void QNetworkRequest::setPeerVerifyName(const QString &peerName)

Establece peerName como nombre de host para la validación del certificado, en lugar del que se utiliza para la conexión TCP.

Véase también peerVerifyName.

void QNetworkRequest::setPriority(QNetworkRequest::Priority priority)

Establece la prioridad de esta solicitud en « priority ».

Nota: La prioridad « priority » es solo una sugerencia para el gestor de acceso a la red. Este puede utilizarla o no. Actualmente se utiliza para HTTP a la hora de decidir qué solicitud debe enviarse primero a un servidor.

Véase también priority().

void QNetworkRequest::setRawHeader(const QByteArray &headerName, const QByteArray &headerValue)

Establece el valor de la cabecera « headerName » en « headerValue ». Si « headerName » corresponde a una cabecera conocida (véase QNetworkRequest::KnownHeaders), se analizará el formato sin procesar y se establecerá también la cabecera «procesada» correspondiente.

Por ejemplo:

request.setRawHeader(QByteArray("Last-Modified"), QByteArray("Sun, 06 Nov 1994 08:49:37 GMT"));

también establecerá el encabezado conocido LastModifiedHeader como el objeto QDateTime de la fecha analizada.

Nota: Establecer el mismo encabezado dos veces anula la configuración anterior. Para conseguir el comportamiento de varios encabezados HTTP con el mismo nombre, debes concatenar los dos valores, separándolos con una coma («,») y establecer un único encabezado sin procesar.

Nota: Desde Qt 6.8, los nombres de los campos de los encabezados se normalizan convirtiéndolos a minúsculas.

Véase también KnownHeaders, setHeader(), hasRawHeader() y rawHeader().

void QNetworkRequest::setSslConfiguration(const QSslConfiguration &config)

Establece la configuración SSL de esta solicitud de red como config. Los parámetros que se aplican son la clave privada, el certificado local, el protocolo TLS (por ejemplo, TLS 1.3), los certificados de la autoridad de certificación (CA) y los algoritmos de cifrado que el backend SSL tiene permiso para utilizar.

Véase también sslConfiguration() y QSslConfiguration::defaultConfiguration().

[since 6.11] void QNetworkRequest::setTcpKeepAliveIdleTimeBeforeProbes(std::chrono::seconds idle)

Establece el tiempo que la conexión debe permanecer inactiva antes de que TCP comience a enviar sondas de mantenimiento de conexión (keepalive) para que se considere « idle », siempre que se haya activado la funcionalidad de mantenimiento de conexión de TCP.

Esta función se introdujo en Qt 6.11.

Véase también tcpKeepAliveIdleTimeBeforeProbes().

[since 6.11] void QNetworkRequest::setTcpKeepAliveIntervalBetweenProbes(std::chrono::seconds interval)

Establece el intervalo de tiempo entre cada sondeo de keepalive en interval, si se ha activado la funcionalidad TCP Keepalive.

Esta función se introdujo en Qt 6.11.

Véase también tcpKeepAliveIntervalBetweenProbes().

[since 6.11] void QNetworkRequest::setTcpKeepAliveProbeCount(int probes)

Establece el número máximo de mensajes « probes » de mantenimiento de conexión que el TCP debe enviar antes de interrumpir la conexión, siempre que se haya activado la funcionalidad «TCP Keepalive».

Esta función se introdujo en Qt 6.11.

Véase también tcpKeepAliveProbeCount().

void QNetworkRequest::setTransferTimeout(int timeout)

Establece timeout como tiempo de espera de la transferencia en milisegundos.

Véase también setTransferTimeout(std::chrono::milliseconds), transferTimeout() y transferTimeoutAsDuration().

[since 6.7] void QNetworkRequest::setTransferTimeout(std::chrono::milliseconds duration = DefaultTransferTimeout)

Establece el tiempo de espera duration para interrumpir la transferencia si no se intercambian datos.

Las transferencias se interrumpen si no se transfieren bytes antes de que expire el tiempo de espera. El valor cero significa que no se ha establecido ningún temporizador. Si no se proporciona ningún argumento, el tiempo de espera es QNetworkRequest::DefaultTransferTimeout. Si no se llama a esta función, el tiempo de espera queda desactivado y tiene el valor cero.

Esta función se introdujo en Qt 6.7.

Véase también transferTimeoutAsDuration().

void QNetworkRequest::setUrl(const QUrl &url)

Establece la URL a la que hace referencia esta solicitud de red como url.

Véase también url().

QSslConfiguration QNetworkRequest::sslConfiguration() const

Devuelve la configuración SSL de esta solicitud de red. Por defecto, es la misma que la de QSslConfiguration::defaultConfiguration().

Véase también setSslConfiguration() y QSslConfiguration::defaultConfiguration().

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

Intercambia esta solicitud de red con other. Esta operación es muy rápida y nunca falla.

[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIdleTimeBeforeProbes() const

Devuelve el tiempo que la conexión debe permanecer inactiva antes de que TCP comience a enviar sondeos de mantenimiento de conexión, si se ha activado la funcionalidad de mantenimiento de conexión de TCP.

Esta función se introdujo en Qt 6.11.

Véase también ` setTcpKeepAliveIdleTimeBeforeProbes()`.

[since 6.11] std::chrono::seconds QNetworkRequest::tcpKeepAliveIntervalBetweenProbes() const

Devuelve el tiempo transcurrido entre cada sondeo de keepalive, si se ha activado la funcionalidad TCP Keepalive.

Esta función se introdujo en Qt 6.11.

Véase también setTcpKeepAliveIntervalBetweenProbes().

[since 6.11] int QNetworkRequest::tcpKeepAliveProbeCount() const

Devuelve el número máximo de sondeos de mantenimiento (keepalive) que el protocolo TCP debe enviar antes de interrumpir la conexión, si se ha activado la funcionalidad TCP Keepalive.

Esta función se introdujo en Qt 6.11.

Véase también ` setTcpKeepAliveProbeCount()`.

int QNetworkRequest::transferTimeout() const

Devuelve el tiempo de espera utilizado para las transferencias, en milisegundos.

Si transferTimeoutAsDuration().count() no se puede representar en int, esta función devuelve INT_MAX/INT_MIN en su lugar.

Véase también setTransferTimeout() y transferTimeoutAsDuration().

[since 6.7] std::chrono::milliseconds QNetworkRequest::transferTimeoutAsDuration() const

Devuelve la duración del tiempo de espera tras la cual se interrumpe la transferencia si no se intercambian datos.

La duración por defecto es cero, lo que significa que no se aplica ningún tiempo de espera.

Esta función se introdujo en Qt 6.7.

Véase también setTransferTimeout(std::chrono::milliseconds).

QUrl QNetworkRequest::url() const

Devuelve la URL a la que hace referencia esta solicitud de red.

Véase también setUrl().

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

Devuelve ` false ` si este objeto no es el mismo que ` other`.

Véase también operator==().

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

Crea una copia de other

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

Devuelve « true » si este objeto es el mismo que « other » (es decir, si tienen la misma URL, los mismos encabezados y la misma configuración de metadatos).

Véase también operator!=().

Documentación de las variables de miembro

const std::chrono::std::chrono::milliseconds QNetworkRequest::DefaultTransferTimeout

El tiempo de espera de la transferencia es de QNetworkRequest::TransferTimeoutConstant milisegundos. Se utiliza si se llama a setTransferTimeout() sin ningún argumento.

© 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.