Cookie de documento HTML DOM
Exemplo
Obtenha todos os cookies associados a este documento:
let allCookies = document.cookie;
Definição e uso
A cookie
propriedade define ou retorna uma lista separada por ponto e vírgula de pares chave=valor (cookies de documento).
Um exemplo de criação de um cookie:
document.cookie="username=John Doe; expires=Thu, 18 Dec 2013 12:00:00 UTC;
path=/";
Observação
Os cookies não podem conter vírgulas, ponto e vírgula ou espaços em branco.
O método encodeURIComponent() garante que não.
Veja também:
Tutorial de cookies JavaScript
Adendo:
Às vezes, a API de armazenamento é uma ferramenta melhor:
Sintaxe
Devolva o biscoito:
document.cookie
Defina o biscoito:
document.cookie = newCookie
Parâmetro
Uma lista separada por ponto e vírgula de pares nome=valor , seguida por qualquer um destes valores opcionais:
expires=date max-age=seconds path=path domain=domainname secure |
Valor de retorno
Modelo | Descrição |
Corda | Uma lista separada por ponto e vírgula de pares chave=valor (cookies de documento). |
Cookies x armazenamento local
Os cookies são para aplicativos cliente-servidor (navegador-servidor).
O armazenamento local é para aplicativos cliente (navegador).
Os cookies estão associados a sites. Se os dados forem para uso do cliente, o envio de cookies em cada cabeçalho HTTP é uma perda de largura de banda.
Alguns usuários têm os cookies desabilitados como regra em seus navegadores.
Um Cookie tem um limite de tamanho de 4 Kilobytes. O armazenamento local tem um limite de 5 Megabytes por domínio.
Um Cookie tem data de validade. O armazenamento local não.
Suporte ao navegador
document.cookie
é um recurso DOM Nível 2 (2001).
É totalmente suportado em todos os navegadores:
Chrome | IE | Edge | Firefox | Safari | Opera |
Yes | 9-11 | Yes | Yes | Yes | Yes |