|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406 |
- /* eslint-disable node/no-deprecated-api */
-
- 'use strict'
-
- var test = require('tape')
-
- var buffer = require('buffer')
-
- var index = require('./')
- var safer = require('./safer')
- var dangerous = require('./dangerous')
-
- /* Inheritance tests */
-
- test('Default is Safer', function (t) {
- t.equal(index, safer)
- t.notEqual(safer, dangerous)
- t.notEqual(index, dangerous)
- t.end()
- })
-
- test('Is not a function', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(typeof impl, 'object')
- t.equal(typeof impl.Buffer, 'object')
- });
- [buffer].forEach(function (impl) {
- t.equal(typeof impl, 'object')
- t.equal(typeof impl.Buffer, 'function')
- })
- t.end()
- })
-
- test('Constructor throws', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.throws(function () { impl.Buffer() })
- t.throws(function () { impl.Buffer(0) })
- t.throws(function () { impl.Buffer('a') })
- t.throws(function () { impl.Buffer('a', 'utf-8') })
- t.throws(function () { return new impl.Buffer() })
- t.throws(function () { return new impl.Buffer(0) })
- t.throws(function () { return new impl.Buffer('a') })
- t.throws(function () { return new impl.Buffer('a', 'utf-8') })
- })
- t.end()
- })
-
- test('Safe methods exist', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(typeof impl.Buffer.alloc, 'function', 'alloc')
- t.equal(typeof impl.Buffer.from, 'function', 'from')
- })
- t.end()
- })
-
- test('Unsafe methods exist only in Dangerous', function (t) {
- [index, safer].forEach(function (impl) {
- t.equal(typeof impl.Buffer.allocUnsafe, 'undefined')
- t.equal(typeof impl.Buffer.allocUnsafeSlow, 'undefined')
- });
- [dangerous].forEach(function (impl) {
- t.equal(typeof impl.Buffer.allocUnsafe, 'function')
- t.equal(typeof impl.Buffer.allocUnsafeSlow, 'function')
- })
- t.end()
- })
-
- test('Generic methods/properties are defined and equal', function (t) {
- ['poolSize', 'isBuffer', 'concat', 'byteLength'].forEach(function (method) {
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl.Buffer[method], buffer.Buffer[method], method)
- t.notEqual(typeof impl.Buffer[method], 'undefined', method)
- })
- })
- t.end()
- })
-
- test('Built-in buffer static methods/properties are inherited', function (t) {
- Object.keys(buffer).forEach(function (method) {
- if (method === 'SlowBuffer' || method === 'Buffer') return;
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl[method], buffer[method], method)
- t.notEqual(typeof impl[method], 'undefined', method)
- })
- })
- t.end()
- })
-
- test('Built-in Buffer static methods/properties are inherited', function (t) {
- Object.keys(buffer.Buffer).forEach(function (method) {
- if (method === 'allocUnsafe' || method === 'allocUnsafeSlow') return;
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl.Buffer[method], buffer.Buffer[method], method)
- t.notEqual(typeof impl.Buffer[method], 'undefined', method)
- })
- })
- t.end()
- })
-
- test('.prototype property of Buffer is inherited', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl.Buffer.prototype, buffer.Buffer.prototype, 'prototype')
- t.notEqual(typeof impl.Buffer.prototype, 'undefined', 'prototype')
- })
- t.end()
- })
-
- test('All Safer methods are present in Dangerous', function (t) {
- Object.keys(safer).forEach(function (method) {
- if (method === 'Buffer') return;
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl[method], safer[method], method)
- if (method !== 'kStringMaxLength') {
- t.notEqual(typeof impl[method], 'undefined', method)
- }
- })
- })
- Object.keys(safer.Buffer).forEach(function (method) {
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl.Buffer[method], safer.Buffer[method], method)
- t.notEqual(typeof impl.Buffer[method], 'undefined', method)
- })
- })
- t.end()
- })
-
- test('Safe methods from Dangerous methods are present in Safer', function (t) {
- Object.keys(dangerous).forEach(function (method) {
- if (method === 'Buffer') return;
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl[method], dangerous[method], method)
- if (method !== 'kStringMaxLength') {
- t.notEqual(typeof impl[method], 'undefined', method)
- }
- })
- })
- Object.keys(dangerous.Buffer).forEach(function (method) {
- if (method === 'allocUnsafe' || method === 'allocUnsafeSlow') return;
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl.Buffer[method], dangerous.Buffer[method], method)
- t.notEqual(typeof impl.Buffer[method], 'undefined', method)
- })
- })
- t.end()
- })
-
- /* Behaviour tests */
-
- test('Methods return Buffers', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.alloc(0)))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.alloc(0, 10)))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.alloc(0, 'a')))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.alloc(10)))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.alloc(10, 'x')))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.alloc(9, 'ab')))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.from('')))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.from('string')))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.from('string', 'utf-8')))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.from('b25ldHdvdGhyZWU=', 'base64')))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.from([0, 42, 3])))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.from(new Uint8Array([0, 42, 3]))))
- t.ok(buffer.Buffer.isBuffer(impl.Buffer.from([])))
- });
- ['allocUnsafe', 'allocUnsafeSlow'].forEach(function (method) {
- t.ok(buffer.Buffer.isBuffer(dangerous.Buffer[method](0)))
- t.ok(buffer.Buffer.isBuffer(dangerous.Buffer[method](10)))
- })
- t.end()
- })
-
- test('Constructor is buffer.Buffer', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl.Buffer.alloc(0).constructor, buffer.Buffer)
- t.equal(impl.Buffer.alloc(0, 10).constructor, buffer.Buffer)
- t.equal(impl.Buffer.alloc(0, 'a').constructor, buffer.Buffer)
- t.equal(impl.Buffer.alloc(10).constructor, buffer.Buffer)
- t.equal(impl.Buffer.alloc(10, 'x').constructor, buffer.Buffer)
- t.equal(impl.Buffer.alloc(9, 'ab').constructor, buffer.Buffer)
- t.equal(impl.Buffer.from('').constructor, buffer.Buffer)
- t.equal(impl.Buffer.from('string').constructor, buffer.Buffer)
- t.equal(impl.Buffer.from('string', 'utf-8').constructor, buffer.Buffer)
- t.equal(impl.Buffer.from('b25ldHdvdGhyZWU=', 'base64').constructor, buffer.Buffer)
- t.equal(impl.Buffer.from([0, 42, 3]).constructor, buffer.Buffer)
- t.equal(impl.Buffer.from(new Uint8Array([0, 42, 3])).constructor, buffer.Buffer)
- t.equal(impl.Buffer.from([]).constructor, buffer.Buffer)
- });
- [0, 10, 100].forEach(function (arg) {
- t.equal(dangerous.Buffer.allocUnsafe(arg).constructor, buffer.Buffer)
- t.equal(dangerous.Buffer.allocUnsafeSlow(arg).constructor, buffer.SlowBuffer(0).constructor)
- })
- t.end()
- })
-
- test('Invalid calls throw', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.throws(function () { impl.Buffer.from(0) })
- t.throws(function () { impl.Buffer.from(10) })
- t.throws(function () { impl.Buffer.from(10, 'utf-8') })
- t.throws(function () { impl.Buffer.from('string', 'invalid encoding') })
- t.throws(function () { impl.Buffer.from(-10) })
- t.throws(function () { impl.Buffer.from(1e90) })
- t.throws(function () { impl.Buffer.from(Infinity) })
- t.throws(function () { impl.Buffer.from(-Infinity) })
- t.throws(function () { impl.Buffer.from(NaN) })
- t.throws(function () { impl.Buffer.from(null) })
- t.throws(function () { impl.Buffer.from(undefined) })
- t.throws(function () { impl.Buffer.from() })
- t.throws(function () { impl.Buffer.from({}) })
- t.throws(function () { impl.Buffer.alloc('') })
- t.throws(function () { impl.Buffer.alloc('string') })
- t.throws(function () { impl.Buffer.alloc('string', 'utf-8') })
- t.throws(function () { impl.Buffer.alloc('b25ldHdvdGhyZWU=', 'base64') })
- t.throws(function () { impl.Buffer.alloc(-10) })
- t.throws(function () { impl.Buffer.alloc(1e90) })
- t.throws(function () { impl.Buffer.alloc(2 * (1 << 30)) })
- t.throws(function () { impl.Buffer.alloc(Infinity) })
- t.throws(function () { impl.Buffer.alloc(-Infinity) })
- t.throws(function () { impl.Buffer.alloc(null) })
- t.throws(function () { impl.Buffer.alloc(undefined) })
- t.throws(function () { impl.Buffer.alloc() })
- t.throws(function () { impl.Buffer.alloc([]) })
- t.throws(function () { impl.Buffer.alloc([0, 42, 3]) })
- t.throws(function () { impl.Buffer.alloc({}) })
- });
- ['allocUnsafe', 'allocUnsafeSlow'].forEach(function (method) {
- t.throws(function () { dangerous.Buffer[method]('') })
- t.throws(function () { dangerous.Buffer[method]('string') })
- t.throws(function () { dangerous.Buffer[method]('string', 'utf-8') })
- t.throws(function () { dangerous.Buffer[method](2 * (1 << 30)) })
- t.throws(function () { dangerous.Buffer[method](Infinity) })
- if (dangerous.Buffer[method] === buffer.Buffer.allocUnsafe) {
- t.skip('Skipping, older impl of allocUnsafe coerced negative sizes to 0')
- } else {
- t.throws(function () { dangerous.Buffer[method](-10) })
- t.throws(function () { dangerous.Buffer[method](-1e90) })
- t.throws(function () { dangerous.Buffer[method](-Infinity) })
- }
- t.throws(function () { dangerous.Buffer[method](null) })
- t.throws(function () { dangerous.Buffer[method](undefined) })
- t.throws(function () { dangerous.Buffer[method]() })
- t.throws(function () { dangerous.Buffer[method]([]) })
- t.throws(function () { dangerous.Buffer[method]([0, 42, 3]) })
- t.throws(function () { dangerous.Buffer[method]({}) })
- })
- t.end()
- })
-
- test('Buffers have appropriate lengths', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.equal(impl.Buffer.alloc(0).length, 0)
- t.equal(impl.Buffer.alloc(10).length, 10)
- t.equal(impl.Buffer.from('').length, 0)
- t.equal(impl.Buffer.from('string').length, 6)
- t.equal(impl.Buffer.from('string', 'utf-8').length, 6)
- t.equal(impl.Buffer.from('b25ldHdvdGhyZWU=', 'base64').length, 11)
- t.equal(impl.Buffer.from([0, 42, 3]).length, 3)
- t.equal(impl.Buffer.from(new Uint8Array([0, 42, 3])).length, 3)
- t.equal(impl.Buffer.from([]).length, 0)
- });
- ['allocUnsafe', 'allocUnsafeSlow'].forEach(function (method) {
- t.equal(dangerous.Buffer[method](0).length, 0)
- t.equal(dangerous.Buffer[method](10).length, 10)
- })
- t.end()
- })
-
- test('Buffers have appropriate lengths (2)', function (t) {
- t.equal(index.Buffer.alloc, safer.Buffer.alloc)
- t.equal(index.Buffer.alloc, dangerous.Buffer.alloc)
- var ok = true;
- [ safer.Buffer.alloc,
- dangerous.Buffer.allocUnsafe,
- dangerous.Buffer.allocUnsafeSlow
- ].forEach(function (method) {
- for (var i = 0; i < 1e2; i++) {
- var length = Math.round(Math.random() * 1e5)
- var buf = method(length)
- if (!buffer.Buffer.isBuffer(buf)) ok = false
- if (buf.length !== length) ok = false
- }
- })
- t.ok(ok)
- t.end()
- })
-
- test('.alloc(size) is zero-filled and has correct length', function (t) {
- t.equal(index.Buffer.alloc, safer.Buffer.alloc)
- t.equal(index.Buffer.alloc, dangerous.Buffer.alloc)
- var ok = true
- for (var i = 0; i < 1e2; i++) {
- var length = Math.round(Math.random() * 2e6)
- var buf = index.Buffer.alloc(length)
- if (!buffer.Buffer.isBuffer(buf)) ok = false
- if (buf.length !== length) ok = false
- var j
- for (j = 0; j < length; j++) {
- if (buf[j] !== 0) ok = false
- }
- buf.fill(1)
- for (j = 0; j < length; j++) {
- if (buf[j] !== 1) ok = false
- }
- }
- t.ok(ok)
- t.end()
- })
-
- test('.allocUnsafe / .allocUnsafeSlow are fillable and have correct lengths', function (t) {
- ['allocUnsafe', 'allocUnsafeSlow'].forEach(function (method) {
- var ok = true
- for (var i = 0; i < 1e2; i++) {
- var length = Math.round(Math.random() * 2e6)
- var buf = dangerous.Buffer[method](length)
- if (!buffer.Buffer.isBuffer(buf)) ok = false
- if (buf.length !== length) ok = false
- buf.fill(0, 0, length)
- var j
- for (j = 0; j < length; j++) {
- if (buf[j] !== 0) ok = false
- }
- buf.fill(1, 0, length)
- for (j = 0; j < length; j++) {
- if (buf[j] !== 1) ok = false
- }
- }
- t.ok(ok, method)
- })
- t.end()
- })
-
- test('.alloc(size, fill) is `fill`-filled', function (t) {
- t.equal(index.Buffer.alloc, safer.Buffer.alloc)
- t.equal(index.Buffer.alloc, dangerous.Buffer.alloc)
- var ok = true
- for (var i = 0; i < 1e2; i++) {
- var length = Math.round(Math.random() * 2e6)
- var fill = Math.round(Math.random() * 255)
- var buf = index.Buffer.alloc(length, fill)
- if (!buffer.Buffer.isBuffer(buf)) ok = false
- if (buf.length !== length) ok = false
- for (var j = 0; j < length; j++) {
- if (buf[j] !== fill) ok = false
- }
- }
- t.ok(ok)
- t.end()
- })
-
- test('.alloc(size, fill) is `fill`-filled', function (t) {
- t.equal(index.Buffer.alloc, safer.Buffer.alloc)
- t.equal(index.Buffer.alloc, dangerous.Buffer.alloc)
- var ok = true
- for (var i = 0; i < 1e2; i++) {
- var length = Math.round(Math.random() * 2e6)
- var fill = Math.round(Math.random() * 255)
- var buf = index.Buffer.alloc(length, fill)
- if (!buffer.Buffer.isBuffer(buf)) ok = false
- if (buf.length !== length) ok = false
- for (var j = 0; j < length; j++) {
- if (buf[j] !== fill) ok = false
- }
- }
- t.ok(ok)
- t.deepEqual(index.Buffer.alloc(9, 'a'), index.Buffer.alloc(9, 97))
- t.notDeepEqual(index.Buffer.alloc(9, 'a'), index.Buffer.alloc(9, 98))
-
- var tmp = new buffer.Buffer(2)
- tmp.fill('ok')
- if (tmp[1] === tmp[0]) {
- // Outdated Node.js
- t.deepEqual(index.Buffer.alloc(5, 'ok'), index.Buffer.from('ooooo'))
- } else {
- t.deepEqual(index.Buffer.alloc(5, 'ok'), index.Buffer.from('okoko'))
- }
- t.notDeepEqual(index.Buffer.alloc(5, 'ok'), index.Buffer.from('kokok'))
-
- t.end()
- })
-
- test('safer.Buffer.from returns results same as Buffer constructor', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.deepEqual(impl.Buffer.from(''), new buffer.Buffer(''))
- t.deepEqual(impl.Buffer.from('string'), new buffer.Buffer('string'))
- t.deepEqual(impl.Buffer.from('string', 'utf-8'), new buffer.Buffer('string', 'utf-8'))
- t.deepEqual(impl.Buffer.from('b25ldHdvdGhyZWU=', 'base64'), new buffer.Buffer('b25ldHdvdGhyZWU=', 'base64'))
- t.deepEqual(impl.Buffer.from([0, 42, 3]), new buffer.Buffer([0, 42, 3]))
- t.deepEqual(impl.Buffer.from(new Uint8Array([0, 42, 3])), new buffer.Buffer(new Uint8Array([0, 42, 3])))
- t.deepEqual(impl.Buffer.from([]), new buffer.Buffer([]))
- })
- t.end()
- })
-
- test('safer.Buffer.from returns consistent results', function (t) {
- [index, safer, dangerous].forEach(function (impl) {
- t.deepEqual(impl.Buffer.from(''), impl.Buffer.alloc(0))
- t.deepEqual(impl.Buffer.from([]), impl.Buffer.alloc(0))
- t.deepEqual(impl.Buffer.from(new Uint8Array([])), impl.Buffer.alloc(0))
- t.deepEqual(impl.Buffer.from('string', 'utf-8'), impl.Buffer.from('string'))
- t.deepEqual(impl.Buffer.from('string'), impl.Buffer.from([115, 116, 114, 105, 110, 103]))
- t.deepEqual(impl.Buffer.from('string'), impl.Buffer.from(impl.Buffer.from('string')))
- t.deepEqual(impl.Buffer.from('b25ldHdvdGhyZWU=', 'base64'), impl.Buffer.from('onetwothree'))
- t.notDeepEqual(impl.Buffer.from('b25ldHdvdGhyZWU='), impl.Buffer.from('onetwothree'))
- })
- t.end()
- })
|