XMLHttpRequest

  • Enlace amigable (slug) de la revisión: XMLHttpRequest
  • Título de la revisión: XMLHttpRequest
  • Id de la revisión: 287964
  • Creada:
  • Creador: deimidis
  • ¿Es la revisión actual? No
  • Comentario 855 words added, 829 words removed

Contenido de la revisión

XMLHttpRequest es un objeto JavaScript que fue diseñado por Microsoft, adoptado por Mozilla, y actualmente es un estandar de la W3C. Proporciona una forma fácil para recaudar información de una URL. A pesar de su nombre, XMLHttpRequest puede ser usado para recibir cualquier tipo de dato, no solo XML, y admite otros formatos además de HTTP (incluyendo file y ftp).

Para crear una instancia de XMLHttpRequest, debes hacer lo siguiente:

var req = new XMLHttpRequest();

Para obtener más nformación de cómo usar XMLHttpRequest, mira Usar XMLHttpRequest.

Nota: De forma predeterminada, Firefox 3 limita la cantidad de conexiones de XMLHttpRequest por servidor a 6 (las versiones previas limitan a 2 conexiones por servidor). Algunos sitios web interactivos pueden mantener una conexión XMLHttpRequest abierta, así que abrir múltiples sesiones a esos sitios puede resultar en congelamientos del navegador de ua forma que la ventana no se actualiza y los controles no responden. Este valor puede ser cambiado al editar la preferencia network.http.max-persistent-connections-per-server en about:config.

Resumen del método

void abort();
string getAllResponseHeaders();
ACString getResponseHeader(in AUTF8String header);
[noscript] void init(in nsIPrincipal principal, in nsIScriptContext scriptContext, in nsPIDOMWindow ownerWindow);
void open(in AUTF8String method, in AUTF8String url);
[noscript] void openRequest(in AUTF8String method, in AUTF8String url, in boolean async, in AString user, in AString password);
void overrideMimeType(in AUTF8String mimetype);
void send([optional] in nsIVariant body);
void sendAsBinary(in DOMString body); {{ fx_minversion_inline(3) }}
void setRequestHeader(in AUTF8String header, in AUTF8String value);

Propiedades

Atributo Tipo Descripción
channel {{ Interface("nsIChannel") }} El canal es usado por el objeto cuando se produce el pedido. Esto da null si el canal aún no fue creado. En el caso de un pedido de múltiples partes, este es el canal inicial, no las diferentes partes del pedido múltiple. Es necesario tener privilegios elevados para acceder; solo lectura. {{ Non-standard_inline() }}
mozBackgroundRequest booleano

Indica si el objeto representa o no un pedido de un servicio de fondo. Si es true, no se asocia una carga de grupo con el pedido, y los diálogos de seguridad no se muestran al usuario. Es necesario tener privilegios elevados para acceder. {{ Non-standard_inline() }}

En los casos en que un diálogo de seguridad debe ser mostrado (como en una autentficación o la notificación de un certificado no válido), el pedido simplemente falla.

mozResponseArrayBuffer {{ gecko_minversion_inline("2.0") }} {{ non-standard_inline() }} ArrayBuffer La respuesta al pedido en la forma de un arreglo de JavaScript. Esto es NULL si el pedido no fue exitoso o si todavía no ha sido enviado. Solo lectura.
multipart booleano

Indica cuando se espera que la respuesta sea o no una serie de mútiples documentos XML. Si se define como true, el tipo de contenido de la respuesta inicial debe ser multipart/x-mixed-replace u ocurrirá un error. Todos los pedidos deben ser asincrónicos.

Esto permite el uso del push del servidor; para cada documento XML que se escribe para este pedido, se crea un nuevo XMLDOMdocument y se llama al manejador onload entre cada documento.

Nota: Cuando esto se elige, el manejador onload y otros manejadores de eventos no son reiniciados después de que el primer XMLdocument es cargado, y el manejador onload es llamado después de que cada parte de la respuesta es recibida.

onreadystatechange

{{ Interface("nsIDOMEventListener") }}

Una función del objeto JavaScript que se llama cuando el atributo readyState cambia. El callback se llama desde la interfaz del usuario.

Aviso: Esto no debe ser usado desde código nativo. Tampoco debes usarlo con peidos sincrónicos.
readyState long

El estado del pedido:

Valor Estado Descripción
0 UNINITIALIZED todavía no se llamó a open().
1 LOADING todavía no se llamó a send().
2 LOADED send() ya fue invocado, y los encabezados y el estado están disponibles.
3 INTERACTIVE Doescargando; responseText contiene información parcial.
4 COMPLETED La operación está terminada.
responseText AString La respuesta al pedido como texto, o null si el pedido no fue exitoso o todavía no se envió. Solo lectura.
responseXML nsIDOMDocument

La respuesta al pedido como un objeto DOMDocument, o null si el pedido no fue exitoso, aún no fue enviado o no puede ser analizado como XML. La respuesta es analizada como si fuera text/xml. Solo lectura.

Note: Si el servidor no aplica el encabezado de tipo de contenido text/xml, puedes usar overrideMimeType() para forzar a XMLHttpRequest a analizarlo como XML igualmente.
status unsigned long El estado de la respuesta al pedido. Este es el código HTTPresult (por ejemplo, status es 200 por un pedido exitoso). Solo lectura.
statusText AUTF8String La cadena de respuesta que devuelve el HTTPserver. A diferencia de status, este incluye el texto completo del mensaje de respuesta ("200 OK", por ejemplo). Solo lectura.
upload {{ Interface("nsIXMLHttpRequestUpload") }} El proceso de subida puede ser rastreado al agregar un registro de evento a upload. {{ fx_minversion_inline(3.5) }}
withCredentials booleano

Indica cuando el pedido de Access-Control entre sitios debe o no ser realizado usando credenciales como cookies o encabezados de autorización. {{ fx_minversion_inline(3.5) }}

Nota: Esto nunca afecta los pedidos en para el propio sitio.

El valor predeterminado es false.

Métodos

abort()

Aborta el pedido si este ya fue enviado.

void abort();
Parámetros

Ninguno.

getAllResponseHeaders()

Devuelve todos los encabezados de respuesta como una cadena.

Nota: Para pedidos multi partes, esto devuelve los encabezados de la parte actual del pedido, no del canal original.
string getAllResponseHeaders();
Parámetros

Ninguno.

Valor devuelto

El texto de todos los encabezados de respuesta, o null si no se ha recibido ninguna respuesta.

getResponseHeader()

Devuelve el texto de un encabezado específico.

ACString getResponseHeader(
 in AUTF8String header
);
Parámetros
header
El nombre del encabezado buscado.
Valor devuelto

Una cadena que contiene el texto de un encabezado específico, o null tanto si la respuesta no se ha recibido o el encabezado no existe en la respuesta.

init()

Inicializa el objeto para que sea usado desde código C++.

Aviso: Este método no debe ser llamado desde JavaScript.
[noscript] void init(
 in nsIPrincipal principal,
 in nsIScriptContext scriptContext,
 in nsPIDOMWindow ownerWindow
);
Parámetros
principal
El principal para usar en el pedido; no debe ser null.
scriptContext
El contexto del programa que usará en el pedido; no debe ser null.
ownerWindow
La ventana asociada con el pedido; puede ser null.

open()

Inicializa el pedido. Este método es para ser usado desde código JavaScript, para inicializar un pedido desde código nativo, debes usar openRequest().

Nota: Llamar a este método en un pedido activo (uno para el cual open() o openRequest() ya han sido llamados) es equivalente a usar abort().
void open(
 in AUTF8String method,
 in AUTF8String url,
 [optional] in boolean async,
 [optional] in AString user,
 [optional] in AString password
);
Parámetros
method
El método HTTP a usar: tanto "POST" o "GET". Se ignora para urls que no son de HTTP.
url
La URL a la que se envía el pedido.
async
An optional boolean parameter, defaulting to true, indicating whether or not to perform the operation asynchronously. If this value is false, the send()method does not return until the response is received. If true, notification of a completed transaction is provided using event listeners. This must be true if the multipart attribute is true, or an exception will be thrown.
user
The optional user name to use for authentication purposes; by default, this is an empty string.
password
The optional password to use for authentication purposes; by default, this is an empty string.

openRequest()

Initializes a request. This method is to be used from native code; to initialize a request from JavaScript code, use open()instead.

Note: Calling this method an already active request (one for which open()or openRequest()has already been called) is the equivalent of calling abort().
void open(
 in AUTF8String method,
 in AUTF8String url,
 in boolean async,
 in AString user,
 in AString password
);
Parameters
method
The HTTPmethod to use; either "POST"or "GET". Ignored for non-HTTPURLs.
url
The URLto which to send the request.
async
An optional boolean parameter, defaulting to true, indicating whether or not to perform the operation asynchronously. If this value is false, the send()method does not return until the response is received. If true, notification of a completed transaction is provided using event listeners. This must be true if the multipart attribute is true, or an exception will be thrown.
user
The optional user name to use for authentication purposes; by default, this is an empty string.
password
The optional password to use for authentication purposes; by default, this is an empty string.

overrideMimeType()

Overrides the MIMEtype returned by the server.

Note: This method must be called before send().
void overrideMimeType(
 in AUTF8String mimetype
);
Parameters
mimetype
The type that should be used instead of the one returned by the server, if any.

send()

Sends the request. If the request is asynchronous (which is the default), this method returns as soon as the request is sent. If the request is synchronous, this method doesn't return until the response has arrived.

Note: Any event listeners you wish to set must be set before calling send().
void send(
 [optional] in nsIVariant body
);
Parameters
body
This may be an nsIDocument, nsIInputStream, or a string (an nsISupportsString if called from native code) that is used to populate the body of a POST request. Starting with Gecko 1.9.2, you may also specify an DOM{{ domxref("File") }} , and starting with Gecko 2.0 {{ geckoRelease("2.0") }} you may also specify a FormData object.
Notes

If the body is an nsIDOMDocument, it is serialized before being sent.

If it's an nsIInputStream, it must be compatible with nsIUploadChannel's setUploadStream()method. In that case, a Content-Length header is added to the request, with its value obtained using nsIInputStream's available()method. Any headers included at the top of the stream are treated as part of the message body. The stream's MIMEtype should be specified by setting the Content-Type header using the setRequestHeader()method prior to calling send().

{{ method_gecko_minversion("sendAsBinary", "1.9") }}

A variant of the send()method that sends binary data.

void sendAsBinary(
 in DOMString body
);
Parameters
body
The request body as a DOMstring. This data is converted to a string of single-byte characters by truncation (removing the high-order byte of each character).

setRequestHeader()

Sets the value of an HTTPrequest header.

Note: You must call open()before using this method.
void setRequestHeader(
 in AUTF8String header,
 in AUTF8String value
);
Parameters
header
The name of the header whose value is to be set.
value
The value to set as the body of the header.

Implementation notes

XMLHttpRequest is implemented in Gecko using the {{ interface("nsIJSXMLHttpRequest") }} and {{ interface("nsIXMLHttpRequest") }} interfaces.

See also

{{ languages( { "es": "es/XMLHttpRequest", "fr": "fr/XMLHttpRequest", "it": "it/XMLHttpRequest", "ja": "ja/XMLHttpRequest", "ko": "ko/XMLHttpRequest", "pl": "pl/XMLHttpRequest", "zh-cn": "cn/XMLHttpRequest" } ) }}

Fuente de la revisión

<p><code>XMLHttpRequest</code> es un objeto <a class="internal" href="/en/JavaScript" title="En/JavaScript">JavaScript</a> que fue diseñado por Microsoft, adoptado por Mozilla, y actualmente es un <a class="external" href="http://www.w3.org/TR/XMLHttpRequest/" title="http://www.w3.org/TR/XMLHttpRequest/">estandar de la W3C</a>. Proporciona una forma fácil para recaudar información de una URL. A pesar de su nombre, <code>XMLHttpRequest</code> puede ser usado para recibir cualquier tipo de dato, no solo XML, y admite otros formatos además de <a href="/en/HTTP" title="en/HTTP">HTTP</a> (incluyendo <code>file</code> y <code>ftp</code>).</p>
<p>Para crear una instancia de <code>XMLHttpRequest</code>, debes hacer lo siguiente:</p>
<pre>var req = new XMLHttpRequest();
</pre>
<p>Para obtener más nformación de cómo usar <code>XMLHttpRequest</code>, mira <a class="internal" href="/Es/XMLHttpRequest/Usar_XMLHttpRequest" title="En/Using XMLHttpRequest">Usar XMLHttpRequest</a>.</p>
<div class="note"><strong>Nota:</strong> De forma predeterminada, Firefox 3 limita la cantidad de conexiones de <code>XMLHttpRequest</code> por servidor a 6 (las versiones previas limitan a 2 conexiones por servidor). Algunos sitios web interactivos pueden mantener una conexión <code>XMLHttpRequest</code> abierta, así que abrir múltiples sesiones a esos sitios puede resultar en congelamientos del navegador de ua forma que la ventana no se actualiza y los controles no responden. Este valor puede ser cambiado al editar la preferencia <code>network.http.max-persistent-connections-per-server</code> en <code><a class="linkification-ext" href="/about:config" title="Linkification: about:config">about:config</a></code>.</div>
<h2 id="Resumen_del_m.C3.A9todo">Resumen del método</h2>
<table class="standard-table"> <tbody> <tr> <td><code>void <a class="internal" href="/en/XMLHttpRequest#abort()" title="/En/XMLHttpRequest#abort()">abort</a>();</code></td> </tr> <tr> <td><code>string <a class="internal" href="/en/XMLHttpRequest#getAllResponseHeaders()" title="/en/XMLHttpRequest#getAllResponseHeaders()">getAllResponseHeaders</a>();</code></td> </tr> <tr> <td><code>ACString <a class="internal" href="/en/XMLHttpRequest#getResponseHeader()" title="/en/XMLHttpRequest#getResponseHeader()">getResponseHeader</a>(in AUTF8String header);</code></td> </tr> <tr> <td><code>[noscript] void <a class="internal" href="/en/XMLHttpRequest#init()" title="/en/XMLHttpRequest#init()">init</a>(in nsIPrincipal principal, in nsIScriptContext scriptContext, in nsPIDOMWindow ownerWindow);</code></td> </tr> <tr> <td><code>void <a class="internal" href="/en/XMLHttpRequest#open()" title="/en/XMLHttpRequest#open()">open</a>(in AUTF8String method, in AUTF8String url);</code></td> </tr> <tr> <td><code>[noscript] void <a class="internal" href="/en/XMLHttpRequest#openRequest()" title="/en/XMLHttpRequest#openRequest()">openRequest</a>(in AUTF8String method, in AUTF8String url, in boolean async, in AString user, in AString password);</code></td> </tr> <tr> <td><code>void <a class="internal" href="/en/XMLHttpRequest#overrideMimeType()" title="/en/XMLHttpRequest#overrideMimeType()">overrideMimeType</a>(in AUTF8String mimetype);</code></td> </tr> <tr> <td><code>void <a class="internal" href="/en/XMLHttpRequest#send()" title="/en/XMLHttpRequest#send()">send</a>([optional] in nsIVariant body);</code></td> </tr> <tr> <td><code>void <a class="internal" href="/en/XMLHttpRequest#sendAsBinary()" title="/en/XMLHttpRequest#sendAsBinary()">sendAsBinary</a>(in DOMString body); {{ fx_minversion_inline(3) }}<br> </code></td> </tr> <tr> <td><code>void <a class="internal" href="/en/XMLHttpRequest#setRequestHeader()" title="/en/XMLHttpRequest#setRequestHeader()">setRequestHeader</a>(in AUTF8String header, in AUTF8String value);</code></td> </tr> </tbody>
</table>
<h2 id="Propiedades">Propiedades</h2>
<table class="standard-table"> <tbody> <tr> <td class="header">Atributo</td> <td class="header">Tipo</td> <td class="header">Descripción</td> </tr> <tr> <td><code>channel</code></td> <td>{{ Interface("nsIChannel") }}</td> <td>El canal es usado por el objeto cuando se produce el pedido. Esto da <code>null</code> si el canal aún no fue creado. En el caso de un pedido de múltiples partes, este es el canal inicial, no las diferentes partes del pedido múltiple. <strong>Es necesario tener privilegios elevados para acceder; solo lectura.</strong> {{ Non-standard_inline() }}</td> </tr> <tr> <td><code>mozBackgroundRequest</code></td> <td><code>booleano</code></td> <td> <p>Indica si el objeto representa o no un pedido de un servicio de fondo. Si es <code>true</code>, no se asocia una carga de grupo con el pedido, y los diálogos de seguridad no se muestran al usuario. <strong>Es necesario tener privilegios elevados para acceder. </strong>{{ Non-standard_inline() }}</p> <p>En los casos en que un diálogo de seguridad debe ser mostrado (como en una autentficación o la notificación de un certificado no válido), el pedido simplemente falla.</p> </td> </tr> <tr> <td><code>mozResponseArrayBuffer</code> {{ gecko_minversion_inline("2.0") }} {{ non-standard_inline() }}</td> <td><a href="/en/JavaScript_typed_arrays/ArrayBuffer" title="en/JavaScript typed arrays/ArrayBuffer"><code>ArrayBuffer</code></a></td> <td>La respuesta al pedido en la forma de un arreglo de JavaScript. Esto es NULL si el pedido no fue exitoso o si todavía no ha sido enviado. <strong>Solo lectura.</strong></td> </tr> <tr> <td><code>multipart</code></td> <td><code>booleano</code></td> <td> <p>Indica cuando se espera que la respuesta sea o no una serie de mútiples documentos XML. Si se define como <code>true</code>, el tipo de contenido de la respuesta inicial debe ser <code>multipart/x-mixed-replace</code> u ocurrirá un error. Todos los pedidos deben ser asincrónicos.</p> <p>Esto permite el uso del push del servidor; para cada documento XML que se escribe para este pedido, se crea un nuevo XMLDOMdocument y se llama al manejador <code>onload</code> entre cada documento.</p> <div class="note"><strong>Nota:</strong> Cuando esto se elige, el manejador <code>onload</code> y otros manejadores de eventos no son reiniciados después de que el primer XMLdocument es cargado, y el manejador <code>onload</code> es llamado después de que cada parte de la respuesta es recibida.</div> </td> </tr> <tr id="onreadystatechange"> <td> <p><code>onreadystatechange</code></p> </td> <td>{{ Interface("nsIDOMEventListener") }}</td> <td> <p>Una función del objeto JavaScript que se llama cuando el atributo <code>readyState</code> cambia. El callback se llama desde la interfaz del usuario.</p> <div class="warning"><strong>Aviso: </strong>Esto no debe ser usado desde código nativo. Tampoco debes usarlo con peidos sincrónicos.</div> </td> </tr> <tr id="readyState"> <td><code>readyState</code></td> <td><code>long</code></td> <td> <p>El estado del pedido:</p> <table class="standard-table"> <tbody> <tr> <td class="header">Valor</td> <td class="header">Estado</td> <td class="header">Descripción</td> </tr> <tr> <td><code>0</code></td> <td><code>UNINITIALIZED</code></td> <td>todavía no se llamó a <code>open()</code>.</td> </tr> <tr> <td><code>1</code></td> <td><code>LOADING</code></td> <td>todavía no se llamó a <code>send()</code>.</td> </tr> <tr> <td><code>2</code></td> <td><code>LOADED</code></td> <td><code>send()</code> ya fue invocado, y los encabezados y el estado están disponibles.</td> </tr> <tr> <td><code>3</code></td> <td><code>INTERACTIVE</code></td> <td>Doescargando; <code>responseText</code> contiene información parcial.</td> </tr> <tr> <td><code>4</code></td> <td><code>COMPLETED</code></td> <td>La operación está terminada.</td> </tr> </tbody> </table> </td> </tr> <tr id="responseText"> <td><code>responseText</code></td> <td><code>AString</code></td> <td>La respuesta al pedido como texto, o <code>null</code> si el pedido no fue exitoso o todavía no se envió. <strong>Solo lectura.</strong></td> </tr> <tr id="responseXML"> <td><code>responseXML</code></td> <td><code>nsIDOMDocument</code></td> <td> <p>La respuesta al pedido como un objeto DOM<code><a class="internal" href="/en/DOM/document" title="En/DOM/Document">Document</a></code>, o <code>null</code> si el pedido no fue exitoso, aún no fue enviado o no puede ser analizado como XML. La respuesta es analizada como si fuera <code>text/xml</code>. <strong>Solo lectura.</strong></p> <div class="note"><strong>Note:</strong> Si el servidor no aplica el encabezado de tipo de contenido <code>text/xml</code>, puedes usar <code>overrideMimeType()</code> para forzar a <code>XMLHttpRequest</code> a analizarlo como XML igualmente.</div> </td> </tr> <tr id="status"> <td><code>status</code></td> <td><code>unsigned long</code></td> <td>El estado de la respuesta al pedido. Este es el código HTTPresult (por ejemplo, <code>status</code> es 200 por un pedido exitoso). <strong>Solo lectura.</strong></td> </tr> <tr> <td><code>statusText</code></td> <td><code>AUTF8String</code></td> <td>La cadena de respuesta que devuelve el HTTPserver. A diferencia de <code>status</code>, este incluye el texto completo del mensaje de respuesta ("<code>200 OK</code>", por ejemplo). <strong>Solo lectura.</strong></td> </tr> <tr> <td><code>upload</code></td> <td>{{ Interface("nsIXMLHttpRequestUpload") }}</td> <td>El proceso de subida puede ser rastreado al agregar un registro de evento a <code>upload</code>. {{ fx_minversion_inline(3.5) }}</td> </tr> <tr> <td><code>withCredentials</code></td> <td><code>booleano</code></td> <td> <p>Indica cuando el pedido de Access-Control entre sitios debe o no ser realizado usando credenciales como cookies o encabezados de autorización. {{ fx_minversion_inline(3.5) }}</p> <div class="note"><strong>Nota:</strong> Esto nunca afecta los pedidos en para el propio sitio.</div> <p>El valor predeterminado es <code>false</code>.</p> </td> </tr> </tbody>
</table>
<h2 id="M.C3.A9todos">Métodos</h2>
<h3 id="abort()">abort()</h3>
<p>Aborta el pedido si este ya fue enviado.</p>
<pre>void abort();
</pre>
<h6 id="Par.C3.A1metros">Parámetros</h6>
<p>Ninguno.</p>
<h3 id="getAllResponseHeaders()">getAllResponseHeaders()</h3>
<p>Devuelve todos los encabezados de respuesta como una cadena.</p>
<div class="note"><strong>Nota:</strong> Para pedidos multi partes, esto devuelve los encabezados de la parte <em>actual</em> del pedido, no del canal original.</div>
<pre>string getAllResponseHeaders();
</pre>
<h6 id="Par.C3.A1metros">Parámetros</h6>
<p>Ninguno.</p>
<h6 id="Valor_devuelto">Valor devuelto</h6>
<p>El texto de todos los encabezados de respuesta, o <code>null</code> si no se ha recibido ninguna respuesta.</p>
<h3 id="getResponseHeader()">getResponseHeader()</h3>
<p>Devuelve el texto de un encabezado específico.</p>
<pre>ACString getResponseHeader(
 in AUTF8String header
);
</pre>
<h6 id="Par.C3.A1metros">Parámetros</h6>
<dl> <dt><code>header</code></dt> <dd>El nombre del encabezado buscado.</dd>
</dl>
<h6 id="Valor_devuelto">Valor devuelto</h6>
<p>Una cadena que contiene el texto de un encabezado específico, o <code>null</code> tanto si la respuesta no se ha recibido o el encabezado no existe en la respuesta.</p>
<h3 id="init()">init()</h3>
<p>Inicializa el objeto para que sea usado desde código C++.</p>
<div class="warning"><strong>Aviso:</strong> Este método <em>no</em> debe ser llamado desde JavaScript.</div>
<pre>[noscript] void init(
 in nsIPrincipal principal,
 in nsIScriptContext scriptContext,
 in nsPIDOMWindow ownerWindow
);
</pre>
<h6 id="Par.C3.A1metros">Parámetros</h6>
<dl> <dt><code>principal</code></dt> <dd>El principal para usar en el pedido; no debe ser <code>null</code>.</dd> <dt><code>scriptContext</code></dt> <dd>El contexto del programa que usará en el pedido; no debe ser <code>null</code>.</dd> <dt><code>ownerWindow</code></dt> <dd>La ventana asociada con el pedido; puede ser <code>null</code>.</dd>
</dl>
<h3 id="open()">open()</h3>
<p>Inicializa el pedido. Este método es para ser usado desde código JavaScript, para inicializar un pedido desde código nativo, debes usar <a class="internal" href="/en/XMLHttpRequest#openRequest()" title="/en/XMLHttpRequest#openRequest()"><code>openRequest()</code></a>.</p>
<div class="note"><strong>Nota:</strong> Llamar a este método en un pedido activo (uno para el cual <code>open()</code> o <code>openRequest()</code> ya han sido llamados) es equivalente a usar <code>abort()</code>.</div>
<pre>void open(
 in AUTF8String method,
 in AUTF8String url,
 [optional] in boolean async,
 [optional] in AString user,
 [optional] in AString password
);
</pre>
<h6 id="Par.C3.A1metros">Parámetros</h6>
<dl> <dt><code>method</code></dt> <dd>El método HTTP a usar: tanto "POST" o "GET". Se ignora para urls que no son de HTTP.</dd> <dt><code>url</code></dt> <dd>La URL a la que se envía el pedido.</dd> <dt><code>async</code></dt> <dd>An optional boolean parameter, defaulting to <code>true</code>, indicating whether or not to perform the operation asynchronously. If this value is <code>false</code>, the <code>send()</code>method does not return until the response is received. If <code>true</code>, notification of a completed transaction is provided using event listeners. This <em>must</em> be true if the <code>multipart</code> attribute is <code>true</code>, or an exception will be thrown.</dd> <dt><code>user</code></dt> <dd>The optional user name to use for authentication purposes; by default, this is an empty string.</dd> <dt><code>password</code></dt> <dd>The optional password to use for authentication purposes; by default, this is an empty string.</dd>
</dl>
<h3 id="openRequest()">openRequest()</h3>
<p>Initializes a request. This method is to be used from native code; to initialize a request from JavaScript code, use <a class="internal" href="/en/XMLHttpRequest#open()" title="/en/XMLHttpRequest#open()"><code>open()</code></a>instead.</p>
<div class="note"><strong>Note:</strong> Calling this method an already active request (one for which <code>open()</code>or <code>openRequest()</code>has already been called) is the equivalent of calling <code>abort()</code>.</div>
<pre>void open(
 in AUTF8String method,
 in AUTF8String url,
 in boolean async,
 in AString user,
 in AString password
);
</pre>
<h6 id="Parameters">Parameters</h6>
<dl> <dt><code>method</code></dt> <dd>The HTTPmethod to use; either "POST"or "GET". Ignored for non-HTTPURLs.</dd> <dt><code>url</code></dt> <dd>The URLto which to send the request.</dd> <dt><code>async</code></dt> <dd>An optional boolean parameter, defaulting to <code>true</code>, indicating whether or not to perform the operation asynchronously. If this value is <code>false</code>, the <code>send()</code>method does not return until the response is received. If <code>true</code>, notification of a completed transaction is provided using event listeners. This <em>must</em> be true if the <code>multipart</code> attribute is <code>true</code>, or an exception will be thrown.</dd> <dt><code>user</code></dt> <dd>The optional user name to use for authentication purposes; by default, this is an empty string.</dd> <dt><code>password</code></dt> <dd>The optional password to use for authentication purposes; by default, this is an empty string.</dd>
</dl>
<h3 id="overrideMimeType()">overrideMimeType()</h3>
<p>Overrides the MIMEtype returned by the server.</p>
<div class="note"><strong>Note:</strong> This method must be called before <code>send()</code>.</div>
<pre>void overrideMimeType(
 in AUTF8String mimetype
);
</pre>
<h6 id="Parameters">Parameters</h6>
<dl> <dt><code>mimetype</code></dt> <dd>The type that should be used instead of the one returned by the server, if any.</dd>
</dl>
<h3 id="send()">send()</h3>
<p>Sends the request. If the request is asynchronous (which is the default), this method returns as soon as the request is sent. If the request is synchronous, this method doesn't return until the response has arrived.</p>
<div class="note"><strong>Note:</strong> Any event listeners you wish to set must be set before calling <code>send()</code>.</div>
<pre>void send(
 [optional] in nsIVariant body
);
</pre>
<h6 id="Parameters">Parameters</h6>
<dl> <dt><code>body</code></dt> <dd>This may be an <code>nsIDocument</code>, <code>nsIInputStream</code>, or a string (an <code>nsISupportsString</code> if called from native code) that is used to populate the body of a POST request. Starting with Gecko 1.9.2, you may also specify an DOM{{ domxref("File") }} , and starting with Gecko 2.0 {{ geckoRelease("2.0") }} you may also specify a <a href="/en/XMLHttpRequest/FormData" title="en/XMLHttpRequest/FormData"><code>FormData</code></a> object.</dd>
</dl>
<h6 id="Notes">Notes</h6>
<p>If the body is an <code>nsIDOMDocument</code>, it is serialized before being sent.</p>
<p>If it's an <code>nsIInputStream</code>, it must be compatible with <code>nsIUploadChannel</code>'s <code>setUploadStream()</code>method. In that case, a Content-Length header is added to the request, with its value obtained using <code>nsIInputStream</code>'s <code>available()</code>method. Any headers included at the top of the stream are treated as part of the message body. The stream's MIMEtype should be specified by setting the Content-Type header using the <a class="internal" href="/en/XMLHttpRequest#setRequestHeader()" title="/en/XMLHttpRequest#setRequestHeader()"><code>setRequestHeader()</code></a>method prior to calling <code>send()</code>.</p>
<p>{{ method_gecko_minversion("sendAsBinary", "1.9") }}</p>
<p>A variant of the <code>send()</code>method that sends binary data.</p>
<pre>void sendAsBinary(
 in DOMString body
);
</pre>
<h6 id="Parameters">Parameters</h6>
<dl> <dt><code>body</code></dt> <dd>The request body as a DOMstring. This data is converted to a string of single-byte characters by truncation (removing the high-order byte of each character).</dd>
</dl>
<h3 id="setRequestHeader()">setRequestHeader()</h3>
<p>Sets the value of an HTTPrequest header.</p>
<div class="note"><strong>Note:</strong> You must call <a class="internal" href="/en/XMLHttpRequest#open()" title="/en/XMLHttpRequest#open()"><code>open()</code></a>before using this method.</div>
<pre>void setRequestHeader(
 in AUTF8String header,
 in AUTF8String value
);
</pre>
<h6 id="Parameters">Parameters</h6>
<dl> <dt><code>header</code></dt> <dd>The name of the header whose value is to be set.</dd> <dt><code>value</code></dt> <dd>The value to set as the body of the header.</dd>
</dl>
<h2 id="Implementation_notes">Implementation notes</h2>
<p><code>XMLHttpRequest</code> is implemented in Gecko using the {{ interface("nsIJSXMLHttpRequest") }} and {{ interface("nsIXMLHttpRequest") }} interfaces.</p>
<h2 id="See_also">See also</h2>
<ul> <li><a class="internal" href="/En/XMLHttpRequest/Using_XMLHttpRequest" title="En/Using XMLHttpRequest">Using XMLHttpRequest</a></li> <li><a href="/en/XMLHttpRequest/FormData" title="en/XMLHttpRequest/FormData"><code>FormData</code></a></li> <li><a href="/en/AJAX/Getting_Started" title="en/AJAX/Getting_Started">MDC AJAX introduction</a></li> <li><a class="external" href="http://www.peej.co.uk/articles/rich-user-experience.html">XMLHttpRequest - REST and the Rich User Experience</a></li> <li><a class="external" href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/xmlsdk/html/xmobjxmlhttprequest.asp">Microsoft documentation</a></li> <li><a class="external" href="http://developer.apple.com/internet/webcontent/xmlhttpreq.html">Apple developers' reference</a></li> <li><a class="external" href="http://jibbering.com/2002/4/httprequest.html">"Using the XMLHttpRequest Object" (jibbering.com)</a></li> <li><a class="external" href="http://www.w3.org/TR/XMLHttpRequest/">The XMLHttpRequest Object: W3C Working Draft</a></li>
</ul>
<p>{{ languages( { "es": "es/XMLHttpRequest", "fr": "fr/XMLHttpRequest", "it": "it/XMLHttpRequest", "ja": "ja/XMLHttpRequest", "ko": "ko/XMLHttpRequest", "pl": "pl/XMLHttpRequest", "zh-cn": "cn/XMLHttpRequest" } ) }}</p>
Revertir a esta revisión