DefaultProvider.md

downflux

---

downflux / DefaultProvider

Class: DefaultProvider

Defined in: packages/providers/default/DefaultProvider.ts:9

Default provider. Supports generic URL extraction.

Extends

• BaseProvider<DefaultExecArgs>

Constructors

Constructor

new DefaultProvider(url): DefaultProvider

Defined in: packages/providers/default/DefaultProvider.ts:12

Parameters

url

string

Returns

DefaultProvider

Overrides

BaseProvider.constructor

Properties

executionOptions

protected executionOptions: ExecutionOptions = {}

Defined in: packages/base/BaseProvider.ts:39

Inherited from

BaseProvider.executionOptions

---

httpOptions

protected httpOptions: HttpFetchOptions = {}

Defined in: packages/base/BaseProvider.ts:40

Inherited from

BaseProvider.httpOptions

---

deps

protected readonly deps: CoordinatorDependencies

Defined in: packages/base/BaseProvider.ts:41

Inherited from

BaseProvider.deps

---

urlPattern

protected readonly urlPattern: RegExp

Defined in: packages/base/BaseProvider.ts:43

Inherited from

BaseProvider.urlPattern

---

providerMetadata

protected readonly providerMetadata: ProviderMetadata

Defined in: packages/base/BaseProvider.ts:44

Inherited from

BaseProvider.providerMetadata

---

url

protected readonly url: string

Defined in: packages/base/BaseProvider.ts:52

Inherited from

BaseProvider.url

---

config

protected config: ProviderConfig

Defined in: packages/base/BaseProvider.ts:53

Inherited from

BaseProvider.config

---

provider

protected readonly provider: Default = Provider.Default

Defined in: packages/providers/default/DefaultProvider.ts:10

Overrides

BaseProvider.provider

Accessors

metadata

Get Signature

get protected metadata(): ProviderMetadata

Defined in: packages/base/BaseProvider.ts:47

Provider capabilities, integration status, and access restrictions.

Returns

ProviderMetadata

Inherited from

BaseProvider.metadata

---

ORIGIN

Get Signature

get protected ORIGIN(): string

Defined in: packages/base/BaseProvider.ts:81

Returns

string

Inherited from

BaseProvider.ORIGIN

---

HOST_NAME

Get Signature

get protected HOST_NAME(): string

Defined in: packages/base/BaseProvider.ts:85

Returns

string

Inherited from

BaseProvider.HOST_NAME

Methods

isValidHostName()

protected isValidHostName(): boolean

Defined in: packages/base/BaseProvider.ts:89

Returns

boolean

Inherited from

BaseProvider.isValidHostName

---

setAuth()

setAuth(auth): this

Defined in: packages/base/BaseProvider.ts:110

Sets authentication credentials for the provider.

Parameters

auth

AuthenticatedCrawlOptions

Authentication options including cookie, bearer token, CSRF token, API key, client ID, and user agent

Returns

this

Remarks

Configures HTTP headers and user agent based on provided authentication credentials. Supports multiple authentication methods: cookies, bearer tokens, CSRF tokens, API keys, and client IDs.

Inherited from

BaseProvider.setAuth

---

setHeaders()

setHeaders(headers): this

Defined in: packages/base/BaseProvider.ts:129

Sets custom HTTP headers.

Parameters

headers

Record<string, string>

Request header map

Returns

this

Inherited from

BaseProvider.setHeaders

---

setTimeout()

setTimeout(timeoutMs): this

Defined in: packages/base/BaseProvider.ts:138

Sets HTTP timeout.

Parameters

timeoutMs

number

Timeout in milliseconds

Returns

this

Inherited from

BaseProvider.setTimeout

---

setRetries()

setRetries(retries): this

Defined in: packages/base/BaseProvider.ts:147

Sets fetch retry count.

Parameters

retries

number

Retry attempt count

Returns

this

Inherited from

BaseProvider.setRetries

---

setTransformOutput()

setTransformOutput(transform?): this

Defined in: packages/base/BaseProvider.ts:156

Transform output to provider-specific result type.

Parameters

transform?

boolean = true

Default is true, which applies the default transformation. Set to false to return raw extracted data.

Returns

this

Inherited from

BaseProvider.setTransformOutput

---

setHttpOptions()

setHttpOptions(opts): this

Defined in: packages/base/BaseProvider.ts:165

Sets HTTP fetch options.

Parameters

opts

HttpFetchOptions

HTTP options to merge

Returns

this

Inherited from

BaseProvider.setHttpOptions

---

setNoDownload()

setNoDownload(noDownload?): this

Defined in: packages/base/BaseProvider.ts:175

Sets no download flag.

Parameters

noDownload?

boolean = false

No download flag

Returns

this

Default Value

false - set to true to skip the download phase and only perform extraction (useful for debugging or when you only need metadata)

Inherited from

BaseProvider.setNoDownload

---

setTranscodeOptions()

setTranscodeOptions(opts): this

Defined in: packages/base/BaseProvider.ts:188

Sets transcode options.

Parameters

opts

TranscodeOptions

Sometimes due to nature of the OS, the video might not play after download.

In such cases, you can set transcodeOptions to re-encode the video using ffmpeg which should resolve most compatibility issues. Make sure your OS can handle it

Returns

this

Inherited from

BaseProvider.setTranscodeOptions

---

setPreferredFormat()

setPreferredFormat(format): this

Defined in: packages/base/BaseProvider.ts:197

Sets preferred video format.

Parameters

format

VideoFormat

Video format (hls or mp4)

Returns

this

Inherited from

BaseProvider.setPreferredFormat

---

setPreferredCodec()

setPreferredCodec(codec): this

Defined in: packages/base/BaseProvider.ts:211

Sets preferred video codec.

Parameters

codec

VideoCodec

Video codec (h264 or av1)

This feature is still experimental not yet implemented for all providers.

It allows you to specify a preferred video codec which can help with compatibility or performance in some cases. If the provider supports it, it will try to download the video in the specified codec. If not available, it will fall back to the default behavior.

Returns

this

Inherited from

BaseProvider.setPreferredCodec

---

setJobOptions()

setJobOptions(opts): this

Defined in: packages/base/BaseProvider.ts:220

Sets ExecutionCoordinator options.

Parameters

opts

ExecutionOptions

Job options to merge

Returns

this

Inherited from

BaseProvider.setJobOptions

---

setAgentOptions()

setAgentOptions(opts): this

Defined in: packages/base/BaseProvider.ts:229

Sets HTTP agent options.

Parameters

opts

HttpAgentOptions

HTTP agent options to merge

Returns

this

Inherited from

BaseProvider.setAgentOptions

---

setMaxDownloads()

setMaxDownloads(maxDownloads): this

Defined in: packages/base/BaseProvider.ts:238

Sets maximum downloads.

Parameters

maxDownloads

number

Download limit

Returns

this

Inherited from

BaseProvider.setMaxDownloads

---

setAllowedExtensions()

setAllowedExtensions(...extensions): this

Defined in: packages/base/BaseProvider.ts:247

Sets allowed file extensions.

Parameters

extensions

...AllowedExtension[]

File extensions such as jpg or png

Returns

this

Inherited from

BaseProvider.setAllowedExtensions

---

onProgress()

onProgress(handler): this

Defined in: packages/base/BaseProvider.ts:256

Sets progress handler.

Parameters

handler

(event) => void

Progress event callback

Returns

this

Inherited from

BaseProvider.onProgress

---

setProgressLogging()

setProgressLogging(enabled?): this

Defined in: packages/base/BaseProvider.ts:266

Enables console progress logging.

Parameters

enabled?

boolean = true

Console logging flag

Returns

this

Default Value

true

Inherited from

BaseProvider.setProgressLogging

---

setOutput()

setOutput(type, config?): this

Defined in: packages/base/BaseProvider.ts:277

Sets output type.

Parameters

type

OutputType

Job output mode

config?

DirectoryOutputOptions = {}

Directory output configuration

Returns

this

Default Value

OutputType.JSON

Inherited from

BaseProvider.setOutput

---

setExecutionType()

setExecutionType(type): this

Defined in: packages/base/BaseProvider.ts:298

Sets execution strategy.

Parameters

type

ExecutionType

Execution mode

Returns

this

Default Value

ExecutionType.SEQUENTIAL

This feature is still experimental and not yet implemented for all providers. It allows you to specify the execution strategy for the extraction and download process.

• SEQUENTIAL: Extracts and downloads items one by one. This is the most compatible mode and should work with all providers, but can be slower for large batches.

• PARALLEL: Extracts all items first, then downloads them in parallel. This can be faster for large batches, but may cause issues with providers that have strict rate limits or anti-bot measures. Use with caution and test thoroughly if you choose to use PARALLEL execution.

Inherited from

BaseProvider.setExecutionType

---

buildRequest()

protected buildRequest(overrides?): DefaultExecArgs

Defined in: packages/base/BaseProvider.ts:309

Builds the execution request passed to the coordinator layer.

Parameters

overrides?

Partial<DefaultExecArgs>

Provider method options that should override defaults.

Returns

DefaultExecArgs

A typed request containing provider metadata and execution options.

Inherited from

BaseProvider.buildRequest

---

execute()

protected execute<TResult>(overrides): Promise<TResult>

Defined in: packages/base/BaseProvider.ts:330

Runs extraction and optional downloads through the shared coordinator.

Type Parameters

TResult

TResult

Parameters

overrides

{ entryUrl?: string; } | DefaultExecArgs & object

Provider method request data, including execution shape.

Returns

Promise<TResult>

Extracted output in the shape requested by the provider method.

Inherited from

BaseProvider.execute

---

makeTargets()

protected makeTargets(sourceUrl, range, provider, method, addTrailingSlash?): object

Defined in: packages/base/BaseProvider.ts:359

Builds paginated target URLs for list-like provider methods.

Parameters

sourceUrl

string

Base URL before the page number.

range

Range

Page or start/end range to expand.

provider

Provider

Provider used for range validation errors.

method

string

Provider method used for range validation errors.

addTrailingSlash?

boolean = true

Whether generated target URLs should end with /.

Returns

object

Provider, method, and generated target URLs.

targets

targets: string[]

provider

provider: Provider

method

method: string

Inherited from

BaseProvider.makeTargets

---

getLinks()

getLinks(): Promise<string[]>

Defined in: packages/providers/default/DefaultProvider.ts:35

Gets links.

Returns

Promise<string[]>

Extracted anchor result array

---

getImages()

getImages(): Promise<string[]>

Defined in: packages/providers/default/DefaultProvider.ts:49

Gets images.

Returns

Promise<string[]>

Extracted image result array

---

getVideos()

getVideos(): Promise<string[]>

Defined in: packages/providers/default/DefaultProvider.ts:63

Gets videos.

Returns

Promise<string[]>

Extracted video result array

---

getAudio()

getAudio(): Promise<string[]>

Defined in: packages/providers/default/DefaultProvider.ts:77

Gets audio.

Returns

Promise<string[]>

Extracted audio result array