summaryrefslogtreecommitdiff
path: root/ext/node/polyfills/_fs/_fs_writev.d.ts
diff options
context:
space:
mode:
authorBartek IwaƄczuk <biwanczuk@gmail.com>2023-02-14 17:38:45 +0100
committerGitHub <noreply@github.com>2023-02-14 17:38:45 +0100
commitd47147fb6ad229b1c039aff9d0959b6e281f4df5 (patch)
tree6e9e790f2b9bc71b5f0c9c7e64b95cae31579d58 /ext/node/polyfills/_fs/_fs_writev.d.ts
parent1d00bbe47e2ca14e2d2151518e02b2324461a065 (diff)
feat(ext/node): embed std/node into the snapshot (#17724)
This commit moves "deno_std/node" in "ext/node" crate. The code is transpiled and snapshotted during the build process. During the first pass a minimal amount of work was done to create the snapshot, a lot of code in "ext/node" depends on presence of "Deno" global. This code will be gradually fixed in the follow up PRs to migrate it to import relevant APIs from "internal:" modules. Currently the code from snapshot is not used in any way, and all Node/npm compatibility still uses code from "https://deno.land/std/node" (or from the location specified by "DENO_NODE_COMPAT_URL"). This will also be handled in a follow up PRs. --------- Co-authored-by: crowlkats <crowlkats@toaxl.com> Co-authored-by: Divy Srivastava <dj.srivastava23@gmail.com> Co-authored-by: Yoshiya Hinosawa <stibium121@gmail.com>
Diffstat (limited to 'ext/node/polyfills/_fs/_fs_writev.d.ts')
-rw-r--r--ext/node/polyfills/_fs/_fs_writev.d.ts65
1 files changed, 65 insertions, 0 deletions
diff --git a/ext/node/polyfills/_fs/_fs_writev.d.ts b/ext/node/polyfills/_fs/_fs_writev.d.ts
new file mode 100644
index 000000000..d828bf677
--- /dev/null
+++ b/ext/node/polyfills/_fs/_fs_writev.d.ts
@@ -0,0 +1,65 @@
+// Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
+// Forked from https://github.com/DefinitelyTyped/DefinitelyTyped/blob/d9df51e34526f48bef4e2546a006157b391ad96c/types/node/fs.d.ts
+
+import { ErrnoException } from "internal:deno_node/polyfills/_global.d.ts";
+
+/**
+ * Write an array of `ArrayBufferView`s to the file specified by `fd` using`writev()`.
+ *
+ * `position` is the offset from the beginning of the file where this data
+ * should be written. If `typeof position !== 'number'`, the data will be written
+ * at the current position.
+ *
+ * The callback will be given three arguments: `err`, `bytesWritten`, and`buffers`. `bytesWritten` is how many bytes were written from `buffers`.
+ *
+ * If this method is `util.promisify()` ed, it returns a promise for an`Object` with `bytesWritten` and `buffers` properties.
+ *
+ * It is unsafe to use `fs.writev()` multiple times on the same file without
+ * waiting for the callback. For this scenario, use {@link createWriteStream}.
+ *
+ * On Linux, positional writes don't work when the file is opened in append mode.
+ * The kernel ignores the position argument and always appends the data to
+ * the end of the file.
+ * @since v12.9.0
+ */
+export function writev(
+ fd: number,
+ buffers: ReadonlyArray<ArrayBufferView>,
+ cb: (
+ err: ErrnoException | null,
+ bytesWritten: number,
+ buffers: ArrayBufferView[],
+ ) => void,
+): void;
+export function writev(
+ fd: number,
+ buffers: ReadonlyArray<ArrayBufferView>,
+ position: number | null,
+ cb: (
+ err: ErrnoException | null,
+ bytesWritten: number,
+ buffers: ArrayBufferView[],
+ ) => void,
+): void;
+export interface WriteVResult {
+ bytesWritten: number;
+ buffers: ArrayBufferView[];
+}
+export namespace writev {
+ function __promisify__(
+ fd: number,
+ buffers: ReadonlyArray<ArrayBufferView>,
+ position?: number,
+ ): Promise<WriteVResult>;
+}
+/**
+ * For detailed information, see the documentation of the asynchronous version of
+ * this API: {@link writev}.
+ * @since v12.9.0
+ * @return The number of bytes written.
+ */
+export function writevSync(
+ fd: number,
+ buffers: ReadonlyArray<ArrayBufferView>,
+ position?: number,
+): number;