@isdk/web-fetcher 0.2.11 → 0.3.0

package/docs/classes/FetchSession.md

@@ -6,15 +6,27 @@
 
 # Class: FetchSession
 
-Defined in: [packages/web-fetcher/src/core/session.ts:11](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L11)
+Defined in: [packages/web-fetcher/src/core/session.ts:24](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L24)
+
+Represents a stateful web fetching session.
+
+## Remarks
+
+A `FetchSession` manages the lifecycle of a single crawling operation, including engine initialization,
+cookie persistence, and sequential action execution. It maintains a `FetchContext` that stores
+session-level configurations and outputs.
+
+Sessions are isolated; each has its own unique ID and (by default) its own storage and cookies.
 
 ## Constructors
 
 ### Constructor
 
-> **new FetchSession**(`options`, `engine?`): `FetchSession`
+> **new FetchSession**(`options`): `FetchSession`
+
+Defined in: [packages/web-fetcher/src/core/session.ts:42](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L42)
 
-Defined in: [packages/web-fetcher/src/core/session.ts:18](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L18)
+Creates a new FetchSession.
 
 #### Parameters
 
@@ -22,9 +34,7 @@ Defined in: [packages/web-fetcher/src/core/session.ts:18](https://github.com/isd
 
 [`FetcherOptions`](../interfaces/FetcherOptions.md) = `{}`
 
-##### engine?
-
-`string`
+Configuration options for the fetcher.
 
 #### Returns
 
@@ -32,19 +42,21 @@ Defined in: [packages/web-fetcher/src/core/session.ts:18](https://github.com/isd
 
 ## Properties
 
-### context
+### closed
 
-> `readonly` **context**: [`FetchContext`](../interfaces/FetchContext.md)
+> `protected` **closed**: `boolean` = `false`
 
-Defined in: [packages/web-fetcher/src/core/session.ts:13](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L13)
+Defined in: [packages/web-fetcher/src/core/session.ts:35](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L35)
 
 ***
 
-### engine?
+### context
+
+> `readonly` **context**: [`FetchContext`](../interfaces/FetchContext.md)
 
-> `readonly` `optional` **engine**: `string`
+Defined in: [packages/web-fetcher/src/core/session.ts:32](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L32)
 
-Defined in: [packages/web-fetcher/src/core/session.ts:18](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L18)
+The execution context for this session, containing configurations, event bus, and shared state.
 
 ***
 
@@ -52,29 +64,88 @@ Defined in: [packages/web-fetcher/src/core/session.ts:18](https://github.com/isd
 
 > `readonly` **id**: `string`
 
-Defined in: [packages/web-fetcher/src/core/session.ts:12](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L12)
+Defined in: [packages/web-fetcher/src/core/session.ts:28](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L28)
+
+Unique identifier for the session.
+
+***
+
+### options
+
+> `protected` **options**: [`FetcherOptions`](../interfaces/FetcherOptions.md) = `{}`
+
+Defined in: [packages/web-fetcher/src/core/session.ts:42](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L42)
+
+Configuration options for the fetcher.
 
 ## Methods
 
+### \_logDebug()
+
+> `protected` **\_logDebug**(`category`, ...`args`): `void`
+
+Defined in: [packages/web-fetcher/src/core/session.ts:47](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L47)
+
+#### Parameters
+
+##### category
+
+`string`
+
+##### args
+
+...`any`[]
+
+#### Returns
+
+`void`
+
+***
+
+### createContext()
+
+> `protected` **createContext**(`options`): [`FetchContext`](../interfaces/FetchContext.md)
+
+Defined in: [packages/web-fetcher/src/core/session.ts:235](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L235)
+
+#### Parameters
+
+##### options
+
+[`FetcherOptions`](../interfaces/FetcherOptions.md) = `...`
+
+#### Returns
+
+[`FetchContext`](../interfaces/FetchContext.md)
+
+***
+
 ### dispose()
 
 > **dispose**(): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/core/session.ts:91](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L91)
+Defined in: [packages/web-fetcher/src/core/session.ts:204](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L204)
+
+Disposes of the session and its associated engine.
 
 #### Returns
 
 `Promise`\<`void`\>
 
+#### Remarks
+
+This method should be called when the session is no longer needed to free up resources
+(e.g., closing browser instances, purging temporary storage).
+
 ***
 
 ### execute()
 
-> **execute**\<`R`\>(`actionOptions`): `Promise`\<[`FetchActionResult`](../interfaces/FetchActionResult.md)\<`R`\>\>
+> **execute**\<`R`\>(`actionOptions`, `context`): `Promise`\<[`FetchActionResult`](../interfaces/FetchActionResult.md)\<`R`\>\>
 
-Defined in: [packages/web-fetcher/src/core/session.ts:27](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L27)
+Defined in: [packages/web-fetcher/src/core/session.ts:68](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L68)
 
-执行单个动作
+Executes a single action within the session.
 
 #### Type Parameters
 
@@ -82,23 +153,43 @@ Defined in: [packages/web-fetcher/src/core/session.ts:27](https://github.com/isd
 
 `R` *extends* [`FetchReturnType`](../type-aliases/FetchReturnType.md) = `"response"`
 
+The expected return type of the action.
+
 #### Parameters
 
 ##### actionOptions
 
 `_RequireAtLeastOne`
 
+Configuration for the action to be executed.
+
+##### context
+
+[`FetchContext`](../interfaces/FetchContext.md) = `...`
+
+Optional context override for this specific execution. Defaults to the session context.
+
 #### Returns
 
 `Promise`\<[`FetchActionResult`](../interfaces/FetchActionResult.md)\<`R`\>\>
 
+A promise that resolves to the result of the action.
+
+#### Example
+
+```ts
+await session.execute({ name: 'goto', params: { url: 'https://example.com' } });
+```
+
 ***
 
 ### executeAll()
 
-> **executeAll**(`actions`): `Promise`\<\{ `outputs`: `Record`\<`string`, `any`\>; `result`: `undefined` \| [`FetchResponse`](../interfaces/FetchResponse.md); \}\>
+> **executeAll**(`actions`, `options?`): `Promise`\<\{ `outputs`: `Record`\<`string`, `any`\>; `result`: [`FetchResponse`](../interfaces/FetchResponse.md) \| `undefined`; \}\>
 
-Defined in: [packages/web-fetcher/src/core/session.ts:61](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L61)
+Defined in: [packages/web-fetcher/src/core/session.ts:130](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L130)
+
+Executes a sequence of actions.
 
 #### Parameters
 
@@ -106,9 +197,29 @@ Defined in: [packages/web-fetcher/src/core/session.ts:61](https://github.com/isd
 
 `_RequireAtLeastOne`\<[`FetchActionProperties`](../interfaces/FetchActionProperties.md), `"name"` \| `"id"` \| `"action"`\>[]
 
+An array of action options to be executed in order.
+
+##### options?
+
+`Partial`\<[`FetcherOptions`](../interfaces/FetcherOptions.md)\> & `object`
+
+Optional temporary configuration overrides (e.g., timeoutMs, headers) for this batch of actions.
+                 These overrides do not affect the main session context.
+
 #### Returns
 
-`Promise`\<\{ `outputs`: `Record`\<`string`, `any`\>; `result`: `undefined` \| [`FetchResponse`](../interfaces/FetchResponse.md); \}\>
+`Promise`\<\{ `outputs`: `Record`\<`string`, `any`\>; `result`: [`FetchResponse`](../interfaces/FetchResponse.md) \| `undefined`; \}\>
+
+A promise that resolves to an object containing the result of the last action and all accumulated outputs.
+
+#### Example
+
+```ts
+const { result, outputs } = await session.executeAll([
+  { name: 'goto', params: { url: 'https://example.com' } },
+  { name: 'extract', params: { schema: { title: 'h1' } }, storeAs: 'data' }
+], { timeoutMs: 30000 });
+```
 
 ***
 
@@ -116,20 +227,28 @@ Defined in: [packages/web-fetcher/src/core/session.ts:61](https://github.com/isd
 
 > **getOutputs**(): `Record`\<`string`, `any`\>
 
-Defined in: [packages/web-fetcher/src/core/session.ts:83](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L83)
+Defined in: [packages/web-fetcher/src/core/session.ts:182](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L182)
+
+Retrieves all outputs accumulated during the session.
 
 #### Returns
 
 `Record`\<`string`, `any`\>
 
+A record of stored output data.
+
 ***
 
 ### getState()
 
-> **getState**(): `Promise`\<`undefined` \| \{ `cookies`: [`Cookie`](../interfaces/Cookie.md)[]; `sessionState?`: `any`; \}\>
+> **getState**(): `Promise`\<\{ `cookies`: [`Cookie`](../interfaces/Cookie.md)[]; `sessionState?`: `any`; \} \| `undefined`\>
 
-Defined in: [packages/web-fetcher/src/core/session.ts:87](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/core/session.ts#L87)
+Defined in: [packages/web-fetcher/src/core/session.ts:191](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/core/session.ts#L191)
+
+Gets the current state of the session, including cookies and engine-specific state.
 
 #### Returns
 
-`Promise`\<`undefined` \| \{ `cookies`: [`Cookie`](../interfaces/Cookie.md)[]; `sessionState?`: `any`; \}\>
+`Promise`\<\{ `cookies`: [`Cookie`](../interfaces/Cookie.md)[]; `sessionState?`: `any`; \} \| `undefined`\>
+
+A promise resolving to the session state, or undefined if no engine is initialized.

package/docs/classes/FillAction.md

@@ -6,7 +6,7 @@
 
 # Class: FillAction
 
-Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:4](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/definitions/fill.ts#L4)
+Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:4](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/definitions/fill.ts#L4)
 
 ## Extends
 
@@ -32,7 +32,7 @@ Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:4](https://gith
 
 > `static` **capabilities**: `object`
 
-Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:7](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/definitions/fill.ts#L7)
+Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:7](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/definitions/fill.ts#L7)
 
 #### browser
 
@@ -52,7 +52,7 @@ Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:7](https://gith
 
 > `static` **id**: `string` = `'fill'`
 
-Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:5](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/definitions/fill.ts#L5)
+Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:5](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/definitions/fill.ts#L5)
 
 #### Overrides
 
@@ -64,7 +64,7 @@ Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:5](https://gith
 
 > `static` **returnType**: `"none"`
 
-Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:6](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/definitions/fill.ts#L6)
+Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:6](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/definitions/fill.ts#L6)
 
 #### Overrides
 
@@ -78,7 +78,7 @@ Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:6](https://gith
 
 > **get** **capabilities**(): [`FetchActionCapabilities`](../type-aliases/FetchActionCapabilities.md)
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:139](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L139)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:163](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L163)
 
 ##### Returns
 
@@ -96,7 +96,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:139](https://github
 
 > **get** **id**(): `string`
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:131](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L131)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:155](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L155)
 
 ##### Returns
 
@@ -114,7 +114,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:131](https://github
 
 > **get** **returnType**(): [`FetchReturnType`](../type-aliases/FetchReturnType.md)
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:135](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L135)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:159](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L159)
 
 ##### Returns
 
@@ -130,7 +130,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:135](https://github
 
 > **afterExec**(`context`, `options?`, `result?`, `scope?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:313](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L313)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:391](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L391)
 
 Action 结束生命周期
 负责：调用钩子、赋值lastResult, 触发事件、清理 stack、恢复 currentAction
@@ -171,9 +171,9 @@ Action 结束生命周期
 
 ### beforeExec()
 
-> **beforeExec**(`context`, `options?`): `Promise`\<\{ `collectors`: `undefined` \| `CollectorsRuntime`; `entry`: [`FetchActionInContext`](../interfaces/FetchActionInContext.md); \}\>
+> **beforeExec**(`context`, `options?`): `Promise`\<\{ `collectors`: `CollectorsRuntime` \| `undefined`; `entry`: [`FetchActionInContext`](../interfaces/FetchActionInContext.md); \}\>
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:267](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L267)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:347](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L347)
 
 Action 开始生命周期
 负责：初始化 stack、设置 currentAction、触发事件、调用钩子
@@ -190,7 +190,7 @@ Action 开始生命周期
 
 #### Returns
 
-`Promise`\<\{ `collectors`: `undefined` \| `CollectorsRuntime`; `entry`: [`FetchActionInContext`](../interfaces/FetchActionInContext.md); \}\>
+`Promise`\<\{ `collectors`: `CollectorsRuntime` \| `undefined`; `entry`: [`FetchActionInContext`](../interfaces/FetchActionInContext.md); \}\>
 
 #### Inherited from
 
@@ -202,7 +202,7 @@ Action 开始生命周期
 
 > `protected` **delegateToEngine**(`context`, `method`, ...`args`): `Promise`\<`any`\>
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:150](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L150)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:184](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L184)
 
 #### Parameters
 
@@ -232,7 +232,7 @@ keyof [`FetchEngine`](FetchEngine.md)\<`any`, `any`, `any`\>
 
 > **execute**\<`R`\>(`context`, `options?`): `Promise`\<[`FetchActionResult`](../interfaces/FetchActionResult.md)\<`R`\>\>
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:365](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L365)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:448](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L448)
 
 #### Type Parameters
 
@@ -264,7 +264,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:365](https://github
 
 > **getCapability**(`mode?`): [`FetchActionCapabilityMode`](../type-aliases/FetchActionCapabilityMode.md)
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:126](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L126)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:150](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L150)
 
 #### Parameters
 
@@ -284,9 +284,9 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:126](https://github
 
 ### installCollectors()
 
-> `protected` **installCollectors**(`context`, `options?`): `undefined` \| `CollectorsRuntime`
+> `protected` **installCollectors**(`context`, `options?`): `CollectorsRuntime` \| `undefined`
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:167](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L167)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:201](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L201)
 
 #### Parameters
 
@@ -300,7 +300,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:167](https://github
 
 #### Returns
 
-`undefined` \| `CollectorsRuntime`
+`CollectorsRuntime` \| `undefined`
 
 #### Inherited from
 
@@ -312,7 +312,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:167](https://github
 
 > `protected` `optional` **onAfterExec**(`context`, `options?`): `void` \| `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:145](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L145)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:172](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L172)
 
 #### Parameters
 
@@ -338,7 +338,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:145](https://github
 
 > `protected` `optional` **onBeforeExec**(`context`, `options?`): `void` \| `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:144](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L144)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:168](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L168)
 
 #### Parameters
 
@@ -364,7 +364,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:144](https://github
 
 > **onExecute**(`context`, `options?`): `Promise`\<`void`\>
 
-Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:9](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/definitions/fill.ts#L9)
+Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:12](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/definitions/fill.ts#L12)
 
 #### Parameters
 
@@ -390,9 +390,9 @@ Defined in: [packages/web-fetcher/src/action/definitions/fill.ts:9](https://gith
 
 #### Call Signature
 
-> `static` **create**(`id`): `undefined` \| [`FetchAction`](FetchAction.md)
+> `static` **create**(`id`): [`FetchAction`](FetchAction.md) \| `undefined`
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:100](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L100)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:113](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L113)
 
 ##### Parameters
 
@@ -402,7 +402,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:100](https://github
 
 ##### Returns
 
-`undefined` \| [`FetchAction`](FetchAction.md)
+[`FetchAction`](FetchAction.md) \| `undefined`
 
 ##### Inherited from
 
@@ -410,9 +410,9 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:100](https://github
 
 #### Call Signature
 
-> `static` **create**(`id`): `undefined` \| [`FetchAction`](FetchAction.md)
+> `static` **create**(`id`): [`FetchAction`](FetchAction.md) \| `undefined`
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:101](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L101)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:114](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L114)
 
 ##### Parameters
 
@@ -422,7 +422,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:101](https://github
 
 ##### Returns
 
-`undefined` \| [`FetchAction`](FetchAction.md)
+[`FetchAction`](FetchAction.md) \| `undefined`
 
 ##### Inherited from
 
@@ -432,9 +432,9 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:101](https://github
 
 ### get()
 
-> `static` **get**(`id`): `undefined` \| *typeof* [`FetchAction`](FetchAction.md)
+> `static` **get**(`id`): *typeof* [`FetchAction`](FetchAction.md) \| `undefined`
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:96](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L96)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:109](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L109)
 
 #### Parameters
 
@@ -444,7 +444,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:96](https://github.
 
 #### Returns
 
-`undefined` \| *typeof* [`FetchAction`](FetchAction.md)
+*typeof* [`FetchAction`](FetchAction.md) \| `undefined`
 
 #### Inherited from
 
@@ -456,7 +456,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:96](https://github.
 
 > `static` **getCapability**(`mode?`): [`FetchActionCapabilityMode`](../type-aliases/FetchActionCapabilityMode.md)
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:122](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L122)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:146](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L146)
 
 #### Parameters
 
@@ -478,7 +478,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:122](https://github
 
 > `static` **has**(`name`): `boolean`
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:109](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L109)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:130](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L130)
 
 #### Parameters
 
@@ -500,7 +500,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:109](https://github
 
 > `static` **list**(): `string`[]
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:113](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L113)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:134](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L134)
 
 #### Returns
 
@@ -516,7 +516,7 @@ Defined in: [packages/web-fetcher/src/action/fetch-action.ts:113](https://github
 
 > `static` **register**(`actionClass`): `void`
 
-Defined in: [packages/web-fetcher/src/action/fetch-action.ts:90](https://github.com/isdk/web-fetcher.js/blob/1f3a81cc4fe8a2cf40fe3f3e8030d14a75c9d27c/src/action/fetch-action.ts#L90)
+Defined in: [packages/web-fetcher/src/action/fetch-action.ts:103](https://github.com/isdk/web-fetcher.js/blob/1f80c3c783d0455bd4ff73248c57c2c39ab9f7c9/src/action/fetch-action.ts#L103)
 
 #### Parameters