Revision 386049 of FormData

  • Enlace amigable (slug) de la revisión: XMLHttpRequest/FormData
  • Título de la revisión: FormData
  • Id de la revisión: 386049
  • Creada:
  • Creador: marco_mucino
  • ¿Es la revisión actual? No
  • Comentario There wasn't an Spanish traduction.

Contenido de la revisión

El Nivel 2 de XMLHttpRequest añade soporte para la nueva interfase  FormData. Los objetos FormData proporcionan una forma para construir fácilmente un conjunto de pares llave/valor que representan campos de forma y sus valores, los cuales pueden enviarse fácilmente utilizando el método send() del Objeto XMLHttpRequest.

Utiliza el mismo formato que una forma debería utilizar si el tipo de codificación fuera establecido a "multipart/form-data".

Para detalles en cómo utilizar el objeto FormData, vea Utilizando objetos FormData.

Constructor

new FormData (HTMLFormElement forma opcional)

Parámetros

forma
 {{optional_inline()}} Elemento Forma en HTML {{HTMLElement("form")}} para enviar pares llaves/valores. También codificará el contenido del archivo de entrada.

Métodos

append()

Añade una pareja llave/valor al objeto FormData.

void append(DOMString nombre, Blob valor, opcional DOMString nombre_archivo);
void append(DOMString nombree, DOMString valor);
Parámetros
nombre
El nombre del campo cuya información está contendia en valor.
valor
El valor del campo. Puede ser un {{ domxref("Blob") }}, {{ domxref("File") }}, o una cadena, si no es ninguno, el valor se convierte a cadena.
nombre_archivo
{{optional_inline()}} El nombre del archivo reportado al servidor, cuando un {{ domxref("Blob") }} o {{ domxref("File") }} es pasado como segundo parámetro. El nombre del archivo por defecto para objetos {{domxref("Blob")}} es "blob".

Nota: Si especifica un {{ domxref("Blob") }} como los datos para añadir al objeto FormData, el nombre del archivot que será reportado al servidor en el encabezado "Content-Disposition" usualmente variará de un navegador a otro.

Compatibilidad con Navegadores

{{ CompatibilityTable() }}

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari
Soporte Básico 7+ {{ CompatGeckoDesktop("2.0") }} 10+ 12+ 5+
Añadir con nombre de archivo {{CompatVersionUnknown}} {{ CompatGeckoDesktop("22.0") }} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Soporte Básico 3.0 {{ CompatUnknown() }} {{ CompatGeckoMobile("2.0") }} {{ CompatUnknown() }}

12+

{{ CompatUnknown() }}
Añadir con nombre de archivo {{CompatUnknown}} {{ CompatUnknown() }} {{ CompatGeckoDesktop("22.0") }} {{CompatUnknown}} {{CompatUnknown}} {{CompatUnknown}}

Notas para Gecko

En versiones anteriores a Gecko 7.0 {{ geckoRelease("7.0") }}, si especifica un {{ domxref("Blob") }} como los datos a agregar al objeto, el nombre del archivo reportado en el encabezado HTTP "Content-Disposition" era una cadena vacía; esto resultó en errores reportados por algunos servidores. A partir de Gecko 7.0, se envía "blob" como nombre del archivo.

Especificación

Vea también

Fuente de la revisión

<p>El Nivel 2 de XMLHttpRequest añade soporte para la nueva interfase &nbsp;<code>FormData</code>. Los objetos&nbsp;<code>FormData</code>&nbsp;proporcionan una forma para construir fácilmente un conjunto de pares llave/valor que representan campos de forma y sus valores, los cuales pueden enviarse fácilmente utilizando el método&nbsp;<code style="line-height: inherit; font-size: 14px;"><a href="/en/DOM/XMLHttpRequest#send()" style="line-height: inherit;" title="en/XMLHttpRequest#send()">send()</a>&nbsp;</code>del Objeto XM<span style="line-height: inherit;">LHttpRequest</span><span style="line-height: inherit;">.</span></p>
<p>Utiliza el mismo formato que una forma debería utilizar si el tipo de codificación fuera establecido a "multipart/form-data".</p>
<p>Para detalles en cómo utilizar el objeto&nbsp;<code>FormData</code>, vea&nbsp;<a href="/en/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="en/DOM/XMLHttpRequest/FormData/Using_FormData_objects">Utilizando objetos FormData</a>.</p>
<h2 id="Syntax" name="Syntax">Constructor</h2>
<pre class="syntaxbox">
<code>new FormData (</code><code>HTMLFormElement forma opcional</code><code>)</code></pre>
<h3 id="Parameters" name="Parameters">Parámetros</h3>
<dl>
  <dt>
    <code>forma</code></dt>
  <dd>
    &nbsp;{{optional_inline()}} Elemento Forma en HTML {{HTMLElement("form")}} para enviar pares llaves/valores. También codificará el contenido del archivo de entrada.</dd>
</dl>
<h2 id="Methods">Métodos</h2>
<h3 id="append()">append()</h3>
<p>Añade una pareja llave/valor al objeto&nbsp;<code>FormData</code>.</p>
<pre>
void <a href="/en/DOM/XMLHttpRequest/FormData#append()" title="en/DOM/XMLHttpRequest/FormData#append()">append</a>(DOMString nombre, Blob valor, opcional DOMString nombre_archivo);
void <a href="/en/DOM/XMLHttpRequest/FormData#append()" title="en/DOM/XMLHttpRequest/FormData#append()">append</a>(DOMString nombree, DOMString valor);</pre>
<h6 id="Parameters">Parámetros</h6>
<dl>
  <dt>
    <code>nombre</code></dt>
  <dd>
    El nombre del campo cuya información está contendia en&nbsp;<code>valor</code>.</dd>
  <dt>
    <code>valor</code></dt>
  <dd>
    El valor del campo. Puede ser un {{ domxref("Blob") }}, {{ domxref("File") }}, o una cadena, si no es ninguno, el valor se convierte a cadena.</dd>
  <dt>
    <code>nombre_archivo</code></dt>
  <dd>
    {{optional_inline()}} El nombre del archivo reportado al servidor, cuando un {{ domxref("Blob") }} o {{ domxref("File") }} es pasado como segundo parámetro. El nombre del archivo por defecto para objetos {{domxref("Blob")}} es "blob".</dd>
</dl>
<div class="note">
  <p><strong>Nota:</strong>&nbsp;Si especifica un {{ domxref("Blob") }} como los datos para añadir al objeto&nbsp;<code>FormData</code>, el nombre del archivot que será reportado al servidor en el encabezado "Content-Disposition" usualmente variará de un navegador a otro.</p>
</div>
<h2 id="Browser_compatibility">Compatibilidad con Navegadores</h2>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Característica</th>
        <th>Chrome</th>
        <th>Firefox (Gecko)</th>
        <th>Internet Explorer</th>
        <th>Opera</th>
        <th>Safari</th>
      </tr>
      <tr>
        <td>Soporte Básico</td>
        <td>7+</td>
        <td>{{ CompatGeckoDesktop("2.0") }}</td>
        <td>10+</td>
        <td>12+</td>
        <td>5+</td>
      </tr>
      <tr>
        <td>Añadir con nombre de archivo</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{ CompatGeckoDesktop("22.0") }}</td>
        <td>{{CompatUnknown}}</td>
        <td>{{CompatUnknown}}</td>
        <td>{{CompatUnknown}}</td>
      </tr>
    </tbody>
  </table>
</div>
<div id="compat-mobile">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Feature</th>
        <th>Android</th>
        <th>Chrome for Android</th>
        <th>Firefox Mobile (Gecko)</th>
        <th>IE Mobile</th>
        <th>Opera Mobile</th>
        <th>Safari Mobile</th>
      </tr>
      <tr>
        <td>Soporte Básico</td>
        <td>3.0</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatGeckoMobile("2.0") }}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>
          <p>12+</p>
        </td>
        <td>{{ CompatUnknown() }}</td>
      </tr>
      <tr>
        <td>Añadir con nombre de archivo</td>
        <td>{{CompatUnknown}}</td>
        <td>{{ CompatUnknown() }}</td>
        <td>{{ CompatGeckoDesktop("22.0") }}</td>
        <td>{{CompatUnknown}}</td>
        <td>{{CompatUnknown}}</td>
        <td>{{CompatUnknown}}</td>
      </tr>
    </tbody>
  </table>
</div>
<h3 id="Gecko_notes">Notas para Gecko</h3>
<p>En versiones anteriores a Gecko 7.0 {{ geckoRelease("7.0") }}, si especifica un {{ domxref("Blob") }} como los datos a agregar al objeto, el nombre del archivo reportado en el encabezado HTTP "Content-Disposition"&nbsp;era una cadena vacía; esto resultó en errores reportados por algunos servidores. A partir de Gecko 7.0, se envía "blob" como nombre del archivo.</p>
<h2 id="Specification" name="Specification">Especificación</h2>
<ul>
  <li><a class="external" href="http://www.w3.org/TR/XMLHttpRequest2/#interface-formdata" title="http://www.w3.org/TR/XMLHttpRequest2/#interface-formdata">W3C Specification</a></li>
  <li><a href="http://xhr.spec.whatwg.org/#interface-formdata" title="http://xhr.spec.whatwg.org/#interface-formdata">WHATWG Specification</a></li>
</ul>
<h2 id="See_also">Vea también</h2>
<ul>
  <li>{{domxref("XMLHTTPRequest")}}</li>
  <li><a href="/en/DOM/XMLHttpRequest/Using_XMLHttpRequest" title="En/Using XMLHttpRequest">Utilización de XMLHttpRequest</a></li>
  <li><a href="/en/DOM/XMLHttpRequest/FormData/Using_FormData_Objects" title="en/DOM/XMLHttpRequest/FormData/Using_FormData_objects">Utilización de objetos FormData</a></li>
  <li>{{HTMLElement("Form")}}</li>
</ul>
Revertir a esta revisión