AG-34277 Improve 'set-cookie' — add 'essential' and 'nonessential' to…

… supported values. #436

Squashed commit of the following:

commit 378ad52
Author: Adam Wróblewski <adam@adguard.com>
Date:   Thu Jul 11 12:35:11 2024 +0200

    Fix typos in test

commit 2d249cf
Author: Adam Wróblewski <adam@adguard.com>
Date:   Thu Jul 11 11:28:09 2024 +0200

    Add new values to 'set-cookie' and 'set-cookie-reload' scriptlets: 'essential', 'nonessential'

CHANGELOG.md

@@ -11,9 +11,11 @@ The format is based on [Keep a Changelog], and this project adheres to [Semantic
 
 ### Added
 
+- new values to `set-cookie` and `set-cookie-reload` scriptlets: `essential`, `nonessential` [#436]
 - `trusted-set-session-storage-item` scriptlet [#426]
 
 [Unreleased]: https://github.com/AdguardTeam/Scriptlets/compare/v1.11.6...HEAD
+[#436]: https://github.com/AdguardTeam/Scriptlets/issues/436
 [#426]: https://github.com/AdguardTeam/Scriptlets/issues/426
 
 ## [v1.11.6] - 2024-07-08

src/helpers/cookie-utils.ts

@@ -106,6 +106,8 @@ export const getLimitedCookieValue = (value: string): string | number | null =>
         'required',
         'hide',
         'hidden',
+        'essential',
+        'nonessential',
     ]);
 
     let validValue;

src/scriptlets/set-cookie-reload.js

@@ -43,6 +43,7 @@ import {
  *         - `disable` / `disabled`
  *         - `necessary` / `required`
  *         - `hide` / `hidden`
+ *         - `essential` / `nonessential`
  * - `path` — optional, cookie path, defaults to `/`; possible values:
  *     - `/` — root path
  *     - `none` — to set no path at all

src/scriptlets/set-cookie.js

@@ -45,6 +45,7 @@ import {
  *         - `disable` / `disabled`
  *         - `necessary` / `required`
  *         - `hide` / `hidden`
+ *         - `essential` / `nonessential`
  * - `path` — optional, cookie path, defaults to `/`; possible values:
  *     - `/` — root path
  *     - `none` — to set no path at all

tests/scriptlets/set-cookie.test.js

@@ -66,8 +66,10 @@ const cookies = [
     ['__test-cookie_disabled', 'disabled'],
     ['__test-cookie_necessary', 'necessary'],
     ['__test-cookie_required', 'required'],
-    ['__test-cookie_required', 'hide'],
-    ['__test-cookie_required', 'hidden'],
+    ['__test-cookie_hide', 'hide'],
+    ['__test-cookie_hidden', 'hidden'],
+    ['__test-cookie_essential', 'essential'],
+    ['__test-cookie_nonessential', 'nonessential'],
 ];
 
 test.each('Set cookie with valid value', cookies, (assert, [cName, cValue]) => {