Class ActorHttpRetry

A base actor for listening to HTTP events.

Actor types:

Input: IActionHttp: The HTTP request.
Test: IActorHttpTest: An estimate for the response time.
Output: IActorHttpOutput: The HTTP response.

See

IActionHttp
IActorHttpTest
IActorHttpOutput

Hierarchy (View Summary)

ActorHttp
- ActorHttpRetry

Constructors

constructor

new ActorHttpRetry(args: IActorHttpQueueArgs): ActorHttpRetry
Parameters
- args: IActorHttpQueueArgs
Returns ActorHttpRetry
Overrides ActorHttp.constructor
- Defined in actor-http-retry/lib/ActorHttpRetry.ts:24

Properties

`Readonly`beforeActors

beforeActors: Actor<IActionHttp, IActorTest, IActorHttpOutput, undefined>[] = []

Actor that must be registered in the bus before this actor.

`Readonly`bus

bus: Bus<
    Actor<IActionHttp, IActorTest, IActorHttpOutput, undefined>,
    IActionHttp,
    IActorTest,
    IActorHttpOutput,
    undefined,
>

The bus this actor subscribes to.

`Readonly`name

name: string

The name for this actor.

Default

{<rdf:subject>}

Methods

`Protected`getDefaultLogData

getDefaultLogData(context: IActionContext, data?: () => any): any
Parameters
- context: IActionContext
- Optionaldata: () => any
Returns any
Inherited from ActorHttp.getDefaultLogData
- Defined in core/lib/Actor.ts:95

handleHttpInvalidateEvent

handleHttpInvalidateEvent(action: IActionHttpInvalidate): void
Handles HTTP cache invalidation events.
Parameters
- action: IActionHttpInvalidate
  The invalidation action
Returns void
- Defined in actor-http-retry/lib/ActorHttpRetry.ts:214

`Protected`logDebug

logDebug(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorHttp.logDebug
- Defined in core/lib/Actor.ts:108

`Protected`logError

logError(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorHttp.logError
- Defined in core/lib/Actor.ts:129

`Protected`logFatal

logFatal(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorHttp.logFatal
- Defined in core/lib/Actor.ts:136

`Protected`logInfo

logInfo(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorHttp.logInfo
- Defined in core/lib/Actor.ts:115

`Protected`logTrace

logTrace(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorHttp.logTrace
- Defined in core/lib/Actor.ts:101

`Protected`logWarn

logWarn(context: IActionContext, message: string, data?: () => any): void
Parameters
- context: IActionContext
- message: string
- Optionaldata: () => any
Returns void
Inherited from ActorHttp.logWarn
- Defined in core/lib/Actor.ts:122

run

run(action: IActionHttp): Promise<IActorHttpOutput>
Run the given action on this actor.

In most cases, this method should not be called directly. Instead, #runObservable should be called.
Parameters
- action: IActionHttp
  The action to run.
Returns Promise<IActorHttpOutput>
A promise that resolves to the run result.
Overrides ActorHttp.run
- Defined in actor-http-retry/lib/ActorHttpRetry.ts:43

runObservable

runObservable(
action: IActionHttp,
sideData: undefined,
): Promise<IActorHttpOutput>
Run the given action on this actor AND invokes the Bus#onRun method.
Parameters
- action: IActionHttp
  The action to run.
- sideData: undefined
Returns Promise<IActorHttpOutput>
A promise that resolves to the run result.
Inherited from ActorHttp.runObservable
- Defined in core/lib/Actor.ts:87

test

test(action: IActionHttp): Promise<TestResult<IMediatorTypeTime>>
Check if this actor can run the given action, without actually running it.
Parameters
- action: IActionHttp
  The action to test.
Returns Promise<TestResult<IMediatorTypeTime>>
A promise that resolves to the test result.
Overrides ActorHttp.test
- Defined in actor-http-retry/lib/ActorHttpRetry.ts:32

`Static`createUserAgent

createUserAgent(actorName: string, actorVersion: string): undefined | string
Creates an appropriate User-Agent header string for Node.js or other environments. Within browsers, returns undefined, because the value should not be overridden due to potential CORS issues.
Parameters
- actorName: string
- actorVersion: string
Returns undefined | string
Inherited from ActorHttp.createUserAgent
- Defined in bus-http/lib/ActorHttp.ts:79

`Static`getContextLogger

getContextLogger(context: IActionContext): undefined | Logger
Get the logger from the given context.
Parameters
- context: IActionContext
  An optional context.
Returns undefined | Logger
The logger or undefined.
Inherited from ActorHttp.getContextLogger
- Defined in core/lib/Actor.ts:56

`Static`getInputUrl

getInputUrl(input: RequestInfo | URL): URL
Extract the requested URL from the action input.
Parameters
- input: RequestInfo | URL
  The request input.
Returns URL
The extracted URL.
Inherited from ActorHttp.getInputUrl
- Defined in bus-http/lib/ActorHttp.ts:71

`Static`headersToHash

headersToHash(headers: Headers): Record<string, string>
Convert the given headers object into a raw hash.
Parameters
- headers: Headers
  A headers object.
Returns Record<string, string>
Inherited from ActorHttp.headersToHash
- Defined in bus-http/lib/ActorHttp.ts:57

`Static`isBrowser

isBrowser(): boolean
Attempts to determine whether the current environment is a browser or not.

Returns boolean
True for browsers and web workers, false for other runtimes.
Inherited from ActorHttp.isBrowser
- Defined in bus-http/lib/ActorHttp.ts:114

`Static`parseRetryAfterHeader

parseRetryAfterHeader(retryAfter: string): undefined | Date
Parses a Retry-After HTTP header value following the specification: https://httpwg.org/specs/rfc9110.html#field.retry-after
Parameters
- retryAfter: string
  The raw header value as string
Returns undefined | Date
The parsed Date object, or undefined in case of invalid header value
- Defined in actor-http-retry/lib/ActorHttpRetry.ts:201

`Static`sleep

sleep(ms: number): Promise<void>
Sleeps for the specified amount of time, using a timeout
Parameters
- ms: number
  The amount of milliseconds to sleep
Returns Promise<void>
- Defined in actor-http-retry/lib/ActorHttpRetry.ts:189

`Static`toNodeReadable

toNodeReadable(body: null | ReadableStream<any>): ReadableStream
Converts WhatWG streams to Node streams if required. Returns the input in case the stream already is a Node stream.
Parameters
- body: null | ReadableStream<any>
Returns ReadableStream
A node stream.
Inherited from ActorHttp.toNodeReadable
- Defined in bus-http/lib/ActorHttp.ts:38

`Static`toWebReadableStream

toWebReadableStream(body: null | ReadableStream): ReadableStream
Converts Node streams to WhatWG streams.
Parameters
- body: null | ReadableStream
Returns ReadableStream
A web stream.
Inherited from ActorHttp.toWebReadableStream
- Defined in bus-http/lib/ActorHttp.ts:49

Class ActorHttpRetry

See

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ActorHttpRetry

Properties

ReadonlybeforeActors

Readonlybus

Readonlyname

Default

Methods

ProtectedgetDefaultLogData

Parameters

Returns any

handleHttpInvalidateEvent

Parameters

Returns void

ProtectedlogDebug

Parameters

Returns void

ProtectedlogError

Parameters

Returns void

ProtectedlogFatal

Parameters

Returns void

ProtectedlogInfo

Parameters

Returns void

ProtectedlogTrace

Parameters

Returns void

ProtectedlogWarn

Parameters

Returns void

run

Parameters

Returns Promise<IActorHttpOutput>

runObservable

Parameters

Returns Promise<IActorHttpOutput>

test

Parameters

Returns Promise<TestResult<IMediatorTypeTime>>

StaticcreateUserAgent

Parameters

Returns undefined | string

StaticgetContextLogger

Parameters

Returns undefined | Logger

StaticgetInputUrl

Parameters

Returns URL

StaticheadersToHash

Parameters

Returns Record<string, string>

StaticisBrowser

Returns boolean

StaticparseRetryAfterHeader

Parameters

Returns undefined | Date

Staticsleep

Parameters

Returns Promise<void>

StatictoNodeReadable

Parameters

Returns ReadableStream

StatictoWebReadableStream

Parameters

Returns ReadableStream

Settings

On This Page

`Readonly`beforeActors

`Readonly`bus

`Readonly`name

`Protected`getDefaultLogData

`Protected`logDebug

`Protected`logError

`Protected`logFatal

`Protected`logInfo

`Protected`logTrace

`Protected`logWarn

`Static`createUserAgent

`Static`getContextLogger

`Static`getInputUrl

`Static`headersToHash

`Static`isBrowser

`Static`parseRetryAfterHeader

`Static`sleep

`Static`toNodeReadable

`Static`toWebReadableStream