Cookie

Set writes a ButilCookie to the document. Name and value are percent-encoded automatically (matching encodeURIComponent semantics), so reserved characters and non-ASCII text round-trip safely with values written by JavaScript or the server.

@inject Bit.Butil.Cookie cookie

await cookie.Set(new ButilCookie
{
    Name = "theme",
    Value = "dark",
});

ButilCookie carries every attribute the Set-Cookie syntax supports: Expires, MaxAge, Path, Domain, SameSite, Secure and Partitioned. Expires is emitted in RFC 1123 format; when both Expires and MaxAge are present the browser honors MaxAge.

await cookie.Set(new ButilCookie
{
    Name = "session-hint",
    Value = "abc123",
    MaxAge = 3600,               // seconds
    Path = "/",
    SameSite = SameSite.Strict,
    Secure = true,
});

// or with an absolute expiry:
await cookie.Set(new ButilCookie
{
    Name = "campaign",
    Value = "spring",
    Expires = DateTimeOffset.UtcNow.AddDays(7),
});

Get returns a single ButilCookie by name, GetValue shortcuts straight to its string value, and GetAll parses every cookie visible to the document. The browser only exposes name=value pairs on read, so attributes such as Path or Expires are never populated on returned cookies.

var theme = await cookie.Get("theme");        // ButilCookie? (Name + Value only)

var value = await cookie.GetValue("theme");   // string?

var all = await cookie.GetAll();              // ButilCookie[]

Remove expires the cookie immediately by rewriting it with MaxAge = 0. Pass a name for the common case, or a full ButilCookie when the original was set with a specific Path or Domain - the attributes must match for the browser to delete it.

await cookie.Remove("theme");

// cookie was set with a path? match it on removal:
await cookie.Remove(new ButilCookie { Name = "session-hint", Path = "/" });