A ponyfill for Buffer.from
Switch branches/tags
Nothing to show
Clone or download
Latest commit 53f4641 Jul 31, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore 🚀 Initial commit Aug 18, 2016
LICENSE 🌹 Add MIT license file Apr 17, 2018
index.js 🎉 Remove external dependencies Mar 12, 2018
package-lock.json 🚢 1.1.1 Jul 31, 2018
package.json 🚢 1.1.1 Jul 31, 2018
readme.md Link to ponyfill explanation Sep 30, 2016
test.js 🚀 Initial commit Aug 18, 2016

readme.md

Buffer From

A ponyfill for Buffer.from, uses native implementation if available.

Installation

npm install --save buffer-from

Usage

const bufferFrom = require('buffer-from')

console.log(bufferFrom([1, 2, 3, 4]))
//=> <Buffer 01 02 03 04>

const arr = new Uint8Array([1, 2, 3, 4])
console.log(bufferFrom(arr.buffer, 1, 2))
//=> <Buffer 02 03>

console.log(bufferFrom('test', 'utf8'))
//=> <Buffer 74 65 73 74>

const buf = bufferFrom('test')
console.log(bufferFrom(buf))
//=> <Buffer 74 65 73 74>

API

bufferFrom(array)

  • array <Array>

Allocates a new Buffer using an array of octets.

bufferFrom(arrayBuffer[, byteOffset[, length]])

  • arrayBuffer <ArrayBuffer> The .buffer property of a TypedArray or ArrayBuffer
  • byteOffset <Integer> Where to start copying from arrayBuffer. Default: 0
  • length <Integer> How many bytes to copy from arrayBuffer. Default: arrayBuffer.length - byteOffset

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.

bufferFrom(buffer)

  • buffer <Buffer> An existing Buffer to copy data from

Copies the passed buffer data onto a new Buffer instance.

bufferFrom(string[, encoding])

  • string <String> A string to encode.
  • encoding <String> The encoding of string. Default: 'utf8'

Creates a new Buffer containing the given JavaScript string string. If provided, the encoding parameter identifies the character encoding of string.

See also