From 849bbfe20be35bc8a9fad4dfd75a376c7b420614 Mon Sep 17 00:00:00 2001
From: lolcat <will@lolcat.ca>
Date: Sun, 25 Oct 2026 01:46:33 -0400
Subject: [PATCH] docs

---
 README.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/README.md b/README.md
index 874bed4..8e4c3e8 100644
--- a/README.md
+++ b/README.md
@@ -274,6 +274,23 @@ Removes the proxy from a container, reverting to direct connection.
 
 **Returns:** `boolean` - `true` if detached successfully, `false` otherwise.
 
+### `fplay.get_cookies(ws, filters = {})`
+
+Get cookies.
+
+- `ws` (`WebSocket`) - Active browser connection.
+- `filters` (`filters`) - Filters to use to get cookies back. Passing `{}` returns all headers for all containers.
+  - `storeId` (`string`) - Match a specific container ID
+  - `domain` (`string`) - Match a specific domain
+  - `secure` (`boolean`) - Match cookies that are secure
+  - `session` (`boolean`) - Match session-only cookies
+  - `name` (`string`) - Match a cookie name
+  - `path` (`string`) - Match cookies issued for a certain path
+  - `url` (`string`) - Match cookies issued for a certain URL
+  - `firstPartyDomain` (`string`) - Match first party domain, where supported
+
+**Returns:** `Array<object>` (each object contains `name`, `value`, `domain`, `hostOnly`, `path`, `secure`, `httpOnly`, `sameSite`, `session`, `expirationDate`, `storeId`).
+
 ---
 
 ## Events