Class UUID

A class representation of the BSON UUID type.

Hierarchy (view full)

Constructors

constructor

Properties

_bsontype buffer position sub_type BUFFER_SIZE SUBTYPE_BYTE_ARRAY SUBTYPE_COLUMN SUBTYPE_DEFAULT SUBTYPE_ENCRYPTED SUBTYPE_FUNCTION SUBTYPE_MD5 SUBTYPE_USER_DEFINED SUBTYPE_UUID SUBTYPE_UUID_OLD cacheHexString

Accessors

id

Methods

equals inspect length put read toBinary toHexString toJSON toString toUUID value write createFromHexString generate isValid

Constructors

constructor

  • new UUID(input?): UUID

  • Create an UUID type

    Parameters

    • Optional input: string | UUID | Uint8Array

      Can be a 32 or 36 character hex string (dashes excluded/included) or a 16 byte binary Buffer.

    Returns UUID

Properties

_bsontype

_bsontype: "Binary"

buffer

buffer: Uint8Array

position

position: number

sub_type

sub_type: number

Static Readonly BUFFER_SIZE

BUFFER_SIZE: 256 = 256

Initial buffer default size

Static Readonly SUBTYPE_BYTE_ARRAY

SUBTYPE_BYTE_ARRAY: 2 = 2

Byte Array BSON type

Static Readonly SUBTYPE_COLUMN

SUBTYPE_COLUMN: 7 = 7

Column BSON type

Static Readonly SUBTYPE_DEFAULT

SUBTYPE_DEFAULT: 0 = 0

Default BSON type

Static Readonly SUBTYPE_ENCRYPTED

SUBTYPE_ENCRYPTED: 6 = 6

Encrypted BSON type

Static Readonly SUBTYPE_FUNCTION

SUBTYPE_FUNCTION: 1 = 1

Function BSON type

Static Readonly SUBTYPE_MD5

SUBTYPE_MD5: 5 = 5

MD5 BSON type

Static Readonly SUBTYPE_USER_DEFINED

SUBTYPE_USER_DEFINED: 128 = 128

User BSON type

Static Readonly SUBTYPE_UUID

SUBTYPE_UUID: 4 = 4

UUID BSON type

Static Readonly SUBTYPE_UUID_OLD

SUBTYPE_UUID_OLD: 3 = 3

Deprecated UUID BSON type

Deprecated

Please use SUBTYPE_UUID

Static cacheHexString

cacheHexString: boolean

Accessors

id

  • get id(): Uint8Array

  • The UUID bytes

    Returns Uint8Array

Methods

equals

  • equals(otherId): boolean

  • Compares the equality of this UUID with otherID.

    Parameters

    • otherId: string | UUID | Uint8Array

      UUID instance to compare against.

    Returns boolean

inspect

  • inspect(): string

  • Returns string

length

  • length(): number

  • the length of the binary sequence

    Returns number

put

  • put(byteValue): void

  • Updates this binary with byte_value.

    Parameters

    • byteValue: string | number | number[] | Uint8Array

      a single byte we wish to write.

    Returns void

read

  • read(position, length): BinarySequence

  • Reads length bytes starting at position.

    Parameters

    • position: number

      read from the given position in the Binary.

    • length: number

      the number of bytes to read.

    Returns BinarySequence

toBinary

  • toBinary(): Binary

  • Creates a Binary instance from the current UUID.

    Returns Binary

toHexString

  • toHexString(includeDashes?): string

  • Returns the UUID id as a 32 or 36 character hex string representation, excluding/including dashes (defaults to 36 character dash separated)

    Parameters

    • Optional includeDashes: boolean

      should the string exclude dash-separators.

    Returns string

toJSON

  • toJSON(): string

  • Converts the id into its JSON string representation. A 36 character (dashes included) hex string in the format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

    Returns string

toString

  • toString(encoding?): string

  • Converts the id into a 36 character (dashes included) hex string, unless a encoding is specified.

    Parameters

    • Optional encoding: string

    Returns string

toUUID

value

  • value(asRaw?): string | BinarySequence

  • Returns the value of this binary as a string.

    Parameters

    • Optional asRaw: boolean

      Will skip converting to a string

    Returns string | BinarySequence

    Remarks

    This is handy when calling this function conditionally for some key value pairs and not others

write

  • write(sequence, offset): void

  • Writes a buffer or string to the binary.

    Parameters

    • sequence: string | BinarySequence

      a string or buffer to be written to the Binary BSON object.

    • offset: number

      specify the binary of where to write the content.

    Returns void

Static createFromHexString

  • createFromHexString(hexString): UUID

  • Creates an UUID from a hex string representation of an UUID.

    Parameters

    • hexString: string

      32 or 36 character hex string (dashes excluded/included).

    Returns UUID

Static generate

  • generate(): Uint8Array

  • Generates a populated buffer containing a v4 uuid

    Returns Uint8Array

Static isValid

  • isValid(input): boolean

  • Checks if a value is a valid bson UUID

    Parameters

    • input: string | UUID | Uint8Array

      UUID, string or Buffer to validate.

    Returns boolean

Settings

Member Visibility

Theme

On This Page

Generated using TypeDoc