consentimiento de cookies para SvelteKit
cookiecrumbsHandle inserta la etiqueta como primer elemento del head de cada respuesta HTML y establece event.locals.consent para tus funciones load.
la norma
Una app SvelteKit carga sus rastreadores desde +layout.svelte en el cliente. Sin paso de consentimiento, sin registro.
La norma es la misma en toda la UE y en el Reino Unido: nada más allá de lo estrictamente necesario puede almacenarse en el dispositivo de un visitante ni leerse de él antes de que haya dado su consentimiento. Es el artículo 5(3) de la Directiva ePrivacy, y ese consentimiento debe cumplir la definición del RGPD: libre, específico, informado e inequívoco, con un rechazo tan fácil como la aceptación. El Reino Unido mantiene la misma norma en PECR, con exenciones limitadas para estadísticas de bajo riesgo desde el 5 de febrero de 2026. California y las demás leyes estatales de EE. UU. funcionan al revés: sin opt-in, pero con un enlace de opt-out y soporte para la señal Global Privacy Control.
De ahí se derivan tres cosas para un sitio web. Los scripts de analítica, publicidad y redes sociales tienen que esperar una decisión. La decisión tiene que registrarse de forma que puedas demostrarla después, porque el artículo 7(1) pone la carga de la prueba sobre ti. Y retirar el consentimiento tiene que ser tan fácil como darlo, lo que exige un control que vuelva a abrir el banner en cada página. Un banner que muestra dos botones y carga Google Analytics de todos modos suspende la primera prueba, y ese es justo el fallo que las autoridades están sancionando, desde las decisiones de la CNIL contra Google y SHEIN hasta las inspecciones de las autoridades neerlandesa y belga.
cómo funciona
SvelteKit renderiza HTML a través de hooks.server.ts, y ese es el lugar más limpio para un runtime de consentimiento: un handle que transforma cada respuesta HTML y escribe la etiqueta primero en el head, haga lo que haga la página o el layout. Compónlo con tus otros hooks mediante sequence(); pon %cookiecrumbs.head% en app.html si quieres elegir la posición exacta tú mismo.
El mismo hook establece event.locals.consent, así que una función load de +page.server.ts puede decidir en el servidor si incluir un embed o su marcador. En el cliente, los stores de consentimiento mantienen cada componente al día: $consent para las categorías, $regime para la regla aplicable y acciones para abrir, aceptar, rechazar o retirar.
El onMount de SvelteKit es donde suelen arrancar los rastreadores. Envuelve el subárbol en ConsentGate, o comprueba el store antes de inicializar. Todo lo que el escaneo encuentra en el dominio desplegado sin etiquetar lo gestiona el mapa de bloqueo, así que un script olvidado en un layout antiguo también espera.
configuración
Cinco pasos. La CLI hace la mayoría, y cada uno es también un clic en el panel.
Detecta SvelteKit, vincula el sitio, escribe la configuración.
npx cookiecrumbs login
npx cookiecrumbs initCompónlo con tus otros hooks mediante sequence(). Pon %cookiecrumbs.head% en src/app.html para elegir la posición exacta tú mismo.
npm i @cookiecrumbs/sveltekit
// src/hooks.server.ts
import { cookiecrumbsHandle } from '@cookiecrumbs/sveltekit/server';
export const handle = cookiecrumbsHandle({ site: 'pk_live_…', env: 'production' });Los componentes Svelte ConsentGate, CookieDeclaration y ManageCookiesLink y los stores de consentimiento vienen con el paquete.
<script>
import { ConsentGate } from '@cookiecrumbs/sveltekit';
</script>
<ConsentGate category="marketing">
<MetaPixel />
</ConsentGate>Una función load puede leer el consentimiento y omitir un embed para los visitantes que dijeron no, antes de que se ejecute cualquier código cliente.
// +page.server.ts
export const load = ({ locals }) => ({
showMap: locals.consent?.isGranted('marketing') ?? false,
});Escanea, clasifica una vez por proveedor, publica.
npx cookiecrumbs scan --wait
npx cookiecrumbs push --env productionLas apps SvelteKit con Google Ads suelen añadir gtag en app.html. Debajo del runtime, carga con valores por defecto «denied» y se actualiza en cuanto alguien elige.
Google Consent Mode v2 es la capa de señales entre el banner y las etiquetas de Google. Antes de que se ejecute cualquier etiqueta, siete señales (ad_storage, analytics_storage, ad_user_data, ad_personalization, functionality_storage, personalization_storage, security_storage) se fijan en «denied» para los visitantes del EEE, el Reino Unido y Suiza. En cuanto alguien elige, el runtime las actualiza y las etiquetas de Google se ajustan. Desde el 15 de junio de 2026 Google usa ad_storage como señal determinante para los datos de Ads, así que acertar con el valor por defecto importa más que antes.
CookieCrumbs fija los valores por defecto de forma síncrona, antes que cualquier gestor de etiquetas, los actualiza con cada decisión e incluye una plantilla de Google Tag Manager para que los activadores de consentimiento existan sin listeners escritos a mano. En modo avanzado, los pings sin cookies de Google mantienen las conversiones modeladas para los visitantes que dijeron que no. Lo que no hace es fingir ser una CMP certificada por Google: para AdSense, Ad Manager o AdMob en el EEE sigues necesitando una con IAB TCF, y CookieCrumbs hoy no lo es.
ojo
Cada uno aparece en el primer escaneo como un rastreador que se disparó antes del consentimiento.
antes de publicar
Ocho líneas. El panel marca las dos últimas con datos reales.
type="text/plain" con una categoría, o bien el host está en el mapa de bloqueo del escaneo.lo que obtienes
Dos dominios, 100 subpáginas escaneadas al mes por dominio, todas las normativas, la CLI, los SDK y el servidor MCP.
Cada página, en cada estado de consentimiento, en un navegador real. Cookies, píxeles, iframes y claves de almacenamiento, con la página y el script que los pusieron. Se vuelve a escanear según un calendario.
La declaración de cookies se escribe sola a partir del resultado.
Las etiquetas permanecen inactivas hasta que se concede su categoría. «Rechazar todo» es tan visible como «Aceptar todo». Siete diseños, 25 idiomas, Consent Mode v2 y la norma correcta por región.
21 kB, un solo archivo, sin peticiones propias a terceros.
Cada decisión se guarda con marca de tiempo, versión del banner y un hash de los textos mostrados, encadenada al registro anterior. Las exportaciones van firmadas. Alojado en Fráncfort.
Artículo 7(1), en el plan gratuito.
comprobación gratuita
El HTML de la página de inicio, contrastado con la base de datos de rastreadores. Sin cuenta, sin guardar nada. El escaneo completo del panel hace lo mismo con cada página, en un navegador real.
preguntas
siguiente paso
Añade el sitio, ejecuta npx cookiecrumbs init en tu repositorio SvelteKit y el registro de consentimiento empieza a grabar en la UE.