En esta página

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:

  1. Crea un objeto ` XMLHttpRequest `.
  2. Asigna una función de devolución de llamada al controlador de señales onreadystatechange.
  3. Llama a open() con el método HTTP y la URL adecuados para la solicitud.
  4. 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:

NodoDocumentoElementAttrDatos de carácterTexto
  • nombreDelNodo
  • valor del nodo
  • tipo de nodo
  • nodoParent
  • nodosHijos
  • primeroHijo
  • últimoHijo
  • hermano anterior
  • hermano siguiente
  • atributos
  • versiónXML
  • codificaciónXML
  • xmlStandalone
  • elementoDocumento
  • nombreDeEtiqueta
  • nombre
  • valor
  • elementoPropietario
  • datos
  • longitud
  • esEspacioEnBlancoEnContenidoDelElemento
  • textoCompleto

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 GMT

string 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:

ConstanteDescripción
XMLHttpRequest.UNSENTLa solicitud no está inicializada; este es el estado previo a la llamada a open().
XMLHttpRequest.OPENEDLa solicitud está inicializada, lo que significa que se ha llamado previamente a open(), pero no se ha avanzado más.
XMLHttpRequest.HEADERS_RECEIVEDSe ha recibido una respuesta del servidor, pero la solicitud aún no se ha procesado por completo.
XMLHttpRequest.LOADINGSe están descargando datos del servidor.
XMLHttpRequest.DONESe 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 String vacío, el contenido de la respuesta es un String codificado en UTF-16.
  • Si el tipo de respuesta es «arraybuffer», significa que el contenido de la respuesta es un objeto ArrayBuffer que contiene datos binarios.
  • Si el tipo de respuesta es «json», el contenido de la respuesta debe ser un Document de tipo JSON.
  • Si el tipo de respuesta es «document», significa que el contenido de la respuesta es un Document XML, 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.