mirror of
https://github.com/denoland/deno.git
synced 2024-12-24 08:09:08 -05:00
197 lines
5 KiB
TypeScript
197 lines
5 KiB
TypeScript
// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
|
|
|
|
// TODO(petamoriken): enable prefer-primordials for node polyfills
|
|
// deno-lint-ignore-file prefer-primordials
|
|
|
|
import { Buffer } from "node:buffer";
|
|
import { ERR_INVALID_ARG_TYPE } from "ext:deno_node/internal/errors.ts";
|
|
import * as io from "ext:deno_io/12_io.js";
|
|
import * as fs from "ext:deno_fs/30_fs.js";
|
|
import { ReadOptions } from "ext:deno_node/_fs/_fs_common.ts";
|
|
import {
|
|
validateOffsetLengthRead,
|
|
validatePosition,
|
|
} from "ext:deno_node/internal/fs/utils.mjs";
|
|
import {
|
|
validateBuffer,
|
|
validateInteger,
|
|
} from "ext:deno_node/internal/validators.mjs";
|
|
|
|
type readSyncOptions = {
|
|
offset: number;
|
|
length: number;
|
|
position: number | null;
|
|
};
|
|
|
|
type BinaryCallback = (
|
|
err: Error | null,
|
|
bytesRead: number | null,
|
|
data?: Buffer,
|
|
) => void;
|
|
type Callback = BinaryCallback;
|
|
|
|
export function read(fd: number, callback: Callback): void;
|
|
export function read(
|
|
fd: number,
|
|
options: ReadOptions,
|
|
callback: Callback,
|
|
): void;
|
|
export function read(
|
|
fd: number,
|
|
buffer: Buffer | Uint8Array,
|
|
offset: number,
|
|
length: number,
|
|
position: number | null,
|
|
callback: Callback,
|
|
): void;
|
|
export function read(
|
|
fd: number,
|
|
optOrBufferOrCb?: Buffer | Uint8Array | ReadOptions | Callback,
|
|
offsetOrCallback?: number | Callback,
|
|
length?: number,
|
|
position?: number | null,
|
|
callback?: Callback,
|
|
) {
|
|
let cb: Callback | undefined;
|
|
let offset = 0,
|
|
buffer: Buffer | Uint8Array;
|
|
|
|
if (typeof fd !== "number") {
|
|
throw new ERR_INVALID_ARG_TYPE("fd", "number", fd);
|
|
}
|
|
|
|
if (length == null) {
|
|
length = 0;
|
|
}
|
|
|
|
if (typeof offsetOrCallback === "function") {
|
|
cb = offsetOrCallback;
|
|
} else if (typeof optOrBufferOrCb === "function") {
|
|
cb = optOrBufferOrCb;
|
|
} else {
|
|
offset = offsetOrCallback as number;
|
|
validateInteger(offset, "offset", 0);
|
|
cb = callback;
|
|
}
|
|
|
|
if (
|
|
optOrBufferOrCb instanceof Buffer || optOrBufferOrCb instanceof Uint8Array
|
|
) {
|
|
buffer = optOrBufferOrCb;
|
|
} else if (typeof optOrBufferOrCb === "function") {
|
|
offset = 0;
|
|
buffer = Buffer.alloc(16384);
|
|
length = buffer.byteLength;
|
|
position = null;
|
|
} else {
|
|
const opt = optOrBufferOrCb as ReadOptions;
|
|
if (
|
|
!(opt.buffer instanceof Buffer) && !(opt.buffer instanceof Uint8Array)
|
|
) {
|
|
if (opt.buffer === null) {
|
|
// @ts-ignore: Intentionally create TypeError for passing test-fs-read.js#L87
|
|
length = opt.buffer.byteLength;
|
|
}
|
|
throw new ERR_INVALID_ARG_TYPE("buffer", [
|
|
"Buffer",
|
|
"TypedArray",
|
|
"DataView",
|
|
], optOrBufferOrCb);
|
|
}
|
|
offset = opt.offset ?? 0;
|
|
buffer = opt.buffer ?? Buffer.alloc(16384);
|
|
length = opt.length ?? buffer.byteLength;
|
|
position = opt.position ?? null;
|
|
}
|
|
|
|
if (position == null) {
|
|
position = -1;
|
|
}
|
|
|
|
validatePosition(position);
|
|
validateOffsetLengthRead(offset, length, buffer.byteLength);
|
|
|
|
if (!cb) throw new ERR_INVALID_ARG_TYPE("cb", "Callback", cb);
|
|
|
|
(async () => {
|
|
try {
|
|
let nread: number | null;
|
|
if (typeof position === "number" && position >= 0) {
|
|
const currentPosition = await fs.seek(fd, 0, io.SeekMode.Current);
|
|
// We use sync calls below to avoid being affected by others during
|
|
// these calls.
|
|
fs.seekSync(fd, position, io.SeekMode.Start);
|
|
nread = io.readSync(fd, buffer);
|
|
fs.seekSync(fd, currentPosition, io.SeekMode.Start);
|
|
} else {
|
|
nread = await io.read(fd, buffer);
|
|
}
|
|
cb(null, nread ?? 0, Buffer.from(buffer.buffer, offset, length));
|
|
} catch (error) {
|
|
cb(error as Error, null);
|
|
}
|
|
})();
|
|
}
|
|
|
|
export function readSync(
|
|
fd: number,
|
|
buffer: Buffer | Uint8Array,
|
|
offset: number,
|
|
length: number,
|
|
position: number | null,
|
|
): number;
|
|
export function readSync(
|
|
fd: number,
|
|
buffer: Buffer | Uint8Array,
|
|
opt: readSyncOptions,
|
|
): number;
|
|
export function readSync(
|
|
fd: number,
|
|
buffer: Buffer | Uint8Array,
|
|
offsetOrOpt?: number | readSyncOptions,
|
|
length?: number,
|
|
position?: number | null,
|
|
): number {
|
|
let offset = 0;
|
|
|
|
if (typeof fd !== "number") {
|
|
throw new ERR_INVALID_ARG_TYPE("fd", "number", fd);
|
|
}
|
|
|
|
validateBuffer(buffer);
|
|
|
|
if (length == null) {
|
|
length = 0;
|
|
}
|
|
|
|
if (typeof offsetOrOpt === "number") {
|
|
offset = offsetOrOpt;
|
|
validateInteger(offset, "offset", 0);
|
|
} else if (offsetOrOpt !== undefined) {
|
|
const opt = offsetOrOpt as readSyncOptions;
|
|
offset = opt.offset ?? 0;
|
|
length = opt.length ?? buffer.byteLength;
|
|
position = opt.position ?? null;
|
|
}
|
|
|
|
if (position == null) {
|
|
position = -1;
|
|
}
|
|
|
|
validatePosition(position);
|
|
validateOffsetLengthRead(offset, length, buffer.byteLength);
|
|
|
|
let currentPosition = 0;
|
|
if (typeof position === "number" && position >= 0) {
|
|
currentPosition = fs.seekSync(fd, 0, io.SeekMode.Current);
|
|
fs.seekSync(fd, position, io.SeekMode.Start);
|
|
}
|
|
|
|
const numberOfBytesRead = io.readSync(fd, buffer);
|
|
|
|
if (typeof position === "number" && position >= 0) {
|
|
fs.seekSync(fd, currentPosition, io.SeekMode.Start);
|
|
}
|
|
|
|
return numberOfBytesRead ?? 0;
|
|
}
|