flowingts / CookieOptions

Interface: CookieOptions

Definido em: src/utils/cookie.ts:13

Leitura e escrita de cookies (RFC 6265), seguras por padrão.

• Leitura: o resultado é um objeto sem protótipo (__proto__ vira um cookie comum, sem poluir nada); em nomes repetidos vale o primeiro, como nos navegadores; um valor com % inválido fica cru.
• Escrita: HttpOnly, Secure, SameSite=Lax e Path=/ por padrão. Nome, Domain e Path são validados (sem ;, quebra de linha nem caracteres de controle), então não dá para injetar atributos. O valor é codificado com encodeURIComponent.
• Prefixos: __Host- exige Secure, Path=/ e nenhum Domain; __Secure- exige Secure. SameSite=None exige Secure. Violações lançam erro na hora de definir o cookie.

Propriedades

domain?

optional domain?: string

Definido em: src/utils/cookie.ts:23

Sem domain, o cookie vale só para o host atual (o mais restrito).

---

expires?

optional expires?: Date

Definido em: src/utils/cookie.ts:26

---

httpOnly?

optional httpOnly?: boolean

Definido em: src/utils/cookie.ts:15

Padrão: true. Impede a leitura por JavaScript no navegador.

---

maxAge?

optional maxAge?: number

Definido em: src/utils/cookie.ts:25

Duração em segundos. 0 remove o cookie.

---

partitioned?

optional partitioned?: boolean

Definido em: src/utils/cookie.ts:28

Cookie particionado (CHIPS), para uso em iframes de terceiros. Exige secure.

---

path?

optional path?: string

Definido em: src/utils/cookie.ts:21

Padrão: '/'.

---

priority?

optional priority?: "Low" | "Medium" | "High"

Definido em: src/utils/cookie.ts:29

---

sameSite?

optional sameSite?: false | "Strict" | "Lax" | "None"

Definido em: src/utils/cookie.ts:19

Padrão: 'Lax'. 'None' exige secure.

---

secure?

optional secure?: boolean

Definido em: src/utils/cookie.ts:17

Padrão: true. Os navegadores aceitam cookies Secure em http://localhost.