Atributo cookie do DOM HTML Document
- página anterior close()
- próxima página createAttribute()
- Voltar à camada superior Documents do HTML DOM
Definição e uso
cookie
Configurações de atributo ou retorno separadas por ponto e vírgula key=value Lista de (cookies do documento).
Exemplo de criação de cookie:
document.cookie="username=Bill Gates; expires=Thu, 18 Dec 2013 12:00:00 UTC; path=/";
Dica:Os cookies não podem conter vírgulas, pontos e vírgulas ou espaços.Método encodeURIComponent() podem garantir que não sejam.
Veja também:
Tutorial de Cookies em JavaScript
recomendação:
Às vezes, a API Storage é uma ferramenta melhor:
exemplo
Obter todos os cookies associados a este documento:
let allCookies = document.cookie;
sintaxe
Retornar cookie:
document.cookie
Definir cookie:
document.cookie = newCookie
parâmetros
separados por ponto-e-vírgula name=value para a lista, seguida por qualquer valor opcional:
- expires=date
-
data no formato GMT (use o método Date.toUTCString).
valor padrão: exclua o cookie ao fechar o navegador. - max-age=seconds
- idade máxima do cookie antes de ser excluído. Se for 0 ou uma data passada, exclua o cookie.
- path=path
- caminho absoluto do diretório ao qual o cookie pertence ('/dir'). valor padrão: diretório atual.
- domain=domainname
- domínio do site ('example.com'). valor padrão: o domínio do documento.
- secure
- Envie cookies para o servidor usando protocolos de segurança (https).
retorno
tipo | descrição |
---|---|
string | separados por ponto-e-vírgula key=value para a lista (cookies do documento). |
Com cookies e armazenamento local
Cookies são usados para aplicativos cliente-servidor (navegador-servidor).
O armazenamento local (Local Storage) é usado para aplicativos do cliente (navegadores).
Os cookies estão associados ao site. Se os dados forem usados pelo cliente, enviar cookies em cada cabeçalho HTTP é um desperdício de largura de banda.
Os navegadores de alguns usuários geralmente desativam cookies.
O tamanho máximo dos cookies é de 4 KB. Cada domínio do armazenamento local tem um limite de 5 megabytes.
Os cookies têm uma data de expiração. O armazenamento local não tem.
Suporte do navegador
document.cookie é uma característica do DOM Level 2 (2001).
Todos os navegadores suportam:
Chrome | IE | Edge | Firefox | Safari | Opera |
---|---|---|---|---|---|
Chrome | IE | Edge | Firefox | Safari | Opera |
suporte | 9-11 | suporte | suporte | suporte | suporte |
- página anterior close()
- próxima página createAttribute()
- Voltar à camada superior Documents do HTML DOM