Options
All
  • Public
  • Public/Protected
  • All
Menu

Class ObjectId

A class representation of the BSON ObjectId type.

Hierarchy

Index

Constructors

  • Create an ObjectId type

    Parameters

    • Optional inputId: string | number | Uint8Array | ObjectId | ObjectIdLike

      Can be a 24 character hex string, 12 byte binary Buffer, or a number.

    Returns ObjectId

Properties

cacheHexString: boolean

Accessors

  • get _bsontype(): "ObjectId"
  • Returns "ObjectId"

  • get id(): Uint8Array
  • set id(value: Uint8Array): void
  • The ObjectId bytes

    readonly

    Returns Uint8Array

  • The ObjectId bytes

    readonly

    Parameters

    • value: Uint8Array

    Returns void

Methods

  • Compares the equality of this ObjectId with otherID.

    Parameters

    Returns boolean

  • getTimestamp(): Date
  • Returns the generation date (accurate up to the second) that this ID was generated.

    Returns Date

  • inspect(): string
  • Returns string

  • toHexString(): string
  • Returns the ObjectId id as a 24 character hex string representation

    Returns string

  • toJSON(): string
  • Converts to its JSON the 24 character hex string representation.

    Returns string

  • toString(encoding?: "base64" | "hex"): string
  • Converts the id into a 24 character hex string for printing, unless encoding is provided.

    Parameters

    • Optional encoding: "base64" | "hex"

      hex or base64

    Returns string

  • createFromBase64(base64: string): ObjectId
  • Creates an ObjectId instance from a base64 string

    Parameters

    • base64: string

    Returns ObjectId

  • createFromHexString(hexString: string): ObjectId
  • Creates an ObjectId from a hex string representation of an ObjectId.

    Parameters

    • hexString: string

      create a ObjectId from a passed in 24 character hexstring.

    Returns ObjectId

  • Creates an ObjectId from a second based number, with the rest of the ObjectId zeroed out. Used for comparisons or sorting the ObjectId.

    Parameters

    • time: number

      an integer number representing a number of seconds.

    Returns ObjectId

  • generate(time?: number): Uint8Array
  • Generate a 12 byte id buffer used in ObjectId's

    Parameters

    • Optional time: number

      pass in a second based timestamp.

    Returns Uint8Array

  • Checks if a value is a valid bson ObjectId

    Parameters

    Returns boolean

Generated using TypeDoc