Buffer: {
    poolSize: number;
    prototype: Buffer;
    alloc(size, fill?, encoding?): Buffer;
    allocUnsafe(size): Buffer;
    allocUnsafeSlow(size): Buffer;
    byteLength(string, encoding?): number;
    compare(buf1, buf2): number;
    concat(list, totalLength?): Buffer;
    from(arrayBuffer, byteOffset?, length?): Buffer;
    from(data): Buffer;
    from(str, encoding?): Buffer;
    isBuffer(obj): obj is Buffer;
    isEncoding(encoding): boolean;
    new (str, encoding?): Buffer;
    new (size): Buffer;
    new (array): Buffer;
    new (arrayBuffer): Buffer;
    new (array): Buffer;
    new (buffer): Buffer;
}

Raw data is stored in instances of the Buffer class. A Buffer is similar to an array of integers but corresponds to a raw memory allocation outside the V8 heap. A Buffer cannot be resized. Valid string encodings: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'binary'(deprecated)|'hex'

Type declaration

    • new (str, encoding?): Buffer
    • Allocates a new buffer containing the given {str}.

      Parameters

      • str: string

        String to store in buffer.

      • Optional encoding: string

        encoding to use, optional. Default is 'utf8'

      Returns Buffer

    • new (size): Buffer
    • Allocates a new buffer of {size} octets.

      Parameters

      • size: number

        count of octets to allocate.

      Returns Buffer

    • new (array): Buffer
    • Allocates a new buffer containing the given {array} of octets.

      Parameters

      • array: Uint8Array

        The octets to store.

      Returns Buffer

    • new (arrayBuffer): Buffer
    • Produces a Buffer backed by the same allocated memory as the given {ArrayBuffer}.

      Parameters

      • arrayBuffer: ArrayBuffer

        The ArrayBuffer with which to share memory.

      Returns Buffer

    • new (array): Buffer
    • Allocates a new buffer containing the given {array} of octets.

      Parameters

      • array: readonly any[]

        The octets to store.

      Returns Buffer

    • new (buffer): Buffer
    • Copies the passed {buffer} data onto a new {Buffer} instance.

      Parameters

      • buffer: Buffer

        The buffer to copy.

      Returns Buffer

  • poolSize: number

    This is the number of bytes used to determine the size of pre-allocated, internal Buffer instances used for pooling. This value may be modified.

  • prototype: Buffer
  • alloc:function
    • Allocates a new buffer of {size} octets.

      Parameters

      • size: number

        count of octets to allocate.

      • Optional fill: string | number | Buffer

        if specified, buffer will be initialized by calling buf.fill(fill). If parameter is omitted, buffer will be filled with zeros.

      • Optional encoding: string

        encoding used for call to buf.fill while initalizing

      Returns Buffer

  • allocUnsafe:function
    • Allocates a new buffer of {size} octets, leaving memory not initialized, so the contents of the newly created Buffer are unknown and may contain sensitive data.

      Parameters

      • size: number

        count of octets to allocate

      Returns Buffer

  • allocUnsafeSlow:function
    • Allocates a new non-pooled buffer of {size} octets, leaving memory not initialized, so the contents of the newly created Buffer are unknown and may contain sensitive data.

      Parameters

      • size: number

        count of octets to allocate

      Returns Buffer

  • byteLength:function
    • Gives the actual byte length of a string. encoding defaults to 'utf8'. This is not the same as String.prototype.length since that returns the number of characters in a string.

      Parameters

      • string: string | Buffer | ArrayBuffer | DataView

        string to test. (TypedArray is also allowed, but it is only available starting ES2017)

      • Optional encoding: string

        encoding used to evaluate (defaults to 'utf8')

      Returns number

  • compare:function
    • The same as buf1.compare(buf2).

      Parameters

      Returns number

  • concat:function
    • Returns a buffer which is the result of concatenating all the buffers in the list together.

      If the list has no items, or if the totalLength is 0, then it returns a zero-length buffer. If the list has exactly one item, then the first item of the list is returned. If the list has more than one item, then a new Buffer is created.

      Parameters

      • list: readonly Buffer[]

        An array of Buffer objects to concatenate

      • Optional totalLength: number

        Total length of the buffers when concatenated. If totalLength is not provided, it is read from the buffers in the list. However, this adds an additional loop to the function, so it is faster to provide the length explicitly.

      Returns Buffer

  • from:function
    • When passed a reference to the .buffer property of a TypedArray instance, the newly created Buffer will share the same allocated memory as the TypedArray. The optional {byteOffset} and {length} arguments specify a memory range within the {arrayBuffer} that will be shared by the Buffer.

      Parameters

      • arrayBuffer: ArrayBuffer

        The .buffer property of a TypedArray or a new ArrayBuffer()

      • Optional byteOffset: number
      • Optional length: number

      Returns Buffer

    • Creates a new Buffer using the passed {data}

      Parameters

      • data: string | readonly any[] | Buffer | ArrayBuffer

        data to create a new Buffer

      Returns Buffer

    • Creates a new Buffer containing the given JavaScript string {str}. If provided, the {encoding} parameter identifies the character encoding. If not provided, {encoding} defaults to 'utf8'.

      Parameters

      • str: string
      • Optional encoding: string

      Returns Buffer

  • isBuffer:function
    • Returns true if {obj} is a Buffer

      Parameters

      • obj: any

        object to test.

      Returns obj is Buffer

  • isEncoding:function
    • Returns true if {encoding} is a valid encoding argument. Valid string encodings in Node 0.12: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'binary'(deprecated)|'hex'

      Parameters

      • encoding: string

        string to test.

      Returns boolean