Name | Version | Size | License | Type | Vulnerabilities |
---|---|---|---|---|---|
safe-buffer | 5.1.2 | 9.59 kB | MIT | prod |
Safe-buffer is a safer Node.js Buffer API. It employs the new Node.js Buffer APIs, including Buffer.from
, Buffer.alloc
, Buffer.allocUnsafe
, and Buffer.allocUnsafeSlow
, in all versions of Node.js. The package's main function is to provide a safe replacement for the node.js Buffer. It uses the built-in implementation when available. This lends to the mitigation of certain security issues related to uninitialized memory disclosure associated with the Buffer
constructor in Node.js.
You can use safe-buffer as a drop-in replacement for the default Buffer in Node.js. This can be done by simply requiring 'safe-buffer'. All current code should continue functioning without issues. Here's a brief code usage example:
var Buffer = require('safe-buffer').Buffer;
// Existing buffer code will continue to work without issues:
new Buffer('hey', 'utf8');
new Buffer([1, 2, 3], 'utf8');
new Buffer(obj);
new Buffer(16); // create an uninitialized buffer (potentially unsafe)
// But you can use these new explicit APIs to make clear what you want:
Buffer.from('hey', 'utf8'); // convert from many types to a Buffer
Buffer.alloc(16); // create a zero-filled buffer (safe)
Buffer.allocUnsafe(16); // create an uninitialized buffer (potentially unsafe)
This package should be installed using npm install safe-buffer
.
For comprehensive information on safe-buffer, it's recommended to refer to the official Node.js Buffer API documentation which can be found at this link. Additionally, the original package repository on GitHub contains further usage examples and information, and can be accessed at git://github.com/feross/safe-buffer.git
.