@isdk/web-fetcher 0.2.12 → 0.3.0

package/docs/classes/FetchEngine.md

@@ -6,7 +6,7 @@
 
 # Abstract Class: FetchEngine\<TContext, TCrawler, TOptions\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:172](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L172)
+Defined in: [packages/web-fetcher/src/engine/base.ts:272](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L272)
 
 ## Extended by
 
@@ -27,6 +27,10 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:172](https://github.com/isd
 
 `TOptions` *extends* `BasicCrawlerOptions`\<`TContext`\> = `any`
 
+## Implements
+
+- `IExtractEngine`
+
 ## Constructors
 
 ### Constructor
@@ -43,7 +47,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:172](https://github.com/isd
 
 > `protected` `optional` **\_initialCookies**: [`Cookie`](../interfaces/Cookie.md)[]
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:278](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L278)
+Defined in: [packages/web-fetcher/src/engine/base.ts:379](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L379)
 
 ***
 
@@ -51,7 +55,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:278](https://github.com/isd
 
 > `protected` **\_initializedSessions**: `Set`\<`string`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:279](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L279)
+Defined in: [packages/web-fetcher/src/engine/base.ts:380](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L380)
 
 ***
 
@@ -59,7 +63,23 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:279](https://github.com/isd
 
 > `protected` **actionEmitter**: `EventEmitter`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:283](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L283)
+Defined in: [packages/web-fetcher/src/engine/base.ts:384](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L384)
+
+***
+
+### actionQueue
+
+> `protected` **actionQueue**: [`DispatchedEngineAction`](../interfaces/DispatchedEngineAction.md)[] = `[]`
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:391](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L391)
+
+***
+
+### activeContext?
+
+> `protected` `optional` **activeContext**: `TContext`
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:388](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L388)
 
 ***
 
@@ -67,7 +87,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:283](https://github.com/isd
 
 > `protected` **blockedTypes**: `Set`\<`string`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:288](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L288)
+Defined in: [packages/web-fetcher/src/engine/base.ts:393](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L393)
 
 ***
 
@@ -75,7 +95,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:288](https://github.com/isd
 
 > `protected` `optional` **config**: `Configuration`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:272](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L272)
+Defined in: [packages/web-fetcher/src/engine/base.ts:373](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L373)
 
 ***
 
@@ -83,7 +103,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:272](https://github.com/isd
 
 > `protected` `optional` **crawler**: `TCrawler`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:269](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L269)
+Defined in: [packages/web-fetcher/src/engine/base.ts:370](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L370)
 
 ***
 
@@ -91,7 +111,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:269](https://github.com/isd
 
 > `protected` `optional` **crawlerRunPromise**: `Promise`\<`FinalStatistics`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:271](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L271)
+Defined in: [packages/web-fetcher/src/engine/base.ts:372](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L372)
 
 ***
 
@@ -99,7 +119,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:271](https://github.com/isd
 
 > `protected` `optional` **ctx**: [`FetchEngineContext`](../interfaces/FetchEngineContext.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:267](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L267)
+Defined in: [packages/web-fetcher/src/engine/base.ts:368](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L368)
 
 ***
 
@@ -107,7 +127,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:267](https://github.com/isd
 
 > `protected` `optional` **currentSession**: `Session`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:280](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L280)
+Defined in: [packages/web-fetcher/src/engine/base.ts:381](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L381)
 
 ***
 
@@ -115,7 +135,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:280](https://github.com/isd
 
 > `protected` **hdrs**: `Record`\<`string`, `string`\> = `{}`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:277](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L277)
+Defined in: [packages/web-fetcher/src/engine/base.ts:378](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L378)
 
 ***
 
@@ -123,7 +143,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:277](https://github.com/isd
 
 > `protected` `optional` **isCrawlerReady**: `boolean`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:270](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L270)
+Defined in: [packages/web-fetcher/src/engine/base.ts:371](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L371)
 
 ***
 
@@ -131,7 +151,15 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:270](https://github.com/isd
 
 > `protected` **isEngineDisposed**: `boolean` = `false`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:285](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L285)
+Defined in: [packages/web-fetcher/src/engine/base.ts:386](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L386)
+
+***
+
+### isExecutingAction
+
+> `protected` **isExecutingAction**: `boolean` = `false`
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:389](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L389)
 
 ***
 
@@ -139,7 +167,15 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:285](https://github.com/isd
 
 > `protected` **isPageActive**: `boolean` = `false`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:284](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L284)
+Defined in: [packages/web-fetcher/src/engine/base.ts:385](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L385)
+
+***
+
+### isProcessingActionLoop
+
+> `protected` **isProcessingActionLoop**: `boolean` = `false`
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:392](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L392)
 
 ***
 
@@ -147,7 +183,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:284](https://github.com/isd
 
 > `protected` `optional` **kvStore**: `KeyValueStore`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:274](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L274)
+Defined in: [packages/web-fetcher/src/engine/base.ts:375](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L375)
 
 ***
 
@@ -155,7 +191,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:274](https://github.com/isd
 
 > `protected` `optional` **lastResponse**: [`FetchResponse`](../interfaces/FetchResponse.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:287](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L287)
+Defined in: [packages/web-fetcher/src/engine/base.ts:390](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L390)
 
 ***
 
@@ -163,7 +199,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:287](https://github.com/isd
 
 > `protected` **navigationLock**: `PromiseLock`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:286](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L286)
+Defined in: [packages/web-fetcher/src/engine/base.ts:387](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L387)
 
 ***
 
@@ -171,7 +207,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:286](https://github.com/isd
 
 > `protected` `optional` **opts**: [`BaseFetcherProperties`](../interfaces/BaseFetcherProperties.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:268](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L268)
+Defined in: [packages/web-fetcher/src/engine/base.ts:369](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L369)
 
 ***
 
@@ -179,7 +215,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:268](https://github.com/isd
 
 > `protected` **pendingRequests**: `Map`\<`string`, [`PendingEngineRequest`](../interfaces/PendingEngineRequest.md)\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:281](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L281)
+Defined in: [packages/web-fetcher/src/engine/base.ts:382](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L382)
 
 ***
 
@@ -187,7 +223,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:281](https://github.com/isd
 
 > `protected` `optional` **proxyConfiguration**: `ProxyConfiguration`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:275](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L275)
+Defined in: [packages/web-fetcher/src/engine/base.ts:376](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L376)
 
 ***
 
@@ -195,7 +231,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:275](https://github.com/isd
 
 > `protected` **requestCounter**: `number` = `0`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:282](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L282)
+Defined in: [packages/web-fetcher/src/engine/base.ts:383](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L383)
 
 ***
 
@@ -203,7 +239,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:282](https://github.com/isd
 
 > `protected` `optional` **requestQueue**: `RequestQueue`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:273](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L273)
+Defined in: [packages/web-fetcher/src/engine/base.ts:374](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L374)
 
 ***
 
@@ -211,7 +247,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:273](https://github.com/isd
 
 > `readonly` `static` **id**: `string`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:257](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L257)
+Defined in: [packages/web-fetcher/src/engine/base.ts:358](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L358)
 
 Unique identifier for the engine implementation.
 
@@ -225,7 +261,7 @@ Must be defined by concrete implementations. Used for registration and lookup in
 
 > `readonly` `static` **mode**: [`FetchEngineType`](../type-aliases/FetchEngineType.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:265](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L265)
+Defined in: [packages/web-fetcher/src/engine/base.ts:366](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L366)
 
 Execution mode of the engine (`'http'` or `'browser'`).
 
@@ -239,15 +275,15 @@ Must be defined by concrete implementations. Indicates whether engine operates a
 
 #### Get Signature
 
-> **get** **context**(): `undefined` \| [`FetchEngineContext`](../interfaces/FetchEngineContext.md)
+> **get** **context**(): [`FetchEngineContext`](../interfaces/FetchEngineContext.md) \| `undefined`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:938](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L938)
+Defined in: [packages/web-fetcher/src/engine/base.ts:846](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L846)
 
 Gets the fetch engine context associated with this instance.
 
 ##### Returns
 
-`undefined` \| [`FetchEngineContext`](../interfaces/FetchEngineContext.md)
+[`FetchEngineContext`](../interfaces/FetchEngineContext.md) \| `undefined`
 
 ***
 
@@ -257,7 +293,7 @@ Gets the fetch engine context associated with this instance.
 
 > **get** **id**(): `string`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:913](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L913)
+Defined in: [packages/web-fetcher/src/engine/base.ts:821](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L821)
 
 Gets the unique identifier of this engine implementation.
 
@@ -273,7 +309,7 @@ Gets the unique identifier of this engine implementation.
 
 > **get** **mode**(): [`FetchEngineType`](../type-aliases/FetchEngineType.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:931](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L931)
+Defined in: [packages/web-fetcher/src/engine/base.ts:839](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L839)
 
 Gets the execution mode of this engine (`'http'` or `'browser'`).
 
@@ -287,7 +323,7 @@ Gets the execution mode of this engine (`'http'` or `'browser'`).
 
 > `abstract` `protected` **\_buildResponse**(`context`): `Promise`\<[`FetchResponse`](../interfaces/FetchResponse.md)\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:722](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L722)
+Defined in: [packages/web-fetcher/src/engine/base.ts:637](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L637)
 
 **`Internal`**
 
@@ -317,7 +353,7 @@ Converts implementation-specific context (Playwright `page` or Cheerio `$`) to s
 
 > `protected` `optional` **\_cleanup**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:290](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L290)
+Defined in: [packages/web-fetcher/src/engine/base.ts:399](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L399)
 
 #### Returns
 
@@ -329,7 +365,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:290](https://github.com/isd
 
 > `protected` **\_commonCleanup**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1239](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1239)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1237](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1237)
 
 #### Returns
 
@@ -337,11 +373,51 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:1239](https://github.com/is
 
 ***
 
+### \_contains()
+
+> `abstract` **\_contains**(`container`, `element`): `Promise`\<`boolean`\>
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:511](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L511)
+
+**`Internal`**
+
+Checks if the `container` scope contains the `element` scope.
+
+#### Parameters
+
+##### container
+
+`any`
+
+The potential ancestor element.
+
+##### element
+
+`any`
+
+The potential descendant element.
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+A promise resolving to `true` if `container` contains `element`.
+
+#### See
+
+IExtractEngine.\_contains for implementation details.
+
+#### Implementation of
+
+`IExtractEngine._contains`
+
+***
+
 ### \_createCrawler()
 
 > `abstract` `protected` **\_createCrawler**(`options`, `config?`): `TCrawler`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:699](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L699)
+Defined in: [packages/web-fetcher/src/engine/base.ts:614](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L614)
 
 **`Internal`**
 
@@ -369,7 +445,7 @@ The final crawler options.
 
 > `protected` **\_executePendingActions**(`context`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1120](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1120)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1089](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1089)
 
 **`Internal`**
 
@@ -416,9 +492,9 @@ If called outside valid page context window (`!this.isPageActive`)
 
 ### \_extract()
 
-> `protected` **\_extract**(`schema`, `context`): `Promise`\<`any`\>
+> `protected` **\_extract**(`schema`, `scope`, `parentStrict?`): `Promise`\<`any`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:365](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L365)
+Defined in: [packages/web-fetcher/src/engine/base.ts:542](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L542)
 
 #### Parameters
 
@@ -426,10 +502,14 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:365](https://github.com/isd
 
 `ExtractSchema`
 
-##### context
+##### scope
 
 `any`
 
+##### parentStrict?
+
+`boolean`
+
 #### Returns
 
 `Promise`\<`any`\>
@@ -438,9 +518,9 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:365](https://github.com/isd
 
 ### \_extractColumnar()
 
-> `protected` **\_extractColumnar**(`schema`, `container`, `opts?`): `Promise`\<`null` \| `any`[]\>
+> `protected` **\_extractColumnar**(`schema`, `container`, `opts?`): `Promise`\<`any`[] \| `null`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:489](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L489)
+Defined in: [packages/web-fetcher/src/engine/base.ts:584](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L584)
 
 **`Internal`**
 
@@ -468,7 +548,7 @@ Columnar extraction options (strict, inference).
 
 #### Returns
 
-`Promise`\<`null` \| `any`[]\>
+`Promise`\<`any`[] \| `null`\>
 
 An array of extracted items, or null if requirements aren't met.
 
@@ -476,9 +556,9 @@ An array of extracted items, or null if requirements aren't met.
 
 ### \_extractNested()
 
-> `protected` **\_extractNested**(`items`, `elements`): `Promise`\<`any`[]\>
+> `protected` **\_extractNested**(`items`, `elements`, `opts?`): `Promise`\<`any`[]\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:469](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L469)
+Defined in: [packages/web-fetcher/src/engine/base.ts:567](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L567)
 
 **`Internal`**
 
@@ -498,6 +578,12 @@ The schema for each item.
 
 The list of item elements.
 
+##### opts?
+
+###### strict?
+
+`boolean`
+
 #### Returns
 
 `Promise`\<`any`[]\>
@@ -506,9 +592,9 @@ The list of item elements.
 
 ### \_extractSegmented()
 
-> `protected` **\_extractSegmented**(`schema`, `container`, `opts?`): `Promise`\<`null` \| `any`[]\>
+> `protected` **\_extractSegmented**(`schema`, `container`, `opts?`): `Promise`\<`any`[] \| `null`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:651](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L651)
+Defined in: [packages/web-fetcher/src/engine/base.ts:601](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L601)
 
 **`Internal`**
 
@@ -536,7 +622,7 @@ Segmented extraction options (anchor).
 
 #### Returns
 
-`Promise`\<`null` \| `any`[]\>
+`Promise`\<`any`[] \| `null`\>
 
 An array of extracted items.
 
@@ -544,9 +630,9 @@ An array of extracted items.
 
 ### \_extractValue()
 
-> `abstract` `protected` **\_extractValue**(`schema`, `context`): `Promise`\<`any`\>
+> `abstract` **\_extractValue**(`schema`, `scope`): `Promise`\<`any`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:309](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L309)
+Defined in: [packages/web-fetcher/src/engine/base.ts:445](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L445)
 
 **`Internal`**
 
@@ -560,23 +646,169 @@ Extracts a primitive value from the element based on schema.
 
 Value extraction schema.
 
-##### context
+##### scope
+
+`any`
+
+The element scope.
+
+#### Returns
+
+`Promise`\<`any`\>
+
+Extracted value.
+
+#### See
+
+IExtractEngine.\_extractValue for behavior contract.
+
+#### Implementation of
+
+`IExtractEngine._extractValue`
+
+***
+
+### \_findClosestAncestor()
+
+> `abstract` **\_findClosestAncestor**(`scope`, `candidates`): `Promise`\<`any`\>
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:497](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L497)
+
+**`Internal`**
+
+Finds the closest ancestor of `scope` (including itself) that exists in the `candidates` array.
+
+#### Parameters
+
+##### scope
+
+`any`
+
+The starting element.
+
+##### candidates
+
+`any`[]
+
+The array of potential ancestor scopes.
+
+#### Returns
+
+`Promise`\<`any`\>
+
+A promise resolving to the matching candidate scope, or `null` if none found.
+
+#### See
+
+IExtractEngine.\_findClosestAncestor for implementation details.
+
+#### Implementation of
+
+`IExtractEngine._findClosestAncestor`
+
+***
+
+### \_findCommonAncestor()
+
+> `abstract` **\_findCommonAncestor**(`scope1`, `scope2`): `Promise`\<`any`\>
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:524](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L524)
+
+**`Internal`**
+
+Finds the Lowest Common Ancestor (LCA) of two element scopes.
+
+#### Parameters
+
+##### scope1
 
 `any`
 
-The element context.
+The first element scope.
+
+##### scope2
+
+`any`
+
+The second element scope.
+
+#### Returns
+
+`Promise`\<`any`\>
+
+A promise resolving to the LCA element scope, or `null` if none found.
+
+#### Implementation of
+
+`IExtractEngine._findCommonAncestor`
+
+***
+
+### \_findContainerChild()
+
+> `abstract` **\_findContainerChild**(`element`, `container`): `Promise`\<`any`\>
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:537](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L537)
+
+**`Internal`**
+
+Finds the direct child of container that contains element.
+
+#### Parameters
+
+##### element
+
+`any`
+
+The descendant element.
+
+##### container
+
+`any`
+
+The container element.
 
 #### Returns
 
 `Promise`\<`any`\>
 
+The child element of container, or null.
+
+#### Implementation of
+
+`IExtractEngine._findContainerChild`
+
+***
+
+### \_getInitialElementScope()
+
+> `abstract` `protected` **\_getInitialElementScope**(`context`): `any`
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:1010](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1010)
+
+**`Internal`**
+
+Gets the initial scope for extraction for the specific engine.
+
+#### Parameters
+
+##### context
+
+`TContext`
+
+Crawlee crawling context
+
+#### Returns
+
+`any`
+
 ***
 
 ### \_getSpecificCrawlerOptions()
 
 > `abstract` `protected` **\_getSpecificCrawlerOptions**(`ctx`): `Partial`\<`TOptions`\> \| `Promise`\<`Partial`\<`TOptions`\>\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:709](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L709)
+Defined in: [packages/web-fetcher/src/engine/base.ts:624](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L624)
 
 **`Internal`**
 
@@ -596,59 +828,129 @@ The fetch engine context.
 
 ***
 
-### \_isImplicitObject()
+### \_getTrimInfo()
 
-> `protected` **\_isImplicitObject**(`schema`): `boolean`
+> `protected` **\_getTrimInfo**(`options`): `object`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:344](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L344)
+Defined in: [packages/web-fetcher/src/engine/base.ts:401](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L401)
 
 #### Parameters
 
-##### schema
+##### options
 
-`any`
+[`TrimActionOptions`](../interfaces/TrimActionOptions.md)
 
 #### Returns
 
-`boolean`
+`object`
+
+##### removeComments
+
+> **removeComments**: `boolean`
+
+##### removeHidden
+
+> **removeHidden**: `boolean`
+
+##### selectors
+
+> **selectors**: `string`[] = `allSelectors`
+
+***
+
+### \_handlePause()
+
+> `protected` **\_handlePause**(`action`): `Promise`\<`void`\>
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:1049](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1049)
+
+#### Parameters
+
+##### action
+
+###### message?
+
+`string`
+
+#### Returns
+
+`Promise`\<`void`\>
 
 ***
 
 ### \_isSameElement()
 
-> `abstract` `protected` **\_isSameElement**(`element1`, `element2`): `Promise`\<`boolean`\>
+> `abstract` **\_isSameElement**(`scope1`, `scope2`): `Promise`\<`boolean`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:327](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L327)
+Defined in: [packages/web-fetcher/src/engine/base.ts:469](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L469)
 
 **`Internal`**
 
-Checks if two elements are the same.
+Checks if two elements are the same identity.
 
 #### Parameters
 
-##### element1
+##### scope1
 
 `any`
 
-First element.
+First element scope.
 
-##### element2
+##### scope2
 
 `any`
 
-Second element.
+Second element scope.
 
 #### Returns
 
 `Promise`\<`boolean`\>
 
+True if they are the same DOM node.
+
+#### Implementation of
+
+`IExtractEngine._isSameElement`
+
+***
+
+### \_logDebug()
+
+> **\_logDebug**(`category`, ...`args`): `void`
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:395](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L395)
+
+Logs debug information if debug mode is enabled.
+
+#### Parameters
+
+##### category
+
+`string`
+
+The category of the log message.
+
+##### args
+
+...`any`[]
+
+Arguments to log.
+
+#### Returns
+
+`void`
+
+#### Implementation of
+
+`IExtractEngine._logDebug`
+
 ***
 
 ### \_nextSiblingsUntil()
 
-> `abstract` `protected` **\_nextSiblingsUntil**(`element`, `untilSelector?`): `Promise`\<`any`[]\>
+> `abstract` **\_nextSiblingsUntil**(`scope`, `untilSelector?`): `Promise`\<`any`[]\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:339](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L339)
+Defined in: [packages/web-fetcher/src/engine/base.ts:483](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L483)
 
 **`Internal`**
 
@@ -657,29 +959,35 @@ Used in 'segmented' extraction mode.
 
 #### Parameters
 
-##### element
+##### scope
 
 `any`
 
-The anchor element.
+The anchor element scope.
 
 ##### untilSelector?
 
 `string`
 
-Optional selector that marks the end of the segment.
+Optional selector that marks the end of the segment (exclusive).
 
 #### Returns
 
 `Promise`\<`any`[]\>
 
+List of sibling elements between anchor and untilSelector.
+
+#### Implementation of
+
+`IExtractEngine._nextSiblingsUntil`
+
 ***
 
 ### \_normalizeArrayMode()
 
 > `protected` **\_normalizeArrayMode**(`mode?`): `any`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:455](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L455)
+Defined in: [packages/web-fetcher/src/engine/base.ts:555](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L555)
 
 **`Internal`**
 
@@ -699,41 +1007,59 @@ The mode string or options object.
 
 ***
 
-### \_normalizeSchema()
+### \_parentElement()
 
-> `protected` **\_normalizeSchema**(`schema`): `ExtractSchema`
+> `abstract` **\_parentElement**(`scope`): `Promise`\<`any`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:867](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L867)
+Defined in: [packages/web-fetcher/src/engine/base.ts:457](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L457)
+
+**`Internal`**
+
+Gets the parent element of the given element.
 
 #### Parameters
 
-##### schema
+##### scope
 
-`ExtractSchema`
+`any`
+
+The element scope.
 
 #### Returns
 
-`ExtractSchema`
+`Promise`\<`any`\>
+
+Parent element or null.
+
+#### Implementation of
+
+`IExtractEngine._parentElement`
 
 ***
 
-### \_parentElement()
+### \_processAction()
 
-> `abstract` `protected` **\_parentElement**(`element`): `Promise`\<`any`\>
+> `protected` **\_processAction**(`context`, `action`): `Promise`\<`any`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:319](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L319)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1020](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1020)
 
 **`Internal`**
 
-Gets the parent element of the given element.
+Unified action processor that handles engine-agnostic actions.
 
 #### Parameters
 
-##### element
+##### context
 
-`any`
+`TContext`
+
+Crawlee crawling context
+
+##### action
+
+[`FetchEngineAction`](../type-aliases/FetchEngineAction.md)
 
-The element.
+Action to execute
 
 #### Returns
 
@@ -743,21 +1069,21 @@ The element.
 
 ### \_querySelectorAll()
 
-> `abstract` `protected` **\_querySelectorAll**(`context`, `selector`): `Promise`\<`any`[]\>
+> `abstract` **\_querySelectorAll**(`scope`, `selector`): `Promise`\<`any`[]\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:298](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L298)
+Defined in: [packages/web-fetcher/src/engine/base.ts:431](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L431)
 
 **`Internal`**
 
-Finds all elements matching the selector within the given context.
+Finds all elements matching the selector within the given scope.
 
 #### Parameters
 
-##### context
+##### scope
 
 `any`
 
-The context to search in (Engine-specific element/node or array of nodes).
+The scope to search in (Engine-specific element/node or array of nodes).
 
 ##### selector
 
@@ -769,13 +1095,23 @@ CSS selector.
 
 `Promise`\<`any`[]\>
 
+List of matching elements.
+
+#### See
+
+IExtractEngine.\_querySelectorAll for behavior contract.
+
+#### Implementation of
+
+`IExtractEngine._querySelectorAll`
+
 ***
 
 ### \_sharedFailedRequestHandler()
 
 > `protected` **\_sharedFailedRequestHandler**(`context`, `error?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1196](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1196)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1185](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1185)
 
 #### Parameters
 
@@ -797,7 +1133,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:1196](https://github.com/is
 
 > `protected` **\_sharedRequestHandler**(`context`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1156](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1156)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1144](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1144)
 
 #### Parameters
 
@@ -815,7 +1151,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:1156](https://github.com/is
 
 > **blockResources**(`types`, `overwrite?`): `Promise`\<`number`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1302](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1302)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1301](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1301)
 
 Blocks specified resource types from loading.
 
@@ -852,7 +1188,7 @@ await engine.blockResources(['script'], true); // Replace existing
 
 > `protected` **buildResponse**(`context`): `Promise`\<[`FetchResponse`](../interfaces/FetchResponse.md)\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:723](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L723)
+Defined in: [packages/web-fetcher/src/engine/base.ts:638](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L638)
 
 #### Parameters
 
@@ -870,7 +1206,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:723](https://github.com/isd
 
 > **cleanup**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1084](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1084)
+Defined in: [packages/web-fetcher/src/engine/base.ts:992](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L992)
 
 #### Returns
 
@@ -882,7 +1218,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:1084](https://github.com/is
 
 > **click**(`selector`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:817](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L817)
+Defined in: [packages/web-fetcher/src/engine/base.ts:732](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L732)
 
 Clicks on element matching selector.
 
@@ -912,7 +1248,7 @@ When no active page context exists
 
 > **cookies**(): `Promise`\<[`Cookie`](../interfaces/Cookie.md)[]\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1418](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1418)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1417](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1417)
 
 Manages cookies for current session with multiple overloads.
 
@@ -937,7 +1273,7 @@ await engine.cookies([{ name: 'session', value: '123' }]);
 
 > **cookies**(`cookies`): `Promise`\<`boolean`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1419](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1419)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1418](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1418)
 
 Manages cookies for current session with multiple overloads.
 
@@ -972,7 +1308,7 @@ await engine.cookies([{ name: 'session', value: '123' }]);
 
 > `protected` **dispatchAction**\<`T`\>(`action`): `Promise`\<`T`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1219](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1219)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1208](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1208)
 
 #### Type Parameters
 
@@ -996,7 +1332,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:1219](https://github.com/is
 
 > **dispose**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1454](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1454)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1453](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1453)
 
 Disposes of engine, cleaning up all resources.
 
@@ -1008,11 +1344,53 @@ Promise resolving when disposal completes
 
 ***
 
+### evaluate()
+
+> **evaluate**(`params`): `Promise`\<`any`\>
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:800](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L800)
+
+Executes a custom function or expression within the current page context.
+
+#### Parameters
+
+##### params
+
+[`EvaluateActionOptions`](../interfaces/EvaluateActionOptions.md)
+
+Configuration for the execution, including the function and arguments.
+
+#### Returns
+
+`Promise`\<`any`\>
+
+A promise resolving to the result of the execution.
+
+#### Remarks
+
+This is a powerful action that allows running custom logic to interact with the DOM,
+calculate values, or trigger navigations.
+
+- In **Browser Mode**, it runs in the real browser.
+- In **HTTP Mode**, it runs in a Node.js sandbox with a mocked DOM.
+
+The action handles automatic navigation if `window.location` is modified.
+
+#### Throws
+
+If no active page context exists or if execution fails.
+
+#### See
+
+[EvaluateActionOptions](../interfaces/EvaluateActionOptions.md) for detailed parameter options and examples.
+
+***
+
 ### executeAction()
 
 > `abstract` `protected` **executeAction**(`context`, `action`): `Promise`\<`any`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:772](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L772)
+Defined in: [packages/web-fetcher/src/engine/base.ts:687](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L687)
 
 **`Internal`**
 
@@ -1048,7 +1426,7 @@ Handles specific user interactions using underlying technology (Playwright/Cheer
 
 > **extract**\<`T`\>(`schema`): `Promise`\<`T`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:862](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L862)
+Defined in: [packages/web-fetcher/src/engine/base.ts:810](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L810)
 
 Extracts structured data from the current page content.
 
@@ -1078,7 +1456,7 @@ A promise that resolves to an object with the extracted data.
 
 > **fill**(`selector`, `value`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:829](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L829)
+Defined in: [packages/web-fetcher/src/engine/base.ts:744](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L744)
 
 Fills input element with specified value.
 
@@ -1112,7 +1490,7 @@ When no active page context exists
 
 > **getContent**(): `Promise`\<[`FetchResponse`](../interfaces/FetchResponse.md)\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1316](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1316)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1315](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1315)
 
 Gets content of current page.
 
@@ -1132,7 +1510,7 @@ When no content has been fetched yet
 
 > **getState**(): `Promise`\<\{ `cookies`: [`Cookie`](../interfaces/Cookie.md)[]; `sessionState?`: `any`; \}\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:921](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L921)
+Defined in: [packages/web-fetcher/src/engine/base.ts:829](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L829)
 
 Returns the current state of the engine (cookies)
 that can be used to restore the session later.
@@ -1147,7 +1525,7 @@ that can be used to restore the session later.
 
 > `abstract` **goto**(`url`, `params?`): `Promise`\<`void` \| [`FetchResponse`](../interfaces/FetchResponse.md)\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:789](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L789)
+Defined in: [packages/web-fetcher/src/engine/base.ts:704](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L704)
 
 Navigates to the specified URL.
 
@@ -1185,7 +1563,7 @@ await engine.goto('https://example.com');
 
 > **headers**(): `Promise`\<`Record`\<`string`, `string`\>\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1357](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1357)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1356](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1356)
 
 Manages HTTP headers for requests with multiple overloads.
 
@@ -1212,7 +1590,7 @@ await engine.headers('auth', 'token');
 
 > **headers**(`name`): `Promise`\<`string`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1358](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1358)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1357](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1357)
 
 Manages HTTP headers for requests with multiple overloads.
 
@@ -1247,7 +1625,7 @@ await engine.headers('auth', 'token');
 
 > **headers**(`headers`, `replaced?`): `Promise`\<`boolean`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1359](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1359)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1358](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1358)
 
 Manages HTTP headers for requests with multiple overloads.
 
@@ -1288,7 +1666,7 @@ await engine.headers('auth', 'token');
 
 > **headers**(`name`, `value`): `Promise`\<`boolean`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:1363](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L1363)
+Defined in: [packages/web-fetcher/src/engine/base.ts:1362](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L1362)
 
 Manages HTTP headers for requests with multiple overloads.
 
@@ -1306,7 +1684,7 @@ Header name
 
 Header value or `null` to remove
 
-`null` | `string`
+`string` | `null`
 
 ##### Returns
 
@@ -1331,7 +1709,7 @@ await engine.headers('auth', 'token');
 
 > **initialize**(`context`, `options?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:953](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L953)
+Defined in: [packages/web-fetcher/src/engine/base.ts:861](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L861)
 
 Initializes the fetch engine with provided context and options.
 
@@ -1366,7 +1744,7 @@ Automatically called when creating engine via `FetchEngine.create()`.
 
 > **pause**(`message?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:852](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L852)
+Defined in: [packages/web-fetcher/src/engine/base.ts:778](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L778)
 
 Pauses execution, allowing for manual intervention or inspection.
 
@@ -1394,7 +1772,7 @@ When no active page context exists
 
 > **submit**(`selector?`, `options?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:841](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L841)
+Defined in: [packages/web-fetcher/src/engine/base.ts:756](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L756)
 
 Submits a form.
 
@@ -1424,11 +1802,39 @@ When no active page context exists
 
 ***
 
+### trim()
+
+> **trim**(`options`): `Promise`\<`void`\>
+
+Defined in: [packages/web-fetcher/src/engine/base.ts:767](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L767)
+
+Removes elements from the DOM based on selectors and presets.
+
+#### Parameters
+
+##### options
+
+[`TrimActionOptions`](../interfaces/TrimActionOptions.md)
+
+Trim options specifying selectors and presets
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise resolving when trim operation completes
+
+#### Throws
+
+When no active page context exists
+
+***
+
 ### waitFor()
 
 > **waitFor**(`params?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:806](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L806)
+Defined in: [packages/web-fetcher/src/engine/base.ts:721](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L721)
 
 Waits for specified condition before continuing.
 
@@ -1457,9 +1863,9 @@ await engine.waitFor({ selector: '#content' }); // Wait for element
 
 ### create()
 
-> `static` **create**(`ctx`, `options?`): `Promise`\<`undefined` \| `AnyFetchEngine`\>
+> `static` **create**(`ctx`, `options?`): `Promise`\<`AnyFetchEngine` \| `undefined`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:231](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L231)
+Defined in: [packages/web-fetcher/src/engine/base.ts:332](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L332)
 
 Factory method to create and initialize a fetch engine instance.
 
@@ -1479,7 +1885,7 @@ Configuration options
 
 #### Returns
 
-`Promise`\<`undefined` \| `AnyFetchEngine`\>
+`Promise`\<`AnyFetchEngine` \| `undefined`\>
 
 Initialized fetch engine instance
 
@@ -1495,9 +1901,9 @@ Primary entry point for engine creation. Selects appropriate implementation base
 
 ### get()
 
-> `static` **get**(`id`): `undefined` \| `AnyFetchEngineCtor`
+> `static` **get**(`id`): `AnyFetchEngineCtor` \| `undefined`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:204](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L204)
+Defined in: [packages/web-fetcher/src/engine/base.ts:305](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L305)
 
 Retrieves a fetch engine implementation by its unique ID.
 
@@ -1511,7 +1917,7 @@ The ID of the engine to retrieve
 
 #### Returns
 
-`undefined` \| `AnyFetchEngineCtor`
+`AnyFetchEngineCtor` \| `undefined`
 
 Engine class if found, otherwise `undefined`
 
@@ -1519,9 +1925,9 @@ Engine class if found, otherwise `undefined`
 
 ### getByMode()
 
-> `static` **getByMode**(`mode`): `undefined` \| `AnyFetchEngineCtor`
+> `static` **getByMode**(`mode`): `AnyFetchEngineCtor` \| `undefined`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:214](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L214)
+Defined in: [packages/web-fetcher/src/engine/base.ts:315](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L315)
 
 Retrieves a fetch engine implementation by execution mode.
 
@@ -1535,7 +1941,7 @@ Execution mode (`'http'` or `'browser'`)
 
 #### Returns
 
-`undefined` \| `AnyFetchEngineCtor`
+`AnyFetchEngineCtor` \| `undefined`
 
 Engine class if found, otherwise `undefined`
 
@@ -1545,7 +1951,7 @@ Engine class if found, otherwise `undefined`
 
 > `static` **register**(`engineClass`): `void`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:191](https://github.com/isdk/web-fetcher.js/blob/61e40bab9fc20e6de9e2060909d088d8c6cc7b99/src/engine/base.ts#L191)
+Defined in: [packages/web-fetcher/src/engine/base.ts:292](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L292)
 
 Registers a fetch engine implementation with the global registry.