XMLHttpRequest 构造函数,用于创建一个XMLHttpRequest实例
new XMLHttpRequest()
Método de ejemplo:
Si la solicitud ha sido enviada, la solicitud se cancela inmediatamente.
XMLHttpRequest.getAllResponseHeaders()
Devuelve todos los encabezados de respuesta separados por CRLF en forma de cadenas de caracteres, o devuelve si no se recibe respuesta null
.
XMLHttpRequest.getResponseHeader()
Devuelve una cadena que contiene el encabezado de respuesta especificado. Si la respuesta no se ha recibido o el encabezado no existe en la respuesta, se devuelve null
.
Inicializar una solicitud. Este método solo se puede usar en código JavaScript, para inicializar la solicitud en código nativo, utilice openRequest()
.
XMLHttpRequest.overrideMimeType()
Reescriba el tipo MIME devuelto por el servidor.
Enviar una solicitud Si la solicitud es asíncrona (predeterminada), el método volverá inmediatamente después de que se envíe la solicitud.
XMLHttpRequest.setRequestHeader()
Establezca el valor del encabezado de solicitud HTTP. Debe llamar al método open()
después y send()
antes setRequestHeader()
.
Atributos de instancia:
XMLHttpRequest.onreadystatechange
Se llama cuando cambia la propiedad readyState EventHandler
.
XMLHttpRequest.readyState
Solo lectura
Devuelve un número corto sin signo (corto sin signo), que representa el código de estado solicitado.
XMLHttpRequest.response
Solo lectura
Devuelve una ArrayBuffer
, Blob
, Document
, o DOMString
, en particular, en función del tipo XMLHttpRequest.responseType
de valor. Contiene todo el cuerpo de respuesta.
XMLHttpRequest.responseText
Solo lectura
Devuelve uno DOMString
, que DOMString
contiene la respuesta a la solicitud, y devuelve si la solicitud no fue exitosa o no se envió null
.
Un valor enumerado utilizado para definir el tipo de respuesta.
XMLHttpRequest.responseURL
Solo lectura
Devuelve la URL serializada de la respuesta. Si la URL está vacía, se devuelve una cadena vacía.
XMLHttpRequest.responseXML
Solo lectura
Devuelve uno Document
, que contiene la respuesta a la solicitud. Si la solicitud no tuvo éxito, no se ha enviado o no se puede analizar como XML o HTML, se devuelve null
.
XMLHttpRequest.status
Solo lectura
Devuelve un número corto sin signo (corto sin signo), que representa el estado de respuesta de la solicitud.
XMLHttpRequest.statusText
Solo lectura
Devuelve uno DOMString
, que contiene el estado de respuesta devuelto por el servidor HTTP. La XMLHTTPRequest.status
diferencia es que contiene el texto completo del estado de respuesta (por ejemplo, " 200 OK
").
Nota: De acuerdo con la especificación HTTP / 2 ( 8.1.2.4 Campos de pseudo encabezado de respuesta ), HTTP / 2 no define ningún método para transportar la versión o la frase de razón contenida en la línea de estado HTTP / 1.1.
Un número entero largo sin signo (largo sin signo), que indica el tiempo máximo de solicitud (milisegundos) de la solicitud, si se excede el tiempo, la solicitud finalizará automáticamente.
XMLHttpRequestEventTarget.ontimeout
Llamado cuando la solicitud agota el tiempo de espera EventHandler
.
XMLHttpRequest.upload
Solo lectura
XMLHttpRequestUpload
, En nombre del proceso de carga.
XMLHttpRequest.withCredentials
Uno 布尔值
, utilizado para especificar si las Access-Control
solicitudes entre dominios deben contener información de autorización, como cookies o encabezados de autorización.
Ejemplos:
var xhr = new XMLHttpRequest ();
xhr.onreadystatechange = function () {
if (xhr.readyState == 4) {
if ((xhr.status> = 200 && xhr.status <300) || xhr.status == 304) {
alert (xhr.responseText) ;
} else {
alert ("La solicitud no tuvo éxito:" + xhr.status);
}
}
};
xhr.open ("get", "example.txt", verdadero);
xhr.send (nulo);
Resumen:
Use pasos
1. Cree una instancia nueva nueva XMLHttpRequest ();
2. Agregar monitoreo para el evento onreadystatechange
3. 调用 xhr..open (método, url, asíncrono);
4. Establezca el encabezado de solicitud xhr.setRequestHeader (encabezado, valor);
5. Envíe la solicitud, xhr.send ()
xhr.send(null); // xhr.send('string');
//xhr.send(new Blob()); // xhr.send(new Int8Array()); // xhr.send({ form: 'data' }); // xhr.send(document);
xhr.send("foo=bar&lorem=ipsum"); // xhr.send('string');
//xhr.send(new Blob()); // xhr.send(new Int8Array()); // xhr.send({ form: 'data' }); // xhr.send(document);
6. La respuesta se procesa en onreadystatechange, o se llama a xhr.abort () para interrumpir la solicitud