tough-cookie.cookiejar.setcookie_1.md

July 9, 2025 · View on GitHub

CookieJar.setCookie() method

Attempt to set the Cookie in the CookieJar.

Signature:

setCookie(cookie: string | Cookie, url: string | URL, options: SetCookieOptions, callback: Callback<Cookie | undefined>): void;

Parameter	Type	Description
cookie	string \| Cookie	The cookie object or cookie string to store. A string value will be parsed into a cookie using Cookie.parse().
url	string \| URL	The domain to store the cookie with.
options	SetCookieOptions	Configuration settings to use when storing the cookie.
callback	Callback<Cookie \| undefined>	A function to call after a cookie has been successfully stored.

Returns:

void

If successfully persisted, the Cookie will have updated Cookie.creation, Cookie.lastAccessed and Cookie.hostOnly properties.
As per the RFC, the Cookie.hostOnly flag is set if there was no Domain={value} attribute on the cookie string. The Cookie.domain property is set to the fully-qualified hostname of currentUrl in this case. Matching this cookie requires an exact hostname match (not a domainMatch() as per usual)