mozilla

Revision 38989 of document.cookie

  • Enlace amigable (slug) de la revisión: DOM/document.cookie
  • Título de la revisión: document.cookie
  • Id de la revisión: 38989
  • Creada:
  • Creador: Ciencia Al Poder
  • ¿Es la revisión actual? No
  • Comentario 201 words added, 2 words removed; page display name changed to 'document.cookie'

Contenido de la revisión

« Referencia DOM de Gecko

{{ Traducción("inglés", "DOM:document.cookie", "en") }}

Resumen

Obtener y definir las cookies asociadas con el documento.

Sintaxis

allCookies = document.cookie;
  • allCookies es una cadena que contiene una lista de cookies separadas por comas (ejemplo: pares key=value)
document.cookie = updatedCookie;
  • updatedCookie es una cadena de forma clave=valor, opcionalmente seguida por los valores de atributos de la cookie, especificando que la cookie se establece/actualiza. Note que sólo puede establecer/actualizar una cookie sola a la vez utilizando este método.
    Se puede especificar cualquiera de los siguientes atributos a la cookie en el momento de establecerla/actualizarla, de forma clave=valor, separada por punto y coma:
    • ;path=ruta (p.e., '/', '/directorio') Si no se especifica, se guardará con.
    • ;domain=domínio (p.e., 'example.com', '.example.com' (incluye todos los subdominios), 'subdomain.example.com') Si no se especifica, se tomará el valor del nombre de host actual del documento.
    • ;max-age=tiempo-máximo-que-se-guardará-en-segundos (p.e., 60*60*24*365 para especificar un año)
    • ;expires=fecha-en-formato-GMTString (Se puede usar Date.toGMTString; está obsoleto) Si no se especifica, será una cookie de sesión, lo que significa que se borrará al finalizar la sesión actual del navegador.
    • ;secure (la cookie solo será transmitida por un protocolo seguro, como https)

 

Ejemplo

document.cookie = "name=oeschger";
document.cookie = "favorite_food=tripe";
alert(document.cookie);
// visualizar: name=oeschger;favorite_food=tripe

Notas

Empezando con Firefox 2, está disponible un mejor mecanismo de almacenamiento cliente-servidor - WHATWG DOM Storage.

Especificación

DOM Level 2: HTMLDocument.cookie Should be more detailed: escaping issues, what "attribute values" are available and what do they do, how to remove a cookie, how to parse the cookies string into something more managable, etc...

{{ languages( { "en": "en/DOM/document.cookie", "pl": "pl/DOM/document.cookie" } ) }}

Fuente de la revisión

<p>
« <a href="es/Referencia_DOM_de_Gecko">Referencia DOM de Gecko</a>
</p><p>{{ Traducción("inglés", "DOM:document.cookie", "en") }}
</p>
<h3 name="Resumen"> Resumen </h3>
<p>Obtener y definir las <code>cookies</code> asociadas con el documento.
</p>
<h3 name="Sintaxis">Sintaxis</h3>
<pre class="eval"><em>allCookies</em> = <em>document</em>.cookie;
</pre>
<ul> <li><code>allCookies</code> es una cadena que contiene una lista de cookies separadas por comas (ejemplo: pares <code><em>key</em>=<em>value</em></code>)</li>
</ul>
<pre class="eval"><em>document</em>.cookie = <em>updatedCookie</em>;
</pre>
<ul> <li><code>updatedCookie</code> es una cadena de forma <code><em>clave</em>=<em>valor</em></code>, opcionalmente seguida por los valores de atributos de la cookie, especificando que la cookie se establece/actualiza. Note que sólo puede establecer/actualizar una cookie sola a la vez utilizando este método.<br> Se puede especificar cualquiera de los siguientes atributos a la cookie en el momento de establecerla/actualizarla, de forma <code><em>clave</em>=<em>valor</em></code>, separada por punto y coma: <ul> <li><code>;path=<em>ruta</em></code> (p.e., '/', '/directorio') Si no se especifica, se guardará con.</li> <li><code>;domain=<em>domínio</em></code> (p.e., 'example.com', '.example.com' (incluye todos los subdominios), 'subdomain.example.com') Si no se especifica, se tomará el valor del nombre de host actual del documento.</li> <li><code>;max-age=<em>tiempo-máximo-que-se-guardará-en-segundos</em></code> (p.e., 60*60*24*365 para especificar un año)</li> <li><code>;expires=<em>fecha-en-formato-GMTString</em></code> (Se puede usar <a href="/en/Core_JavaScript_1.5_Reference/Global_Objects/Date/toGMTString" title="en/Core_JavaScript_1.5_Reference/Global_Objects/Date/toGMTString">Date.toGMTString</a>; está obsoleto) Si no se especifica, será una cookie de sesión, lo que significa que se borrará al finalizar la sesión actual del navegador.</li> <li><code>;secure</code> (la cookie solo será transmitida por un protocolo seguro, como https)</li> </ul> </li>
</ul>
<p> </p><h3 name="Ejemplo"> Ejemplo </h3>
<pre class="eval">document.cookie = "name=oeschger";
document.cookie = "favorite_food=tripe";
alert(document.cookie);
// visualizar: name=oeschger;favorite_food=tripe
</pre>
<h3 name="Notas"> Notas </h3>
<p>Empezando con Firefox 2, está disponible un mejor mecanismo de almacenamiento cliente-servidor - <a href="es/DOM/Storage">WHATWG DOM Storage</a>.
</p>
<h3 name="Especificaci.C3.B3n"> Especificación </h3>
<p><a class="external" href="http://www.w3.org/TR/DOM-Level-2-HTML/html.html#ID-8747038">DOM Level 2: HTMLDocument.cookie</a> <span class="comment">Should be more detailed: escaping issues, what "attribute values" are available and what do they do, how to remove a cookie, how to parse the cookies string into something more managable, etc...</span>
</p>{{ languages( { "en": "en/DOM/document.cookie", "pl": "pl/DOM/document.cookie" } ) }}
Revertir a esta revisión