@isdk/web-fetcher 0.2.11 → 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:144](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L144)
+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:144](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:144](https://github.com/isd
 
 > `protected` `optional` **\_initialCookies**: [`Cookie`](../interfaces/Cookie.md)[]
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:241](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L241)
+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:241](https://github.com/isd
 
 > `protected` **\_initializedSessions**: `Set`\<`string`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:242](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L242)
+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:242](https://github.com/isd
 
 > `protected` **actionEmitter**: `EventEmitter`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:246](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L246)
+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:246](https://github.com/isd
 
 > `protected` **blockedTypes**: `Set`\<`string`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:251](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L251)
+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:251](https://github.com/isd
 
 > `protected` `optional` **config**: `Configuration`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:235](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L235)
+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:235](https://github.com/isd
 
 > `protected` `optional` **crawler**: `TCrawler`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:232](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L232)
+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:232](https://github.com/isd
 
 > `protected` `optional` **crawlerRunPromise**: `Promise`\<`FinalStatistics`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:234](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L234)
+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:234](https://github.com/isd
 
 > `protected` `optional` **ctx**: [`FetchEngineContext`](../interfaces/FetchEngineContext.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:230](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L230)
+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:230](https://github.com/isd
 
 > `protected` `optional` **currentSession**: `Session`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:243](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L243)
+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:243](https://github.com/isd
 
 > `protected` **hdrs**: `Record`\<`string`, `string`\> = `{}`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:240](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L240)
+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:240](https://github.com/isd
 
 > `protected` `optional` **isCrawlerReady**: `boolean`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:233](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L233)
+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:233](https://github.com/isd
 
 > `protected` **isEngineDisposed**: `boolean` = `false`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:248](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L248)
+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:248](https://github.com/isd
 
 > `protected` **isPageActive**: `boolean` = `false`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:247](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L247)
+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:247](https://github.com/isd
 
 > `protected` `optional` **kvStore**: `KeyValueStore`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:237](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L237)
+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:237](https://github.com/isd
 
 > `protected` `optional` **lastResponse**: [`FetchResponse`](../interfaces/FetchResponse.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:250](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L250)
+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:250](https://github.com/isd
 
 > `protected` **navigationLock**: `PromiseLock`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:249](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L249)
+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:249](https://github.com/isd
 
 > `protected` `optional` **opts**: [`BaseFetcherProperties`](../interfaces/BaseFetcherProperties.md)
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:231](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L231)
+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:231](https://github.com/isd
 
 > `protected` **pendingRequests**: `Map`\<`string`, [`PendingEngineRequest`](../interfaces/PendingEngineRequest.md)\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:244](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L244)
+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:244](https://github.com/isd
 
 > `protected` `optional` **proxyConfiguration**: `ProxyConfiguration`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:238](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L238)
+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:238](https://github.com/isd
 
 > `protected` **requestCounter**: `number` = `0`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:245](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L245)
+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:245](https://github.com/isd
 
 > `protected` `optional` **requestQueue**: `RequestQueue`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:236](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L236)
+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:236](https://github.com/isd
 
 > `readonly` `static` **id**: `string`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:220](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L220)
+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:228](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L228)
+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:528](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L528)
+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:503](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L503)
+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:521](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L521)
+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:326](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L326)
+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:253](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L253)
+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:253](https://github.com/isd
 
 > `protected` **\_commonCleanup**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:781](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L781)
+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:781](https://github.com/isd
 
 ***
 
+### \_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:308](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L308)
+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:681](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L681)
+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:258](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L258)
+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,21 +502,141 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:258](https://github.com/isd
 
 `ExtractSchema`
 
-##### context
+##### scope
 
 `any`
 
+##### parentStrict?
+
+`boolean`
+
 #### Returns
 
 `Promise`\<`any`\>
 
 ***
 
+### \_extractColumnar()
+
+> `protected` **\_extractColumnar**(`schema`, `container`, `opts?`): `Promise`\<`any`[] \| `null`\>
+
+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`**
+
+Performs columnar extraction (Column Alignment Mode).
+
+#### Parameters
+
+##### schema
+
+`ExtractSchema`
+
+The schema for a single item (must be an object or implicit object).
+
+##### container
+
+`any`
+
+The container element to search within.
+
+##### opts?
+
+`ColumnarOptions`
+
+Columnar extraction options (strict, inference).
+
+#### Returns
+
+`Promise`\<`any`[] \| `null`\>
+
+An array of extracted items, or null if requirements aren't met.
+
+***
+
+### \_extractNested()
+
+> `protected` **\_extractNested**(`items`, `elements`, `opts?`): `Promise`\<`any`[]\>
+
+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`**
+
+Performs standard nested array extraction.
+
+#### Parameters
+
+##### items
+
+`ExtractSchema`
+
+The schema for each item.
+
+##### elements
+
+`any`[]
+
+The list of item elements.
+
+##### opts?
+
+###### strict?
+
+`boolean`
+
+#### Returns
+
+`Promise`\<`any`[]\>
+
+***
+
+### \_extractSegmented()
+
+> `protected` **\_extractSegmented**(`schema`, `container`, `opts?`): `Promise`\<`any`[] \| `null`\>
+
+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`**
+
+Performs segmented extraction (Anchor-based Scanning).
+
+#### Parameters
+
+##### schema
+
+`ExtractSchema`
+
+The schema for a single item (must be an object).
+
+##### container
+
+`any`
+
+The container element to scan.
+
+##### opts?
+
+`SegmentedOptions`
+
+Segmented extraction options (anchor).
+
+#### Returns
+
+`Promise`\<`any`[] \| `null`\>
+
+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:256](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L256)
+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`**
+
+Extracts a primitive value from the element based on schema.
 
 #### Parameters
 
@@ -448,21 +644,171 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:256](https://github.com/isd
 
 `ExtractValueSchema`
 
-##### context
+Value extraction schema.
+
+##### 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 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:315](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L315)
+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`**
 
@@ -482,51 +828,290 @@ The fetch engine context.
 
 ***
 
-### \_normalizeSchema()
+### \_getTrimInfo()
 
-> `protected` **\_normalizeSchema**(`schema`): `ExtractSchema`
+> `protected` **\_getTrimInfo**(`options`): `object`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:459](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L459)
+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
 
-`ExtractSchema`
+[`TrimActionOptions`](../interfaces/TrimActionOptions.md)
 
 #### Returns
 
-`ExtractSchema`
+`object`
+
+##### removeComments
+
+> **removeComments**: `boolean`
+
+##### removeHidden
+
+> **removeHidden**: `boolean`
+
+##### selectors
+
+> **selectors**: `string`[] = `allSelectors`
 
 ***
 
-### \_querySelectorAll()
+### \_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` **\_isSameElement**(`scope1`, `scope2`): `Promise`\<`boolean`\>
+
+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 identity.
+
+#### Parameters
+
+##### scope1
+
+`any`
+
+First element scope.
+
+##### scope2
+
+`any`
+
+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` **\_nextSiblingsUntil**(`scope`, `untilSelector?`): `Promise`\<`any`[]\>
+
+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`**
+
+Gets all subsequent siblings of an element until a sibling matches the selector.
+Used in 'segmented' extraction mode.
+
+#### Parameters
+
+##### scope
+
+`any`
+
+The anchor element scope.
+
+##### untilSelector?
+
+`string`
+
+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:555](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/engine/base.ts#L555)
+
+**`Internal`**
+
+Normalizes the array extraction mode into an options object.
+
+#### Parameters
+
+##### mode?
 
-> `abstract` `protected` **\_querySelectorAll**(`context`, `selector`): `Promise`\<`any`[]\>
+`ExtractArrayMode`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:255](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L255)
+The mode string or options object.
+
+#### Returns
+
+`any`
+
+***
+
+### \_parentElement()
+
+> `abstract` **\_parentElement**(`scope`): `Promise`\<`any`\>
+
+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
+
+##### scope
+
+`any`
+
+The element scope.
+
+#### Returns
+
+`Promise`\<`any`\>
+
+Parent element or null.
+
+#### Implementation of
+
+`IExtractEngine._parentElement`
+
+***
+
+### \_processAction()
+
+> `protected` **\_processAction**(`context`, `action`): `Promise`\<`any`\>
+
+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`**
+
+Unified action processor that handles engine-agnostic actions.
 
 #### Parameters
 
 ##### context
 
+`TContext`
+
+Crawlee crawling context
+
+##### action
+
+[`FetchEngineAction`](../type-aliases/FetchEngineAction.md)
+
+Action to execute
+
+#### Returns
+
+`Promise`\<`any`\>
+
+***
+
+### \_querySelectorAll()
+
+> `abstract` **\_querySelectorAll**(`scope`, `selector`): `Promise`\<`any`[]\>
+
+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 scope.
+
+#### Parameters
+
+##### scope
+
 `any`
 
+The scope to search in (Engine-specific element/node or array of nodes).
+
 ##### selector
 
 `string`
 
+CSS selector.
+
 #### Returns
 
 `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:748](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L748)
+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
 
@@ -548,7 +1133,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:748](https://github.com/isd
 
 > `protected` **\_sharedRequestHandler**(`context`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:713](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L713)
+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
 
@@ -566,7 +1151,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:713](https://github.com/isd
 
 > **blockResources**(`types`, `overwrite?`): `Promise`\<`number`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:840](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L840)
+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.
 
@@ -603,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:327](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L327)
+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
 
@@ -621,7 +1206,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:327](https://github.com/isd
 
 > **cleanup**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:645](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L645)
+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
 
@@ -633,7 +1218,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:645](https://github.com/isd
 
 > **click**(`selector`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:409](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L409)
+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.
 
@@ -663,7 +1248,7 @@ When no active page context exists
 
 > **cookies**(): `Promise`\<[`Cookie`](../interfaces/Cookie.md)[]\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:951](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L951)
+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.
 
@@ -688,7 +1273,7 @@ await engine.cookies([{ name: 'session', value: '123' }]);
 
 > **cookies**(`cookies`): `Promise`\<`boolean`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:952](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L952)
+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.
 
@@ -723,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:764](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L764)
+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
 
@@ -747,7 +1332,7 @@ Defined in: [packages/web-fetcher/src/engine/base.ts:764](https://github.com/isd
 
 > **dispose**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:987](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L987)
+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.
 
@@ -759,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:370](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L370)
+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`**
 
@@ -799,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:454](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L454)
+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.
 
@@ -829,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:421](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L421)
+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.
 
@@ -863,7 +1490,7 @@ When no active page context exists
 
 > **getContent**(): `Promise`\<[`FetchResponse`](../interfaces/FetchResponse.md)\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:854](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L854)
+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.
 
@@ -883,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:511](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L511)
+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.
@@ -898,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:384](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L384)
+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.
 
@@ -936,7 +1563,7 @@ await engine.goto('https://example.com');
 
 > **headers**(): `Promise`\<`Record`\<`string`, `string`\>\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:893](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L893)
+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.
 
@@ -963,7 +1590,7 @@ await engine.headers('auth', 'token');
 
 > **headers**(`name`): `Promise`\<`string`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:894](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L894)
+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.
 
@@ -998,7 +1625,7 @@ await engine.headers('auth', 'token');
 
 > **headers**(`headers`, `replaced?`): `Promise`\<`boolean`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:895](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L895)
+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.
 
@@ -1039,7 +1666,7 @@ await engine.headers('auth', 'token');
 
 > **headers**(`name`, `value`): `Promise`\<`boolean`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:896](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L896)
+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.
 
@@ -1057,7 +1684,7 @@ Header name
 
 Header value or `null` to remove
 
-`null` | `string`
+`string` | `null`
 
 ##### Returns
 
@@ -1082,7 +1709,7 @@ await engine.headers('auth', 'token');
 
 > **initialize**(`context`, `options?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:543](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L543)
+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.
 
@@ -1117,7 +1744,7 @@ Automatically called when creating engine via `FetchEngine.create()`.
 
 > **pause**(`message?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:444](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L444)
+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.
 
@@ -1145,7 +1772,7 @@ When no active page context exists
 
 > **submit**(`selector?`, `options?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:433](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L433)
+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.
 
@@ -1175,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:398](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L398)
+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.
 
@@ -1208,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:203](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L203)
+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.
 
@@ -1230,7 +1885,7 @@ Configuration options
 
 #### Returns
 
-`Promise`\<`undefined` \| `AnyFetchEngine`\>
+`Promise`\<`AnyFetchEngine` \| `undefined`\>
 
 Initialized fetch engine instance
 
@@ -1246,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:176](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L176)
+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.
 
@@ -1262,7 +1917,7 @@ The ID of the engine to retrieve
 
 #### Returns
 
-`undefined` \| `AnyFetchEngineCtor`
+`AnyFetchEngineCtor` \| `undefined`
 
 Engine class if found, otherwise `undefined`
 
@@ -1270,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:186](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L186)
+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.
 
@@ -1286,7 +1941,7 @@ Execution mode (`'http'` or `'browser'`)
 
 #### Returns
 
-`undefined` \| `AnyFetchEngineCtor`
+`AnyFetchEngineCtor` \| `undefined`
 
 Engine class if found, otherwise `undefined`
 
@@ -1296,7 +1951,7 @@ Engine class if found, otherwise `undefined`
 
 > `static` **register**(`engineClass`): `void`
 
-Defined in: [packages/web-fetcher/src/engine/base.ts:163](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/engine/base.ts#L163)
+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.