Skip to main content

Class: Size

Defined in: bee-js/src/utils/size.ts:10

Represents a size in bytes.

Uses 1000 instead of 1024 for converting between units. This is to stay consistent with the Swarm papers on theoretical and effective storage capacity.

Methods

represent()

represent(): string

Defined in: bee-js/src/utils/size.ts:75

Returns

string


toBytes()

toBytes(): number

Defined in: bee-js/src/utils/size.ts:63

Returns

number


toFormattedString()

toFormattedString(): string

Defined in: bee-js/src/utils/size.ts:71

Returns

string


toGigabytes()

toGigabytes(): number

Defined in: bee-js/src/utils/size.ts:67

Returns

number


fromBytes()

static fromBytes(bytes): Size

Defined in: bee-js/src/utils/size.ts:21

Parameters

bytes

number

Returns

Size


fromGigabytes()

static fromGigabytes(gigabytes): Size

Defined in: bee-js/src/utils/size.ts:33

Parameters

gigabytes

number

Returns

Size


fromKilobytes()

static fromKilobytes(kilobytes): Size

Defined in: bee-js/src/utils/size.ts:25

Parameters

kilobytes

number

Returns

Size


fromMegabytes()

static fromMegabytes(megabytes): Size

Defined in: bee-js/src/utils/size.ts:29

Parameters

megabytes

number

Returns

Size


parseFromString()

static parseFromString(size): Size

Defined in: bee-js/src/utils/size.ts:59

Parses a size string and returns a Size instance.

Case insensitive. E.g. both "28MB" and "1gb" are valid.

Whitespaces are ignored. E.g. both "512 kb" and "2megabytes" are valid.

Decimal numbers are supported. E.g. "1.5gb" is valid.

Uses 1000 as the base for conversions. E.g. 1kb = 1000 bytes. This is consistent with the effective stamp utilization table.

Supported units:

  • b, byte, bytes
  • kb, kilobyte, kilobytes
  • mb, megabyte, megabytes
  • gb, gigabyte, gigabytes
  • tb, terabyte, terabytes

Parameters

size

string

A string representing a size

Returns

Size

a Size instance

💬 Get Help