1// Copyright Joyent, Inc. and other Node contributors. 2// 3// Permission is hereby granted, free of charge, to any person obtaining a 4// copy of this software and associated documentation files (the 5// "Software"), to deal in the Software without restriction, including 6// without limitation the rights to use, copy, modify, merge, publish, 7// distribute, sublicense, and/or sell copies of the Software, and to permit 8// persons to whom the Software is furnished to do so, subject to the 9// following conditions: 10// 11// The above copyright notice and this permission notice shall be included 12// in all copies or substantial portions of the Software. 13// 14// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 15// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 16// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN 17// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 18// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR 19// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 20// USE OR OTHER DEALINGS IN THE SOFTWARE. 21 22'use strict'; 23const common = require('../common'); 24const fixtures = require('../common/fixtures'); 25const assert = require('assert'); 26const fs = require('fs'); 27const filepath = fixtures.path('x.txt'); 28const fd = fs.openSync(filepath, 'r'); 29 30const expected = Buffer.from('xyz\n'); 31 32function test(bufferAsync, bufferSync, expected) { 33 fs.read(fd, 34 bufferAsync, 35 0, 36 expected.length, 37 0, 38 common.mustSucceed((bytesRead) => { 39 assert.strictEqual(bytesRead, expected.length); 40 assert.deepStrictEqual(bufferAsync, expected); 41 })); 42 43 const r = fs.readSync(fd, bufferSync, 0, expected.length, 0); 44 assert.deepStrictEqual(bufferSync, expected); 45 assert.strictEqual(r, expected.length); 46} 47 48test(Buffer.allocUnsafe(expected.length), 49 Buffer.allocUnsafe(expected.length), 50 expected); 51 52test(new Uint8Array(expected.length), 53 new Uint8Array(expected.length), 54 Uint8Array.from(expected)); 55 56{ 57 // Reading beyond file length (3 in this case) should return no data. 58 // This is a test for a bug where reads > uint32 would return data 59 // from the current position in the file. 60 const pos = 0xffffffff + 1; // max-uint32 + 1 61 const nRead = fs.readSync(fd, Buffer.alloc(1), 0, 1, pos); 62 assert.strictEqual(nRead, 0); 63 64 fs.read(fd, Buffer.alloc(1), 0, 1, pos, common.mustSucceed((nRead) => { 65 assert.strictEqual(nRead, 0); 66 })); 67} 68 69assert.throws(() => new fs.Dir(), { 70 code: 'ERR_MISSING_ARGS', 71}); 72 73assert.throws( 74 () => fs.read(fd, Buffer.alloc(1), 0, 1, 0), 75 { 76 message: 'Callback must be a function. Received undefined', 77 code: 'ERR_INVALID_CALLBACK', 78 } 79); 80 81['buffer', 'offset', 'length'].forEach((option) => 82 assert.throws( 83 () => fs.read(fd, { 84 [option]: null 85 }), 86 `not throws when options.${option} is null` 87 )); 88 89assert.throws( 90 () => fs.read(null, Buffer.alloc(1), 0, 1, 0), 91 { 92 message: 'The "fd" argument must be of type number. Received null', 93 code: 'ERR_INVALID_ARG_TYPE', 94 } 95); 96