El objeto XMLHttpRequest de JavaScript
El objeto ` XMLHttpRequest ` permite a los scripts realizar funciones de cliente HTTP, como enviar datos de formularios o cargar datos de forma asíncrona desde un servidor.
La API de XMLHttpRequest es una implementación parcial del estándar XHR Nivel 1 del W3C, con la siguiente excepción:
- No aplica la política de mismo origen.
Envío de solicitudes
Sigue estos pasos para enviar una solicitud mediante la API de XMLHttpRequest:
- Crea un objeto `
XMLHttpRequest`. - Asigna una función de devolución de llamada al controlador de señales onreadystatechange.
- Llama a open() con el método HTTP y la URL adecuados para la solicitud.
- Llama a ` send()`
La función de devolución de llamada gestiona la respuesta HTTP de una solicitud. Es recomendable comprobar si el estado readyState es « DONE » en el controlador, antes de utilizar uno de los siguientes métodos para leer la respuesta:
El siguiente ejemplo muestra cómo enviar una solicitud y leer la respuesta:
import QtQuick
import QtQuick.Layouts
import QtQuick.Controls
import "request.js" as XHR
ApplicationWindow {
width: 640
height: 640
visible: true
ColumnLayout {
anchors.fill: parent
RowLayout {
Layout.fillWidth: true
TextField {
id: urlTextField
text: "https://www.example.com/index.html"
Layout.fillWidth: true
}
Button {
text: qsTr("Send!")
onClicked: XHR.sendRequest(urlTextField.text, function(response) {
statusTextField.text = response.status;
let isPlainText = response.contentType.length === 0
contentTypeTextField.text = isPlainText ? "text" : response.contentType;
if (isPlainText)
contentTextArea.text = response.content;
});
}
}
GridLayout {
columns: 2
Layout.fillWidth: true
Label {
text: qsTr("Status code")
Layout.fillWidth: true
}
Label {
text: qsTr("Response type")
Layout.fillWidth: true
}
TextField {
id: statusTextField
Layout.fillWidth: true
}
TextField {
id: contentTypeTextField
Layout.fillWidth: true
}
}
Flickable {
clip: true
contentWidth: contentTextArea.width
contentHeight: contentTextArea.height
Text {
id: contentTextArea
}
Layout.fillWidth: true
Layout.fillHeight: true
ScrollBar.vertical: ScrollBar {}
ScrollBar.horizontal: ScrollBar {}
}
}
}El fragmento de código anterior conecta la señal «clicked» del botón a una función externa « sendRequest ». Se pasa una URL de recurso como primer argumento y una función de devolución de llamada para gestionar las actualizaciones de la interfaz de usuario como segundo argumento. La función « sendRequest », que se encuentra en un archivo externo « request.js », se puede implementar así:
function sendRequest(url, callback)
{
let request = new XMLHttpRequest();
request.onreadystatechange = function() {
if (request.readyState === XMLHttpRequest.DONE) {
let response = {
status : request.status,
headers : request.getAllResponseHeaders(),
contentType : request.responseType,
content : request.response
};
callback(response);
}
}
request.open("GET", url);
request.send();
}El fragmento de código anterior sigue los cuatro sencillos pasos mencionados al principio. Primero crea una instancia del objeto XMLHttpRequest y le asigna una función de devolución de llamada para gestionar la respuesta. También llama a open() con un método HTTP y una URL, antes de enviar la solicitud al servidor. Ten en cuenta que el segundo argumento de ` sendRequest ` se invoca al final de `onreadystatechange`, con el fin de gestionar las actualizaciones de la interfaz de usuario en función de la respuesta HTTP.
Establece la variable de entorno ` QML_XHR_DUMP ` en ` 1 ` si deseas depurar una solicitud. Esto registrará la siguiente información:
- Tipo de método (GET o POST), URL y cuerpo de las solicitudes enviadas.
- La URL y el cuerpo de las respuestas recibidas.
- Error de red, si lo hubiera.
Acceso a archivos locales
De forma predeterminada, no puedes utilizar el objeto ` XMLHttpRequest ` para leer archivos de tu sistema de archivos local. Si deseas utilizar esta función para acceder a archivos locales, puedes establecer las siguientes variables de entorno en ` 1`.
- QML_XHR_ALLOW_FILE_READ
- QML_XHR_ALLOW_FILE_WRITE
Advertencia: Utiliza esta función únicamente si sabes que la aplicación ejecuta código QML y JavaScript de confianza.
Documento responseXML
El árbol DOM XML de « responseXML » que admite actualmente QML es un subconjunto reducido de la API DOM Level 3 Core compatible con los navegadores web. La implementación de QML admite los siguientes objetos y propiedades:
| Nodo | Documento | Element | Attr | Datos de carácter | Texto |
|---|---|---|---|---|---|
|
|
|
|
|
|
void XMLHttpRequest::abort()
Cancela la solicitud actual.
Cambia la propiedad `readyState ` a ` XMLHttpRequest.UNSENT ` y emite la señal ` readystatechange `.
string XMLHttpRequest::getAllResponseHeaders()
Devuelve un ` String ` con los encabezados recibidos de la última respuesta.
A continuación se muestra un ejemplo de encabezado de respuesta:
content-encoding: gzip
content-type: text/html; charset=UTF-8
date: Mon, 06 Feb 2023 09:00:08 GMT
expires: Mon, 13 Feb 2023 09:00:08 GMT
last-modified: Thu, 17 Oct 2019 07:18:26 GMTstring XMLHttpRequest::getResponseHeader(headerName)
Devuelve el valor « headerName » de la última respuesta o un « String » vacío, si falta el « headerName ».
void XMLHttpRequest::open(method, url, async)
Especifica el método HTTP method que quieres que utilice la solicitud, así como la URL url a la que deseas acceder. Debes asegurarte de llamar siempre a esta función antes de send(). Se puede utilizar un tercer parámetro opcional, async, para decidir si la solicitud debe ser asíncrona o no. El valor por defecto es true.
Emite la señal readystatechange, que llama al controlador onreadystatechange con la propiedad readyState establecida en XMLHttpRequest.OPENED.
void XMLHttpRequest::send(data)
Envía la solicitud al servidor. Se puede utilizar el argumento opcional data para añadir datos adicionales al cuerpo de la solicitud. Esto puede resultar útil para las solicitudes POST, en las que normalmente se desea que la solicitud contenga datos adicionales.
La propiedad `readyState` se actualiza una vez que se ha recibido una respuesta del servidor y mientras se procesa dicha respuesta. En primer lugar se establecerá en ` HEADERS_RECEIVED`, luego en ` LOADING` y, finalmente, en ` DONE`, una vez que la respuesta se haya procesado por completo. La señal ` readystatechange ` se emite cada vez que se actualiza `readyState`.
void XMLHttpRequest::setRequestHeader(header, value)
Añade un nuevo encabezado a la próxima solicitud que desees enviar. Se trata de un par clave-valor, cuyo nombre es header y cuyo valor correspondiente es value.
void XMLHttpRequest::overrideMimeType(mime)
Obliga a XMLHttpRequest a interpretar los datos recibidos en la siguiente respuesta HTTP como si tuvieran el tipo MIME mime, en lugar del proporcionado por el servidor.
función XMLHttpRequest::onreadystatechange
Selecciona una función de devolución de llamada que se ejecutará cada vez que cambie el estado `readyState` del objeto ` XMLHttpRequest `.
enumeración XMLHttpRequest::readyState
Indica el estado actual del objeto ` XMLHttpRequest `.
El valor puede ser uno de los siguientes:
| Constante | Descripción |
|---|---|
XMLHttpRequest.UNSENT | La solicitud no está inicializada; este es el estado previo a la llamada a open(). |
XMLHttpRequest.OPENED | La solicitud está inicializada, lo que significa que se ha llamado previamente a open(), pero no se ha avanzado más. |
XMLHttpRequest.HEADERS_RECEIVED | Se ha recibido una respuesta del servidor, pero la solicitud aún no se ha procesado por completo. |
XMLHttpRequest.LOADING | Se están descargando datos del servidor. |
XMLHttpRequest.DONE | Se ha finalizado el procesamiento de la solicitud. |
cadena XMLHttpRequest::responseURL
Devuelve la URL que se utilizó para recuperar los datos de la respuesta, una vez que se hayan producido las redirecciones.
cadena XMLHttpRequest::responseText
Devuelve un objeto ` String ` que contiene los datos recibidos de la última respuesta.
var XMLHttpRequest::responseXML
Devuelve un objeto ` Document` o un objeto ` null` si el contenido de la respuesta no se puede analizar como XML o HTML. Consulta la sección del documento dedicada a `responseXML` para obtener más información.
var XMLHttpRequest::response
Devuelve un ` String`, un ` ArrayBuffer` o un ` Document`, dependiendo del ` responseType ` de la última solicitud.
string XMLHttpRequest::responseType
Devuelve un ` String ` que describe el tipo de contenido de la última respuesta recibida.
- Si el tipo de respuesta es «text» o un
Stringvacío, el contenido de la respuesta es unStringcodificado en UTF-16. - Si el tipo de respuesta es «arraybuffer», significa que el contenido de la respuesta es un objeto
ArrayBufferque contiene datos binarios. - Si el tipo de respuesta es «json», el contenido de la respuesta debe ser un
Documentde tipo JSON. - Si el tipo de respuesta es «document», significa que el contenido de la respuesta es un
DocumentXML, que se puede leer de forma segura mediante la propiedad responseXML.
int XMLHttpRequest::status
Devuelve el código de estado de la última respuesta recibida.
string XMLHttpRequest::statusText
Devuelve un ` String ` que contiene el mensaje de estado asociado al código de estado de la última respuesta recibida.
Véase también getResponseHeader(), getAllResponseHeaders(), readyState, onreadystatechange, responseXML, responseText, responseType, response, statusText y status.
© 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.