Skip to main content

Class: File

Defined in: bee-js/src/modules/file.ts:16

Single-file operations backed by the /bzz endpoint.

Accessed as bee.file.

Constructors​

Constructor​

new File(context): File

Defined in: bee-js/src/modules/file.ts:17

Parameters​

context​

BeeContext

Returns​

File

Methods​

download()​

download(resource, path, options?, requestOptions?): Promise<FileData<Bytes>>

Defined in: bee-js/src/modules/file.ts:74

Downloads a single file.

Parameters​

resource​

Swarm reference, Swarm CID, or ENS domain.

string | Uint8Array<ArrayBufferLike> | Reference

path​

string = ''

If reference points to manifest, then this parameter defines path to the file

options?​

DownloadOptions

Options that affects the request behavior

requestOptions?​

BeeRequestOptions

Options for making requests, such as timeouts, custom HTTP agents, headers, etc.

Returns​

Promise<FileData<Bytes>>


downloadReadable()​

downloadReadable(reference, path, options?, requestOptions?): Promise<FileData<ReadableStream<Uint8Array<ArrayBufferLike>>>>

Defined in: bee-js/src/modules/file.ts:100

Downloads a single file as a readable stream.

Parameters​

reference​

Bee file reference in hex string (either 64 or 128 chars long), ENS domain or Swarm CID.

string | Uint8Array<ArrayBufferLike> | Reference

path​

string = ''

If reference points to manifest / collections, then this parameter defines path to the file

options?​

DownloadOptions

Options that affects the request behavior

requestOptions?​

BeeRequestOptions

Options for making requests, such as timeouts, custom HTTP agents, headers, etc.

Returns​

Promise<FileData<ReadableStream<Uint8Array<ArrayBufferLike>>>>


upload()​

upload(postageBatchId, data, name?, options?, requestOptions?): Promise<UploadResult>

Defined in: bee-js/src/modules/file.ts:30

Uploads a single file to a Bee node.

To download the file, use download.

Parameters​

postageBatchId​

Postage BatchId to be used to upload the data with

string | Uint8Array<ArrayBufferLike> | BatchId

data​

Data or file to be uploaded

string | Uint8Array<ArrayBufferLike> | File | Readable

name?​

string

Optional name of the uploaded file

options?​

FileUploadOptions

Additional options like tag, encryption, pinning, content-type and request options

requestOptions?​

BeeRequestOptions

Options for making requests, such as timeouts, custom HTTP agents, headers, etc.

Returns​

Promise<UploadResult>

💬 Get Help