On this page

An Implementation of the Unix "cat" Program

Concepts Jump to heading

  • Use the Deno runtime API to output the contents of a file to the console.
  • Deno.args accesses the command line arguments.
  • Deno.open is used to get a handle to a file.
  • Deno.stdout.writable is used to get a writable stream to the console standard output.
  • Deno.FsFile.readable is used to get a readable stream from the file. (This readable stream closes the file when it is finished reading, so it is not necessary to close the file explicitly.)
  • Modules can be run directly from remote URLs.

Example Jump to heading

In this program each command-line argument is assumed to be a filename, the file is opened, and printed to stdout (e.g. the console).

/**
 * cat.ts
 */
for (const filename of Deno.args) {
  const file = await Deno.open(filename);
  await file.readable.pipeTo(Deno.stdout.writable, { preventClose: true });
}

To run the program:

deno run --allow-read https://deno.land/std/examples/cat.ts /etc/passwd