# cookies.dkl `cookies.dkl` (dkl-web) simplifica leer las cookies de la petición y enviar cookies en la respuesta. ```dkl #include "functions.dkh" #include "cookies.dkl" ``` Necesita `@http_context`, así que se usa en programas web (o en consola, simulando el contexto como en el ejemplo de abajo). ## Funciones | Función | Devuelve | Qué hace | |---|---|---| | `cookie.get(n)` | cadena | Valor de la cookie `n`; `""` si no existe | | `cookie.dget(n, d)` | cadena | Valor de la cookie `n`; `d` si no existe | | `cookie.set(n, v)` | 0 | Envía la cookie `n` con valor `v`, válida para todo el sitio (`Path=/`) y por un año (`Max-Age=31104000`) | | `cookie.setw(n, v)` | 0 | Envía la cookie `n` con el texto `v` tal cual; agregue sus propios atributos separados por `;` (`Path`, `Max-Age`, `Expires`, `HttpOnly`, `Secure`, `SameSite`) | Las cookies que envía se guardan en `@http_context/response/cookies` y el servidor las convierte en encabezados `Set-Cookie`. Una cookie que usted establece en la petición en curso se puede leer de inmediato con `cookie.get`, **pero el valor que devuelve incluye los atributos** (`2026-10-27;Path=/;Max-Age=31104000`), porque se guarda el texto completo. Para borrar una cookie, envíela vacía: `do cookie.set("__induxsoft_token", "")`. ## Ejemplo ```dkl #include "dkli.dkh" #! program "prueba-cookies" { #include "functions.dkh" #include "serialize.dkh" // En consola no hay petición: se simula el contexto que arma el servidor FastCGI ref @http_context = from.json('{"request":{"cookies":{"tema":"oscuro"}},"response":{"headers":{}}}') #include "cookies.dkl" do print("tema: " + cookie.get("tema")) do print("idioma: '" + cookie.get("idioma") + "'") do print("idioma (predeterminado): " + cookie.dget("idioma","es-MX")) do cookie.set("ultima_visita","2026-10-27") do cookie.setw("aviso","1;Path=/avisos;Max-Age=600;HttpOnly") do print("leída después de establecerla: " + cookie.get("ultima_visita")) do print(to.json(@@(@http_context,"&response/cookies"))) } ``` Salida real: ```text tema: oscuro idioma: '' idioma (predeterminado): es-MX leída después de establecerla: 2026-10-27;Path=/;Max-Age=31104000 {"tema":"oscuro","ultima_visita":"2026-10-27;Path=/;Max-Age=31104000","aviso":"1;Path=/avisos;Max-Age=600;HttpOnly"} ``` Detrás de nginx, el inicio de sesión de la guía [Inicio de sesión y permisos](/es/devkron/2.0/guias/inicio-de-sesion.md) responde: ```text HTTP/1.1 302 Moved Temporarily Location: /privado/ Set-Cookie: __induxsoft_token=04742c8cfeab42beb1a9bb8c6944381a;Path=/;Max-Age=31104000 ``` Observe en el JSON que `response/cookies` contiene también `tema`: la biblioteca agrega a su registro las cookies que lee, y ese registro es el que se envía en cuanto usted establece alguna cookie. Comprobado detrás de nginx: una petición con `Cookie: tema=oscuro` que lee `tema` y establece `visto` responde ```text Set-Cookie: tema=oscuro Set-Cookie: visto=1;Path=/;Max-Age=31104000 ``` Es decir, las cookies leídas se reenvían **sin atributos** (sin `Path` ni `Max-Age`), lo que el navegador trata como una cookie de sesión para la ruta actual. Si solo lee cookies y no establece ninguna, no se envía nada. Si ese reenvío le estorba, use la biblioteca estándar nueva [http.dkh](/es/devkron/2.0/bibliotecas/estandar/http.md) (`httpreq.cookie` para leer, `httpres.cookie` para escribir), que no tiene ese efecto. ## Errores típicos | Síntoma | Causa y solución | |---|---| | `Variable global '@http_context' no definida` | Se incluyó `cookies.dkl` en consola sin simular el contexto, o antes de crearlo | | La cookie no llega al navegador | Se estableció en un programa que luego cambió `response/cookies` a mano, o el navegador la rechaza por `Secure` en HTTP | | El valor leído trae `;Path=/...` | Es una cookie que usted estableció en la misma petición: guarde el valor en una variable en lugar de releerlo | | Un programa que se llama `cookies.dkl` se queda colgado | Si su programa se llama igual que la biblioteca y está en la misma carpeta, `#include "cookies.dkl"` se incluye a sí mismo. Póngale otro nombre |