Comparar revisiones

XMLHttpRequest

Revisión 94154:

Revisión 94154 de deimidis el

Revisión 287964:

Revisión 287964 de deimidis el

Título:
XMLHttpRequest
XMLHttpRequest
Enlace amigable (slug):
XMLHttpRequest
XMLHttpRequest
Etiquetas:
AJAX, XMLHttpRequest, Todas_las_Categorías, páginas_a_traducir
AJAX, XMLHttpRequest, Todas_las_Categorías, páginas_a_traducir
Contenido:

Revisión 94154
Revisión 287964
n8      <code>XMLHttpRequest</code> is a <a class="internal" href="n8      <code>XMLHttpRequest</code> es un objeto <a class="internal
>/en/JavaScript" title="En/JavaScript">JavaScript</a> object that >" href="/en/JavaScript" title="En/JavaScript">JavaScript</a> que 
>was designed by Microsoft, adopted by Mozilla, and is now being <>fue diseñado por Microsoft, adoptado por Mozilla, y actualmente e
>a class="external" href="http://www.w3.org/TR/XMLHttpRequest/" ti>s un <a class="external" href="http://www.w3.org/TR/XMLHttpReques
>tle="http://www.w3.org/TR/XMLHttpRequest/">standardized in the W3>t/" title="http://www.w3.org/TR/XMLHttpRequest/">estandar de la W
>C</a>. It provides an easy way to retrieve data at a URL. Despite>3C</a>. Proporciona una forma fácil para recaudar información de 
> its name, <code>XMLHttpRequest</code> can be used to retrieve an>una URL. A pesar de su nombre, <code>XMLHttpRequest</code> puede 
>y type of data, not just XML, and it supports protocols other tha>ser usado para recibir cualquier tipo de dato, no solo XML, y adm
>n <a href="/en/HTTP" title="en/HTTP">HTTP</a> (including <code>fi>ite otros formatos además de <a href="/en/HTTP" title="en/HTTP">H
>le</code> and <code>ftp</code>).>TTP</a> (incluyendo <code>file</code> y <code>ftp</code>).
9    </p>
10    <p>9    </p>
11      To create an instance of <code>XMLHttpRequest</code>, simpl10    <p>
>y do this: 
11      Para crear una instancia de <code>XMLHttpRequest</code>, de
 >bes hacer lo siguiente:
n17      For details about how to use <code>XMLHttpRequest</code>, sn17      Para obtener más nformación de cómo usar <code>XMLHttpReque
>ee <a class="internal" href="/En/XMLHttpRequest/Using_XMLHttpRequ>st</code>, mira <a class="internal" href="/Es/XMLHttpRequest/Usar
>est" title="En/Using XMLHttpRequest">Using XMLHttpRequest</a>.>_XMLHttpRequest" title="En/Using XMLHttpRequest">Usar XMLHttpRequ
 >est</a>.
n20      <strong>Note:</strong> By default, Firefox 3 limits the numn20      <strong>Nota:</strong> De forma predeterminada, Firefox 3 l
>ber of <code>XMLHttpRequest</code> connections per server to 6 (p>imita la cantidad de conexiones de <code>XMLHttpRequest</code> po
>revious versions limit this to 2 per server). Some interactive we>r servidor a 6 (las versiones previas limitan a 2 conexiones por 
>b sites may keep an <code>XMLHttpRequest</code> connection open, >servidor). Algunos sitios web interactivos pueden mantener una co
>so opening multiple sessions to such sites may result in the brow>nexión <code>XMLHttpRequest</code> abierta, así que abrir múltipl
>ser hanging in such a way that the window no longer repaints and >es sesiones a esos sitios puede resultar en congelamientos del na
>controls don't respond. This value can be changed by editing the >vegador de ua forma que la ventana no se actualiza y los controle
><code>network.http.max-persistent-connections-per-server</code> p>s no responden. Este valor puede ser cambiado al editar la prefer
>reference in <code><a class="linkification-ext" href="/about:conf>encia <code>network.http.max-persistent-connections-per-server</c
>ig" title="Linkification: about:config">about:config</a></code>.>ode> en <code><a class="linkification-ext" href="/about:config" t
 >itle="Linkification: about:config">about:config</a></code>.
n22    <h2>n22    <h2 id="Resumen_del_m.C3.A9todo">
23      Method overview23      Resumen del método
n69            <code>void <a class="internal" href="/en/XMLHttpRequen69            <code>void <a class="internal" href="/en/XMLHttpReque
>st#sendAsBinary()" title="/en/XMLHttpRequest#sendAsBinary()">send>st#sendAsBinary()" title="/en/XMLHttpRequest#sendAsBinary()">send
>AsBinary</a>(in DOMString body); {{ fx_minversion_inline("3") }}<>AsBinary</a>(in DOMString body); {{ fx_minversion_inline(3) }}<br
>br></code>>></code>
n79    <h2>n79    <h2 id="Propiedades">
80      Properties80      Propiedades
n86            Attributen86            Atributo
n89            Typen89            Tipo
n92            Descriptionn92            Descripción
n103            The channel used by the object when performing the ren103            El canal es usado por el objeto cuando se produce el 
>quest. This is <code>null</code> if the channel hasn't been creat>pedido. Esto da <code>null</code> si el canal aún no fue creado. 
>ed yet. In the case of a multi-part request, this is the initial >En el caso de un pedido de múltiples partes, este es el canal ini
>channel, not the different parts in the multi-part request. <stro>cial, no las diferentes partes del pedido múltiple. <strong>Es ne
>ng>Requires elevated privileges to access; read-only.</strong> {{>cesario tener privilegios elevados para acceder; solo lectura.</s
> Non-standard_inline() }}>trong> {{ Non-standard_inline() }}
n111            <code>boolean</code>n111            <code>booleano</code>
112          </td>
113          <td>112          </td>
114            <p>113          <td>
115              Indicates whether or not the object represents a ba
>ckground service request. If <code>true</code>, no load group is  
>associated with the request, and security dialogs are prevented f 
>rom being shown to the user. <strong>Requires elevated privileges 
> to access.</strong> {{ Non-standard_inline() }} 
116            </p>114            <p>
115              Indica si el objeto representa o no un pedido de un
 > servicio de fondo. Si es <code>true</code>, no se asocia una car
 >ga de grupo con el pedido, y los diálogos de seguridad no se mues
 >tran al usuario. <strong>Es necesario tener privilegios elevados 
 >para acceder.</strong> {{ Non-standard_inline() }}
117            <p>116            </p>
118              In cases in which a security dialog (such as authen117            <p>
>tication or a bad certificate notification) would normally be sho 
>wn, the request simply fails instead. 
118              En los casos en que un diálogo de seguridad debe se
 >r mostrado (como en una autentficación o la notificación de un ce
 >rtificado no válido), el pedido simplemente falla.
n130            The response to the request, as a JavaScript typed arn130            La respuesta al pedido en la forma de un arreglo de J
>ray. This is NULL&nbsp;if the request was not successful, or if i>avaScript. Esto es NULL&nbsp;si el pedido no fue exitoso o si tod
>t hasn't been sent yet. <strong>Read only.</strong>>avía no ha sido enviado. <strong>Solo lectura.</strong>
n138            <code>boolean</code>n138            <code>booleano</code>
139          </td>
140          <td>139          </td>
141            <p>140          <td>
142              Indicates whether or not the response is expected t
>o be a stream of possibly multiple XML documents. If set to <code 
>>true</code>, the content type of the initial response must be <c 
>ode>multipart/x-mixed-replace</code> or an error will occur. All  
>requests must be asynchronous. 
143            </p>141            <p>
142              Indica cuando se espera que la respuesta sea o no u
 >na serie de mútiples documentos XML. Si se define como <code>true
 ></code>, el tipo de contenido de la respuesta inicial debe ser <c
 >ode>multipart/x-mixed-replace</code> u ocurrirá un error. Todos l
 >os pedidos deben ser asincrónicos.
144            <p>143            </p>
145              This enables support for server push; for each XMLd144            <p>
>ocument that's written to this request, a new XMLDOMdocument is c 
>reated and the <code>onload</code> handler is called between docu 
>ments. 
145              Esto permite el uso del push del servidor; para cad
 >a documento XML que se escribe para este pedido, se crea un nuevo
 > XMLDOMdocument y se llama al manejador <code>onload</code> entre
 > cada documento.
n148              <strong>Note:</strong> When this is set, the <code>n148              <strong>Nota:</strong> Cuando esto se elige, el man
>onload</code> handler and other event handlers are not reset afte>ejador <code>onload</code> y otros manejadores de eventos no son 
>r the first XMLdocument is loaded, and the <code>onload</code> ha>reiniciados después de que el primer XMLdocument es cargado, y el
>ndler is called after each part of the response is received.> manejador <code>onload</code> es llamado después de que cada par
 >te de la respuesta es recibida.
n163              A JavaScript function object that is called wheneven163              Una función del objeto JavaScript que se llama cuan
>r the <code>readyState</code> attribute changes. The callback is >do el atributo <code>readyState</code> cambia. El callback se lla
>called from the user interface thread.>ma desde la interfaz del usuario.
n166              <strong>Warning:</strong> This must not be used fron166              <strong>Aviso:</strong> Esto no debe ser usado desd
>m native code. You should also not use this with synchronous requ>e código nativo. Tampoco debes usarlo con peidos sincrónicos.
>ests. 
n179              The state of the request:n179              El estado del pedido:
n185                    Valuen185                    Valor
n188                    Staten188                    Estado
n191                    Descriptionn191                    Descripción
n202                    <code>open()</code>has not been called yet.n202                    todavía no se llamó a <code>open()</code>.
n213                    <code>send()</code>has not been called yet.n213                    todavía no se llamó a <code>send()</code>.
n224                    <code>send()</code> has been called, and headn224                    <code>send()</code> ya fue invocado, y los en
>ers and status are available.>cabezados y el estado están disponibles.
n235                    Downloading; <code>responseText</code> holds n235                    Doescargando; <code>responseText</code> conti
>partial data.>ene información parcial.
n246                    The operation is complete.n246                    La operación está terminada.
n261            The response to the request as text, or <code>null</cn261            La respuesta al pedido como texto, o <code>null</code
>ode> if the request was unsucessful or has not yet been sent. <st>> si el pedido no fue exitoso o todavía no se envió. <strong>Solo
>rong>Read-only.</strong>> lectura.</strong>
n273              The response to the request as a DOM<code><a class=n273              La respuesta al pedido como un objeto DOM<code><a c
>"internal" href="/en/DOM/document" title="En/DOM/Document">Docume>lass="internal" href="/en/DOM/document" title="En/DOM/Document">D
>nt</a></code> object, or <code>null</code> if the request was uns>ocument</a></code>, o <code>null</code> si el pedido no fue exito
>uccessful, has not yet been sent, or cannot be parsed as XML. The>so, aún no fue enviado o no puede ser analizado como XML. La resp
> response is parsed as if it were a <code>text/xml</code> stream.>uesta es analizada como si fuera <code>text/xml</code>. <strong>S
> <strong>Read-only.</strong>>olo lectura.</strong>
n276              <strong>Note:</strong> If the server doesn't apply n276              <strong>Note:</strong> Si el servidor no aplica el 
>the <code>text/xml</code> Content-Type header, you can use <code>>encabezado de tipo de contenido <code>text/xml</code>, puedes usa
>overrideMimeType()</code>to force <code>XMLHttpRequest</code> to >r <code>overrideMimeType()</code> para forzar a <code>XMLHttpRequ
>parse it as XML anyway.>est</code> a analizarlo como XML igualmente.
n288            The status of the response to the request. This is thn288            El estado de la respuesta al pedido. Este es el códig
>e HTTPresult code (for example, <code>status</code> is 200 for a >o HTTPresult (por ejemplo, <code>status</code> es 200 por un pedi
>successful request). <strong>Read-only.</strong>>do exitoso). <strong>Solo lectura.</strong>
n299            The response string returned by the HTTPserver. Unlikn299            La cadena de respuesta que devuelve el HTTPserver. A 
>e <code>status</code>, this includes the entire text of the respo>diferencia de <code>status</code>, este incluye el texto completo
>nse message ("<code>200 OK</code>", for example). <strong>Read-on> del mensaje de respuesta ("<code>200 OK</code>", por ejemplo). <
>ly.</strong>>strong>Solo lectura.</strong>
n310            The upload process can be tracked by adding an event n310            El proceso de subida puede ser rastreado al agregar u
>listener to <code>upload</code>. {{ fx_minversion_inline("3") }}>n registro de evento a <code>upload</code>. {{ fx_minversion_inli
 >ne(3.5) }}
n318            <code>boolean</code>n318            <code>booleano</code>
319          </td>
320          <td>319          </td>
321            <p>320          <td>
322              Indicates whether or not cross-site Access-Control 321            <p>
>requests should be made using credentials such as cookies or auth 
>orization headers. {{ fx_minversion_inline("3") }} 
322              Indica cuando el pedido de Access-Control entre sit
 >ios debe o no ser realizado usando credenciales como cookies o en
 >cabezados de autorización. {{ fx_minversion_inline(3.5) }}
n325              <strong>Note:</strong> This never affects same-siten325              <strong>Nota:</strong> Esto nunca afecta los pedido
> requests.>s en para el propio sitio.
n328              The default is <code>false</code>.n328              El valor predeterminado es <code>false</code>.
n334    <h2>n334    <h2 id="M.C3.A9todos">
335      Methods335      Métodos
n337    <h3>n337    <h3 id="abort()">
n341      Aborts the request if it has already been sent.n341      Aborta el pedido si este ya fue enviado.
nn346    <h6 id="Par.C3.A1metros">
347      Parámetros
346    <h6>348    </h6>
347      Parameters
348    </h6>
349    <p>
350      None.
351    </p>349    <p>
350      Ninguno.
352    <h3>351    </p>
352    <h3 id="getAllResponseHeaders()">
n356      Returns all the response headers as a string.n356      Devuelve todos los encabezados de respuesta como una cadena
 >.
n359      <strong>Note:</strong> For multipart requests, this returnsn359      <strong>Nota:</strong> Para pedidos multi partes, esto devu
> the headers from the <em>current</em> part of the request, not f>elve los encabezados de la parte <em>actual</em> del pedido, no d
>rom the original channel.>el canal original.
nn364    <h6 id="Par.C3.A1metros">
365      Parámetros
364    <h6>366    </h6>
365      Parameters
366    </h6>
367    <p>
368      None.
369    </p>367    <p>
368      Ninguno.
369    </p>
370    <h6 id="Valor_devuelto">
371      Valor devuelto
370    <h6>372    </h6>
371      Return value
372    </h6>
373    <p>
374      The text of all response headers, or <code>null</code> if n
>o response has been received. 
375    </p>373    <p>
374      El texto de todos los encabezados de respuesta, o <code>nul
 >l</code> si no se ha recibido ninguna respuesta.
376    <h3>375    </p>
376    <h3 id="getResponseHeader()">
n380      Returns the text of a specified header.n380      Devuelve el texto de un encabezado específico.
n387    <h6>n387    <h6 id="Par.C3.A1metros">
388      Parameters388      Parámetros
n395        The name of the header to retrieve.n395        El nombre del encabezado buscado.
nn398    <h6 id="Valor_devuelto">
399      Valor devuelto
398    <h6>400    </h6>
399      Return value
400    </h6>
401    <p>
402      A string containing the text of the specified header, or <c
>ode>null</code> if either the response has not yet been received  
>or the header doesn't exist in the response. 
403    </p>401    <p>
402      Una cadena que contiene el texto de un encabezado específic
 >o, o <code>null</code> tanto si la respuesta no se ha recibido o 
 >el encabezado no existe en la respuesta.
404    <h3>403    </p>
404    <h3 id="init()">
n408      Initializes the object for use from C++code.n408      Inicializa el objeto para que sea usado desde código C++.
n411      <strong>Warning:</strong> This method must <em>not</em> be n411      <strong>Aviso:</strong> Este método <em>no</em> debe ser ll
>called from JavaScript.>amado desde JavaScript.
n420    <h6>n420    <h6 id="Par.C3.A1metros">
421      Parameters421      Parámetros
n428        The principal to use for the request; must not be <code>nn428        El principal para usar en el pedido; no debe ser <code>nu
>ull</code>.>ll</code>.
n434        The script context to use for the request; must not be <cn434        El contexto del programa que usará en el pedido; no debe 
>ode>null</code>.>ser <code>null</code>.
n440        The window associated with the request; may be <code>nulln440        La ventana asociada con el pedido; puede ser <code>null</
></code>.>code>.
n443    <h3>n443    <h3 id="open()">
n447      Initializes a request. This method is to be used from JavaSn447      Inicializa el pedido. Este método es para ser usado desde c
>cript code; to initialize a request from native code, use <a clas>ódigo JavaScript, para inicializar un pedido desde código nativo,
>s="internal" href="/en/XMLHttpRequest#openRequest()" title="/en/X> debes usar <a class="internal" href="/en/XMLHttpRequest#openRequ
>MLHttpRequest#openRequest()"><code>openRequest()</code></a>instea>est()" title="/en/XMLHttpRequest#openRequest()"><code>openRequest
>d.>()</code></a>.
n450      <strong>Note:</strong> Calling this method an already activn450      <strong>Nota:</strong> Llamar a este método en un pedido ac
>e request (one for which <code>open()</code>or <code>openRequest(>tivo (uno para el cual <code>open()</code> o <code>openRequest()<
>)</code>has already been called)is the equivalent of calling <cod>/code> ya han sido llamados) es equivalente a usar <code>abort()<
>e>abort()</code>.>/code>.
n461    <h6>n461    <h6 id="Par.C3.A1metros">
462      Parameters462      Parámetros
n469        The HTTPmethod to use; either "POST"or "GET". Ignored forn469        El método HTTP a usar: tanto "POST" o "GET". Se ignora pa
> non-HTTPURLs.>ra urls que no son de HTTP.
n475        The URLto which to send the request.n475        La URL a la que se envía el pedido.
n496    <h3>n496    <h3 id="openRequest()">
n514    <h6>n514    <h6 id="Parameters">
n549    <h3>n549    <h3 id="overrideMimeType()">
n563    <h6>n563    <h6 id="Parameters">
n574    <h3>n574    <h3 id="send()">
n588    <h6>n588    <h6 id="Parameters">
n599    <h6>n599    <h6 id="Notes">
n619    <h6>n619    <h6 id="Parameters">
n630    <h3>n630    <h3 id="setRequestHeader()">
n645    <h6>n645    <h6 id="Parameters">
n662    <h2>n662    <h2 id="Implementation_notes">
t668    <h2>t668    <h2 id="See_also">

Volver al historial