std/cookies

Этот модуль реализует вспомогательные процедуры для разбора файлов cookie.

Импорты

strtabs, times, options

Типы

SameSite {.pure.} = enum
  Default, None, Lax, Strict

Атрибут cookie SameSite. Default означает, что процедура setCookie не будет устанавливать атрибут SameSite. Source Edit

Процедуры

proc parseCookies(s: string): StringTableRef {....raises: [], tags: [], forbids: [].}

Разбирает файлы cookie в таблицу строк.

Процедура предназначена для разбора заголовка Cookie, установленного клиентом, а не заголовка «Set-Cookie», установленного серверами.

Пример:

import std/strtabs
let cookieJar = parseCookies("a=1; foo=bar")
assert cookieJar["a"] == "1"
assert cookieJar["foo"] == "bar"

Source Edit

proc setCookie(key, value: string; domain = ""; path = ""; expires = "";
               noName = false; secure = false; httpOnly = false;
               maxAge = none(int); sameSite = SameSite.Default): string {.
    ...raises: [], tags: [], forbids: [].}

Создаёт команду в формате Set-Cookie: key=value; Domain=...; ....

Подсказка: Файлы cookie могут быть уязвимыми. Подумайте об установке secure=true, httpOnly=true и sameSite=Strict.

Source Edit

proc setCookie(key, value: string; expires: DateTime | Time; domain = "";
               path = ""; noName = false; secure = false; httpOnly = false;
               maxAge = none(int); sameSite = SameSite.Default): string

Создаёт команду в формате Set-Cookie: key=value; Domain=...; .... Source Edit